[ { "path": ".Rbuildignore", "content": "^CRAN-RELEASE$\n^node_modules$\n^js-tests$\n^srcjs$\n^pkgdown$\n^assets$\n^.*\\.Rproj$\n^CONDUCT\\.md$\n^README\\.Rmd$\n^\\.Rproj\\.user$\n^buildupdate$\n^docs$\n^cran-comments\\.md$\n^logo.svg$\n^package\\.json$\n^vite\\.config\\.js$\n^package-lock\\.json$\n^logo\\.svg$\n^\\.github$\n^CRAN-SUBMISSION$\n" }, { "path": ".gitattributes", "content": "/inst/www/react-tools/react-tools.js binary\n/inst/www/react-tools/react-tools.js.map binary\n" }, { "path": ".github/.gitignore", "content": "*.html\n" }, { "path": ".github/workflows/R-CMD-check.yaml", "content": "# Workflow derived from https://github.com/r-lib/actions/tree/v2/examples\n# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help\non:\n push:\n branches: [main, master]\n pull_request:\n branches: [main, master]\n\nname: R-CMD-check\n\njobs:\n R-CMD-check:\n runs-on: ${{ matrix.config.os }}\n\n name: ${{ matrix.config.os }} (${{ matrix.config.r }})\n\n strategy:\n fail-fast: false\n matrix:\n config:\n - {os: macos-latest, r: 'release'}\n - {os: windows-latest, r: 'release'}\n - {os: ubuntu-latest, r: 'devel', http-user-agent: 'release'}\n - {os: ubuntu-latest, r: 'release'}\n - {os: ubuntu-latest, r: 'oldrel-1'}\n\n env:\n GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}\n R_KEEP_PKG_SOURCE: yes\n\n steps:\n - uses: actions/checkout@v3\n\n - uses: r-lib/actions/setup-pandoc@v2\n\n - uses: r-lib/actions/setup-r@v2\n with:\n r-version: ${{ matrix.config.r }}\n http-user-agent: ${{ matrix.config.http-user-agent }}\n use-public-rspm: true\n\n - uses: r-lib/actions/setup-r-dependencies@v2\n with:\n extra-packages: any::rcmdcheck\n needs: check\n\n - uses: r-lib/actions/check-r-package@v2\n with:\n upload-snapshots: true\n" }, { "path": ".gitignore", "content": "Meta\ndoc\n.Rproj.user\n.Rhistory\n.RData\n.Ruserdata\ninst/doc\nnode_modules\nreactR.Rcheck\nreactR_*.tar.gz\n*.swp\n.DS_Store\n" }, { "path": "CONDUCT.md", "content": "# Contributor Code of Conduct\n\nAs contributors and maintainers of this project, we pledge to respect all people who \ncontribute through reporting issues, posting feature requests, updating documentation,\nsubmitting pull requests or patches, and other activities.\n\nWe are committed to making participation in this project a harassment-free experience for\neveryone, regardless of level of experience, gender, gender identity and expression,\nsexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.\n\nExamples of unacceptable behavior by participants include the use of sexual language or\nimagery, derogatory comments or personal attacks, trolling, public or private harassment,\ninsults, or other unprofessional conduct.\n\nProject maintainers have the right and responsibility to remove, edit, or reject comments,\ncommits, code, wiki edits, issues, and other contributions that are not aligned to this \nCode of Conduct. Project maintainers who do not follow the Code of Conduct may be removed \nfrom the project team.\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be reported by \nopening an issue or contacting one or more of the project maintainers.\n\nThis Code of Conduct is adapted from the Contributor Covenant \n(http:contributor-covenant.org), version 1.0.0, available at \nhttp://contributor-covenant.org/version/1/0/0/\n" }, { "path": "DESCRIPTION", "content": "Package: reactR\nType: Package\nTitle: React Helpers\nVersion: 0.6.1\nDate: 2024-09-14\nAuthors@R: c(\n person(\n \"Facebook\", \"Inc\"\n , role = c(\"aut\", \"cph\")\n , comment = \"React library in lib, https://reactjs.org/; see AUTHORS for full list of contributors\"\n ),\n person(\n \"Michel\",\"Weststrate\",\n , role = c(\"aut\", \"cph\")\n , comment = \"mobx library in lib, https://github.com/mobxjs\"\n ),\n person(\n \"Kent\", \"Russell\"\n , role = c(\"aut\", \"cre\")\n , comment = \"R interface\"\n , email = \"kent.russell@timelyportfolio.com\"\n ),\n person(\n \"Alan\", \"Dipert\"\n , role = c(\"aut\")\n , comment = \"R interface\"\n , email = \"alan@rstudio.com\"\n ),\n person(\n \"Greg\", \"Lin\"\n , role = c(\"aut\")\n , comment = \"R interface\"\n , email = \"glin@glin.io\"\n )\n )\nMaintainer: Kent Russell \nDescription: Make it easy to use 'React' in R with 'htmlwidget' scaffolds,\n helper dependency functions, an embedded 'Babel' 'transpiler',\n and examples.\nURL: https://github.com/react-R/reactR\nBugReports: https://github.com/react-R/reactR/issues\nLicense: MIT + file LICENSE\nLazyData: TRUE\nEncoding: UTF-8\nImports:\n htmltools\nSuggests:\n htmlwidgets (>= 1.5.3),\n rmarkdown,\n shiny,\n V8,\n knitr,\n usethis,\n jsonlite\nRoxygenNote: 7.3.2\nVignetteBuilder: knitr\n" }, { "path": "LICENSE", "content": "YEAR: 2018\nCOPYRIGHT HOLDER: Kent Russell\n" }, { "path": "NAMESPACE", "content": "# Generated by roxygen2: do not edit by hand\n\nS3method(\"$\",react_component_builder)\nS3method(\"$<-\",react_component_builder)\nS3method(\"[[\",react_component_builder)\nS3method(\"[[<-\",react_component_builder)\nexport(React)\nexport(babel_transform)\nexport(component)\nexport(createReactShinyInput)\nexport(html_dependency_corejs)\nexport(html_dependency_mobx)\nexport(html_dependency_react)\nexport(html_dependency_reacttools)\nexport(reactMarkup)\nexport(scaffoldReactShinyInput)\nexport(scaffoldReactWidget)\nimportFrom(htmltools,htmlDependency)\n" }, { "path": "NEWS.md", "content": "# reactR 0.6.1\n\n* Fix issue where the `react-tools.umd.cjs` script could be blocked by the browser in some cases, such as apps deployed on shinyapps.io [#86](https://github.com/react-R/reactR/issues/86)\n\n# reactR 0.6.0\n\n* retain `list` in `reactR::component` classes [#82](https://github.com/react-R/reactR/issues/82)\n* hydrate props/attribs that are tags assuming tag-like props/attribs should be slots[#67](https://github.com/react-R/reactR/issues/67) [#61](https://github.com/react-R/reactR/issues/61)\n* update build tools to `vite` from `webpack`\n* update js testing library from `karma` to `vitest`\n\n\n# reactR 0.5.0\n\n* Update react to `18.2.0`\n\n# reactR 0.4.4\n\n* Update react to `16.12.0`\n\n* Add `style-loader` and `css-loader` to webpack config [pull 50](https://github.com/react-R/reactR/pull/50)\n\n* Update to `PACKAGE::widget_html.WIDGETNAME` for new `htmlwidgets` convention [pull 49](https://github.com/react-R/reactR/pull/49)\n\n* Clean up template [pull 45](https://github.com/react-R/reactR/pull/45)\n\n# reactR 0.4.3\n\n* Add element to Shiny input [pull 41](https://github.com/react-R/reactR/pull/41)\n\n* Upgrade npm dependencies\n\n# reactR 0.4.2\n\n* Update react to `16.12.0`\n\n* Update core-js to `2.6.11`\n\n# reactR 0.4.1\n\n* Add support for `shiny::registerInputHandler` in Shiny inputs; [pull 28](https://github.com/react-R/reactR/pull/28)\n\n* Add support for Shiny rate limit [pull 29](https://github.com/react-R/reactR/pull/29)\n\n* Update react to `16.8.6`\n\n* Add `mobx` dependencies available through `html_dependency_mobx()`\n\n# reactR 0.4.0\n\n* Add Shiny input scaffold and functionality; [tutorial](https://react-r.github.io/reactR/articles/intro_inputs.html) and [pull 22](https://github.com/react-R/reactR/pull/22) thanks @alandipert\n\n# reactR 0.3.1\n\n* Update react and react-dom to 16.8.1\n* Add `usethis` R dependency\n* Ignore node_modules in `.Rbuildignore` and `.gitignore`\n* Set `{modules:false}` in `babel_transform` to avoid `\"use strict\"`; [pull 15](https://github.com/react-R/reactR/pull/15)\n* Use webpack to build `react-tools.js`; [pull 16](https://github.com/react-R/reactR/pull/16)\n* Attach component to the htmlwidget\n\n# reactR 0.3.0\n\n* Add htmlwidget scaffold and helpers (see [tutorial](https://react-r.github.io/reactR/articles/intro_htmlwidgets.html))\n* Update react and react-dom to 16.6.7\n\n# reactR 0.2.1\n\n* Update react and react-dom to 16.6.0\n\n# reactR 0.2.0\n\n* Update react and react-dom to 16.2.0\n* Add core-js shim so that React will show up in RStudio Viewer\n\n# reactR 0.1.4\n\n* Update react and react-dom to 16.1.1\n\n# reactR 0.1.3\n\n* Update react and react-dom to 16.0.0\n* Update babel to 6.26.0\n\n# reactR 0.1.2\n\n* Update to react `15.5.0`\n* Update to babel `6.24.0`\n* Add fluent-ui(fabric) example\n* Build doc site with `pkgdown`\n\n# reactR 0.1.1\n\n* Added a `NEWS.md` file to track changes to the package.\n* Provide offline babel-standalone for babel_transform\n\n# reactR 0.1.0\n\n* Initial release\n\n\n\n" }, { "path": "R/babel.R", "content": "#' Transform Code with Babel\n#'\n#' Helper function to use \\code{V8} with \\code{Babel} so we can\n#' avoid a JSX transformer with using \\code{reactR}.\n#'\n#' @param code \\code{character}\n#'\n#' @return transformed \\code{character}\n#' @export\n#'\n#' @examples\n#' \\dontrun{\n#' library(reactR)\n#' babel_transform('
react div
')\n#' }\nbabel_transform <- function(code=\"\"){\n stopifnot(requireNamespace(\"V8\"), is.character(code))\n\n ctx <- V8::v8()\n ctx$source(\n system.file(\n \"www/babel/babel.min.js\",\n package = \"reactR\"\n )\n )\n ctx$assign('code', code)\n ctx$get('Babel.transform(code,{ presets: [[\"es2015\", {modules: false}],\"react\"] }).code')\n}\n" }, { "path": "R/dependencies.R", "content": "#' Dependencies for React\n#'\n#' Add JavaScript 'React' dependency. For this to work in RStudio Viewer, also include\n#' \\code{\\link{html_dependency_corejs}}.\n#'\n#' @param offline \\code{logical} to use local file dependencies. If \\code{FALSE},\n#' then the dependencies use the Facebook cdn as its \\code{src}.\n#' To use with \\code{JSX} see \\code{\\link{babel_transform}}.\n#'\n#' @return \\code{\\link[htmltools]{htmlDependency}}\n#' @importFrom htmltools htmlDependency\n#' @export\n#'\n#' @examples\n#' library(reactR)\n#' library(htmltools)\n#'\n#' tagList(\n#' tags$script(\n#' \"\n#' ReactDOM.render(\n#' React.createElement(\n#' 'h1',\n#' null,\n#' 'Powered by React'\n#' ),\n#' document.body\n#' )\n#' \"\n#' ),\n#' #add core-js first to work in RStudio Viewer\n#' html_dependency_corejs(),\n#' html_dependency_react() #offline=FALSE for CDN\n#' )\nhtml_dependency_react <- function(offline=TRUE){\n hd <- htmltools::htmlDependency(\n name = \"react\",\n version = react_version(),\n src = system.file(\"www/react\",package=\"reactR\"),\n script = c(\"react.min.js\", \"react-dom.min.js\")\n )\n\n if(!offline) {\n hd$src <- list(href=\"//unpkg.com\")\n\n hd$script <- c(\n \"react/umd/react.production.min.js\",\n \"react-dom/umd/react-dom.production.min.js\"\n )\n }\n\n hd\n}\n\n\n#' Shim Dependency for React in RStudio Viewer\n#'\n#' Add this first for 'React' to work in RStudio Viewer.\n#'\n#' @return \\code{\\link[htmltools]{htmlDependency}}\n#' @importFrom htmltools htmlDependency\n#' @export\nhtml_dependency_corejs <- function() {\n #shim/polyfill for ES5 and ES6 so react will show up in RStudio Viewer\n #https://unpkg.com/core-js@2.5.3/\n htmltools::htmlDependency(\n name = \"core-js\",\n version = \"2.5.3\",\n src = c(file=system.file(\"www/core-js/\", package=\"reactR\")),\n script = \"shim.min.js\"\n )\n}\n\n#' Adds window.reactR.exposeComponents and window.reactR.hydrate\n#'\n#' @return \\code{\\link[htmltools]{htmlDependency}}\n#' @importFrom htmltools htmlDependency\n#' @export\nhtml_dependency_reacttools <- function(){\n htmltools::htmlDependency(\n name = \"reactwidget\",\n src = \"www/react-tools\",\n version = \"2.0.0\",\n package = \"reactR\",\n script = c(\"react-tools.js\")\n )\n}\n\n#' Dependencies for 'mobx'\n#'\n#' Add JavaScript 'mobx' and 'mobx-react' dependency. When using with 'react', the order\n#' of the dependencies is important, so please add \\code{html_dependency_react()} before\n#' \\code{html_dependency_mobx()}.\n#'\n#' @param react \\code{logical} to add react 'mobx' dependencies.\n#'\n#' @return \\code{\\link[htmltools]{htmlDependency}}\n#' @importFrom htmltools htmlDependency\n#' @export\n#'\n#' @examples\n#' if(interactive()) {\n#'\n#' library(htmltools)\n#' library(reactR)\n#'\n#' browsable(\n#' tagList(\n#' html_dependency_mobx(react = FALSE),\n#' div(id=\"test\"),\n#' tags$script(HTML(\n#' \"\n#' var obs = mobx.observable({val: null})\n#' mobx.autorun(function() {\n#' document.querySelector('#test').innerText = obs.val\n#' })\n#' setInterval(\n#' function() {obs.val++},\n#' 1000\n#' )\n#' \"\n#' ))\n#' )\n#' )\n#' }\n#'\n#' \\dontrun{\n#' # use with react\n#' library(htmltools)\n#' library(reactR)\n#'\n#' browsable(\n#' tagList(\n#' html_dependency_react(),\n#' html_dependency_mobx(),\n#' div(id=\"test\"),\n#' tags$script(HTML(babel_transform(\n#' \"\n#' var obs = mobx.observable({val: null})\n#' var App = mobxReact.observer((props) =>
{props.obs.val}
)\n#'\n#' ReactDOM.render(, document.querySelector('#test'))\n#'\n#' setInterval(\n#' function() {obs.val++},\n#' 1000\n#' )\n#' \"\n#' )))\n#' )\n#' )\n#' }\n\nhtml_dependency_mobx <- function(react = TRUE){\n hd <- htmltools::htmlDependency(\n name = \"mobx\",\n version = \"4.11.0\",\n src = system.file(\"www/mobx\",package=\"reactR\"),\n script = c(\"mobx.umd.min.js\")\n )\n\n if(react) {\n hd$script <- c(hd$script,\"mobx-react-lite.js\", \"mobx-react.umd.js\")\n }\n\n hd\n}\n" }, { "path": "R/meta.R", "content": "#'@keywords internal\nreact_version <- function(){'18.2.0'}\nbabel_version <- function(){'6.26.0'}" }, { "path": "R/reacttools.R", "content": "# A robust name string is a valid\n# - CSS class\n# - JavaScript variable name\n# - R variable name\nrobustName <- \"^[[:alpha:]_][[:alnum:]_]*$\"\n\nisUpper <- function(s) {\n grepl(\"^[[:upper:]]+$\", s)\n}\n\n#' Create a React component\n#'\n#' @param name Name of the React component, which must start with an upper-case\n#' character.\n#' @param varArgs Attributes and children of the element to pass along to\n#' \\code{\\link[htmltools]{tag}} as \\code{varArgs}.\n#'\n#' @return An htmltools \\code{\\link[htmltools]{tag}} object\n#' @export\n#'\n#' @examples\n#' component(\"ParentComponent\",\n#' list(\n#' x = 1,\n#' y = 2,\n#' component(\"ChildComponent\"),\n#' component(\"OtherChildComponent\")\n#' )\n#' )\ncomponent <- function(name, varArgs = list()) {\n if (length(name) == 0 || !isUpper(substring(name, 1, 1))) {\n stop(\"Component name must be specified and start with an upper case character\")\n }\n component <- htmltools::tag(name, varArgs)\n structure(component, class = c(\"reactR_component\", oldClass(component), \"list\"))\n}\n\n#' React component builder.\n#'\n#' \\code{React} is a syntactically-convenient way to create instances of React\n#' components that can be sent to the browser for display. It is a list for\n#' which \\link[=InternalMethods]{extract methods} are defined, allowing\n#' object creation syntax like \\code{React$MyComponent(x = 1)} where\n#' \\code{MyComponent} is a React component you have exposed to Shiny in\n#' JavaScript.\n#'\n#' Internally, the \\code{\\link{component}} function is used to create the\n#' component instance.\n#'\n#' @examples\n#' # Create an instance of ParentComponent with two children,\n#' # ChildComponent and OtherChildComponent.\n#' React$ParentComponent(\n#' x = 1,\n#' y = 2,\n#' React$ChildComponent(),\n#' React$OtherChildComponent()\n#' )\n#' @export\nReact <- structure(\n list(),\n class = \"react_component_builder\"\n)\n\n#' @export\n`$.react_component_builder` <- function(x, name) {\n function(...) {\n component(name, list(...))\n }\n}\n\n#' @export\n`[[.react_component_builder` <- `$.react_component_builder`\n\n#' @export\n`$<-.react_component_builder` <- function(x, name, value) {\n stop(\"Assigning to a component constructor is not allowed\")\n}\n\n#' @export\n`[[<-.react_component_builder` <- `$<-.react_component_builder`\n\n#' Prepare data that represents a single-element character vector, a React\n#' component, or an htmltools tag for sending to the client.\n#'\n#' Tag lists as returned by \\code{htmltools tagList} are not currently\n#' supported.\n#'\n#' @param tag character vector or React component or\n#' \\code{\\link[htmltools]{tag}}\n#'\n#' @return A reactR markup object suitable for being passed to\n#' \\code{\\link[htmlwidgets]{createWidget}} as widget instance data.\n#' @export\nreactMarkup <- function(tag) {\n stopifnot(inherits(tag, \"shiny.tag\")\n || (is.character(tag) && length(tag) == 1))\n list(tag = tag, class = \"reactR_markup\")\n}\n\n#' Create a React-based input\n#'\n#' @param inputId The \\code{input} slot that will be used to access the value.\n#' @param class Space-delimited list of CSS class names that should identify\n#' this input type in the browser.\n#' @param dependencies HTML dependencies to include in addition to those\n#' supporting React. Must contain at least one dependency, that of the input's\n#' implementation.\n#' @param default Initial value.\n#' @param configuration Static configuration data.\n#' @param container Function to generate an HTML element to contain the input.\n#'\n#' @return Shiny input suitable for inclusion in a UI.\n#' @export\n#'\n#' @examples\n#' myInput <- function(inputId, default = \"\") {\n#' # The value of createReactShinyInput should be returned from input constructor functions.\n#' createReactShinyInput(\n#' inputId,\n#' \"myinput\",\n#' # At least one htmlDependency must be provided -- the JavaScript implementation of the input.\n#' htmlDependency(\n#' name = \"my-input\",\n#' version = \"1.0.0\",\n#' src = \"www/mypackage/myinput\",\n#' package = \"mypackage\",\n#' script = \"myinput.js\"\n#' ),\n#' default\n#' )\n#' }\ncreateReactShinyInput <- function(inputId,\n class,\n dependencies,\n default = NULL,\n configuration = list(),\n container = htmltools::tags$div) {\n if(length(dependencies) < 1) stop(\"Must include at least one HTML dependency.\")\n value <- shiny::restoreInput(id = inputId, default = default)\n htmltools::tagList(\n html_dependency_corejs(),\n html_dependency_react(),\n html_dependency_reacttools(),\n container(id = inputId, class = class),\n htmltools::tags$script(id = sprintf(\"%s_value\", inputId),\n type = \"application/json\",\n jsonlite::toJSON(value, auto_unbox = TRUE, null = \"null\", force = TRUE)),\n htmltools::tags$script(id = sprintf(\"%s_configuration\", inputId),\n type = \"application/json\",\n jsonlite::toJSON(configuration, auto_unbox = TRUE, null = \"null\", force = TRUE)),\n dependencies\n )\n}\n" }, { "path": "R/scaffold_input.R", "content": "#' Create implementation scaffolding for a React.js-based Shiny input.\n#'\n#' Add the minimal code required to implement a React.js-based Shiny input to an\n#' R package.\n#'\n#' @param name Name of input\n#' @param npmPkgs Optional \\href{https://www.npmjs.com/}{NPM} packages upon which\n#' this input is based which will be used to populate \\code{package.json}.\n#' Should be a named list of names to\n#' \\href{https://docs.npmjs.com/files/package.json/}{versions}.\n#' @param edit Automatically open the input's source files after creating the\n#' scaffolding.\n#'\n#' @note This function must be executed from the root directory of the package\n#' you wish to add the input to.\n#'\n#' @export\nscaffoldReactShinyInput <- function(name, npmPkgs = NULL, edit = interactive()) {\n assertNameValid(name)\n package <- getPackage()\n\n file <- renderFile(\n sprintf(\"R/%s.R\", name),\n \"templates/input_r.txt\",\n \"boilerplate for input constructor\",\n list(\n name = name,\n capName = capitalize(name),\n package = package\n )\n )\n if (edit) fileEdit(file)\n\n renderFile(\n 'package.json',\n 'templates/package.json.txt',\n 'project metadata',\n list(npmPkgs = toDepJSON(npmPkgs))\n )\n\n renderFile(\n 'webpack.config.js',\n 'templates/webpack.config.js.txt',\n 'webpack configuration',\n list(\n name = name,\n outputPath = sprintf(\"inst/www/%s/%s\", package, name)\n )\n )\n\n renderFile(\n sprintf('srcjs/%s.jsx', name),\n 'templates/input_js.txt',\n 'JavaScript implementation',\n list(\n name = name,\n package = package\n )\n )\n\n renderFile(\n 'app.R',\n 'templates/input_app.R.txt',\n 'example app',\n list(\n name = name,\n package = package\n )\n )\n\n usethis::use_build_ignore(c(\"node_modules\", \"srcjs\", \"app.R\", \"package.json\", \"webpack.config.js\", \"yarn.lock\"))\n usethis::use_git_ignore(c(\"node_modules\"))\n lapply(c(\"htmltools\", \"shiny\", \"reactR\"), usethis::use_package)\n\n message(\"To install dependencies from npm run: yarn install\")\n message(\"To build JavaScript run: yarn run webpack --mode=development\")\n}\n\n" }, { "path": "R/scaffold_utils.R", "content": "slurp <- function(file) {\n paste(readLines(\n system.file(file, package = 'reactR')\n ), collapse = \"\\n\")\n}\n\n# invoke file.edit in a way that will bind to the RStudio editor\n# when running inside RStudio\nfileEdit <- function(file) {\n fileEditFunc <- eval(parse(text = \"file.edit\"), envir = globalenv())\n fileEditFunc(file)\n}\n\n# Perform a series of pattern replacements on str.\n# Example: renderTemplate(\"foo ${x} bar ${y} baz ${x}\", list(x = 1, y = 2))\n# Produces: \"foo 1 bar 2 baz 1\"\nrenderTemplate <- function(str, substitutions) {\n Reduce(function(str, name) {\n gsub(paste0(\"\\\\$\\\\{\", name, \"\\\\}\"), substitutions[[name]], str)\n }, names(substitutions), str)\n}\n\ncapitalize <- function(s) {\n gsub(\"^(.)\", perl = TRUE, replacement = '\\\\U\\\\1', s)\n}\n\ntoDepJSON <- function(npmPkgs) {\n if (is.null(npmPkgs)) {\n \"\"\n } else if (!length(names(npmPkgs))) {\n stop(\"Must specify npm package names in the names attributes of npmPkgs\")\n } else {\n paste0(sprintf('\"%s\": \"%s\"', names(npmPkgs), npmPkgs), collapse = \",\\n\")\n }\n}\n\n# Wraps renderTemplate for convenient use from scaffold functions.\nrenderFile <- function(outputFile, templateFile, description = '', substitutions = list()) {\n if (!file.exists(outputFile)) {\n dir.create(dirname(outputFile), recursive = TRUE, showWarnings = FALSE)\n cat(renderTemplate(slurp(templateFile), substitutions), file = outputFile)\n message(\"Created \", description, \" \", outputFile)\n } else {\n message(outputFile, \" already exists\")\n }\n outputFile\n}\n\ngetPackage <- function() {\n if (!file.exists('DESCRIPTION')) {\n stop(\"The current directory doesn't contain a package. You're either in the wrong directory, or need to create a package to house your widget.\", call. = FALSE)\n }\n read.dcf('DESCRIPTION')[[1,\"Package\"]]\n}\n\n# Constraining names prevents the user from encountering obscure CSS problems\n# and JavaScript errors after scaffolding.\nassertNameValid <- function(name) {\n if (!grepl(robustName, name)) {\n msg <- sprintf(\"Name '%s' is invalid, names must begin with an alphabetic character and must contain only alphabetic and numeric characters\", name)\n stop(msg, call. = FALSE)\n }\n}\n" }, { "path": "R/scaffold_widget.R", "content": "#' Create implementation scaffolding for a React.js-based HTML widget\n#'\n#' Add the minimal code required to implement a React.js-based HTML widget to an\n#' R package.\n#'\n#' @param name Name of widget\n#' @param npmPkgs Optional \\href{https://www.npmjs.com/}{NPM} packages upon which\n#' this widget is based which will be used to populate \\code{package.json}.\n#' Should be a named list of names to\n#' \\href{https://docs.npmjs.com/files/package.json/}{versions}.\n#' @param edit Automatically open the widget's JavaScript source file after\n#' creating the scaffolding.\n#'\n#' @note This function must be executed from the root directory of the package\n#' you wish to add the widget to.\n#'\n#' @export\nscaffoldReactWidget <- function(name, npmPkgs = NULL, edit = interactive()){\n assertNameValid(name)\n package <- getPackage()\n\n addWidgetConstructor(name, package, edit)\n addWidgetYAML(name, edit)\n addPackageJSON(toDepJSON(npmPkgs))\n addWebpackConfig(name)\n addWidgetJS(name, edit)\n addExampleApp(name)\n\n usethis::use_build_ignore(c(\"node_modules\", \"srcjs\", \"app.R\", \"package.json\", \"webpack.config.js\", \"yarn.lock\"))\n usethis::use_git_ignore(c(\"node_modules\"))\n lapply(c(\"htmltools\", \"htmlwidgets\", \"reactR\"), usethis::use_package)\n\n message(\"To install dependencies from npm run: yarn install\")\n message(\"To build JavaScript run: yarn run webpack --mode=development\")\n}\n\naddWidgetConstructor <- function(name, package, edit){\n file <- renderFile(\n sprintf(\"R/%s.R\", name),\n \"templates/widget_r.txt\",\n \"boilerplate for widget constructor\",\n list(\n name = name,\n package = package,\n capName = capitalize(name)\n )\n )\n if (edit) fileEdit(file)\n}\n\naddWidgetYAML <- function(name, edit){\n file <- renderFile(\n sprintf('inst/htmlwidgets/%s.yaml', name),\n \"templates/widget_yaml.txt\",\n \"boilerplate for widget dependencies\"\n )\n if (edit) fileEdit(file)\n}\n\naddPackageJSON <- function(npmPkgs) {\n renderFile(\n 'package.json',\n 'templates/package.json.txt',\n 'project metadata',\n list(npmPkgs = npmPkgs)\n )\n}\n\naddWebpackConfig <- function(name) {\n renderFile(\n 'webpack.config.js',\n 'templates/webpack.config.js.txt',\n 'webpack configuration',\n list(\n name = name,\n outputPath = 'inst/htmlwidgets'\n )\n )\n}\n\naddWidgetJS <- function(name, edit){\n file <- renderFile(\n sprintf('srcjs/%s.jsx', name),\n 'templates/widget_js.txt',\n 'boilerplate for widget JavaScript bindings',\n list(name = name)\n )\n if (edit) fileEdit(file)\n}\n\naddExampleApp <- function(name) {\n renderFile(\n 'app.R',\n 'templates/widget_app.R.txt',\n 'example app',\n list(\n name = name,\n capName = capitalize(name)\n )\n )\n}\n" }, { "path": "README.Rmd", "content": "---\noutput: github_document\n---\n\n# reactR \"reactR\n\n\n\n```{r setup, include = FALSE}\nknitr::opts_chunk$set(\n collapse = TRUE,\n comment = \"#>\",\n fig.path = \"man/figures/README-\",\n out.width = \"100%\"\n)\n```\n\n[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/reactR)](https://cran.r-project.org/package=reactR)\n[![R-CMD-check](https://github.com/react-R/reactR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/react-R/reactR/actions/workflows/R-CMD-check.yaml)\n\n`reactR` provides a set of convenience functions for using [`React`](https://reactjs.org/) in `R` with `htmlwidget` constructor templates and local JavaScript dependencies. The `React` ecosystem is rich with components that can enhance `R` web and Shiny apps. `scaffoldReactWidget()` helps build `htmlwidgets` to integrate these `React` components as `R` `htmlwidgets`. `scaffoldReactShinyInput()` does the same for `Shiny` inputs. The local dependency functions are modeled after the `html_dependency_*` functions from RStudio's [`rmarkdown`](https://github.com/rstudio/rmarkdown) package.\n\n## Installation\n\nYou can install reactR from CRAN with `install.packages(\"reactR\")`. For the development version, please use `devtools` as shown below.\n\n```R\n# install.packages(\"devtools\")\ndevtools::install_github(\"react-R/reactR\")\n```\n\n## Creating htmlwidgets with React Components\n\nTo wrap a `React` component as an `htmlwidget`, please see the tutorial [htmlwidgets with reactR](https://react-r.github.io/reactR/articles/intro_htmlwidgets.html). Also, there are a variety of examples in the [react-R Github organization](https://github.com/react-R).\n\n\n[`reactable`](https://github.com/glin/reactable) is a very well-built `htmlwidget` leveraging this functionality.\n\n## Shiny Outputs and Inputs\n\n`htmlwidgets` built with `reactR` work well in Shiny as outputs. In version `0.4.0` Alan Dipert has added the ability to easily create React-based official `Shiny` inputs with helpers and scaffolds. Please see the [tutorial](https://react-r.github.io/reactR/articles/intro_inputs.html) for more details.\n\n## Examples\n\nBelow are examples of using `reactR` directly.\n\n```R\nlibrary(reactR)\nlibrary(htmltools)\n\nbrowsable(tagList(\n tags$div(id = \"app\"),\n tags$script(\n \"\n ReactDOM.render(\n React.createElement(\n 'h1',\n null,\n 'Powered by React'\n ),\n document.getElementById('app')\n )\n \"\n ),\n #add core-js first to work in RStudio Viewer\n html_dependency_corejs(),\n html_dependency_react()\n))\n```\n\n`reactR` uses the `V8` package if available to transform `JSX` and `ES2015` code with `babel`.\n\n```R\nlibrary(reactR)\nlibrary(htmltools)\n\nbrowsable(\n tagList(\n tags$div(id = \"app\"),\n tags$script(\n babel_transform('ReactDOM.render(

Powered By React/JSX

,document.getElementById(\"app\"))')\n ),\n # add core-js shim first for React in older versions of RStudio Viewer\n #html_dependency_corejs(),\n html_dependency_react()\n )\n)\n```\n\n## Contributing and Code of Conduct\n\nWe welcome contributors and would love your participation. Please note that this project is released with a [Contributor Code of Conduct](https://github.com/react-R/reactR/blob/master/CONDUCT.md). By participating in this project you agree to abide by the terms.\n" }, { "path": "README.md", "content": "\n# reactR \"reactR\n\n\n\n[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/reactR)](https://cran.r-project.org/package=reactR)\n[![R-CMD-check](https://github.com/react-R/reactR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/react-R/reactR/actions/workflows/R-CMD-check.yaml)\n\n`reactR` provides a set of convenience functions for using\n[`React`](https://reactjs.org/) in `R` with `htmlwidget` constructor\ntemplates and local JavaScript dependencies. The `React` ecosystem is\nrich with components that can enhance `R` web and Shiny apps.\n`scaffoldReactWidget()` helps build `htmlwidgets` to integrate these\n`React` components as `R` `htmlwidgets`. `scaffoldReactShinyInput()`\ndoes the same for `Shiny` inputs. The local dependency functions are\nmodeled after the `html_dependency_*` functions from RStudio’s\n[`rmarkdown`](https://github.com/rstudio/rmarkdown) package.\n\n## Installation\n\nYou can install reactR from CRAN with `install.packages(\"reactR\")`. For\nthe development version, please use `devtools` as shown below.\n\n``` r\n# install.packages(\"devtools\")\ndevtools::install_github(\"react-R/reactR\")\n```\n\n## Creating htmlwidgets with React Components\n\nTo wrap a `React` component as an `htmlwidget`, please see the tutorial\n[htmlwidgets with\nreactR](https://react-r.github.io/reactR/articles/intro_htmlwidgets.html).\nAlso, there are a variety of examples in the [react-R Github\norganization](https://github.com/react-R).\n\n[`reactable`](https://github.com/glin/reactable) is a very well-built\n`htmlwidget` leveraging this functionality.\n\n## Shiny Outputs and Inputs\n\n`htmlwidgets` built with `reactR` work well in Shiny as outputs. In\nversion `0.4.0` Alan Dipert has added the ability to easily create\nReact-based official `Shiny` inputs with helpers and scaffolds. Please\nsee the\n[tutorial](https://react-r.github.io/reactR/articles/intro_inputs.html)\nfor more details.\n\n## Examples\n\nBelow are examples of using `reactR` directly.\n\n``` r\nlibrary(reactR)\nlibrary(htmltools)\n\nbrowsable(tagList(\n tags$div(id = \"app\"),\n tags$script(\n \"\n ReactDOM.render(\n React.createElement(\n 'h1',\n null,\n 'Powered by React'\n ),\n document.getElementById('app')\n )\n \"\n ),\n #add core-js first to work in RStudio Viewer\n html_dependency_corejs(),\n html_dependency_react()\n))\n```\n\n`reactR` uses the `V8` package if available to transform `JSX` and\n`ES2015` code with `babel`.\n\n``` r\nlibrary(reactR)\nlibrary(htmltools)\n\nbrowsable(\n tagList(\n tags$div(id = \"app\"),\n tags$script(\n babel_transform('ReactDOM.render(

Powered By React/JSX

,document.getElementById(\"app\"))')\n ),\n # add core-js shim first for React in older versions of RStudio Viewer\n #html_dependency_corejs(),\n html_dependency_react()\n )\n)\n```\n\n## Contributing and Code of Conduct\n\nWe welcome contributors and would love your participation. Please note\nthat this project is released with a [Contributor Code of\nConduct](https://github.com/react-R/reactR/blob/master/CONDUCT.md). By\nparticipating in this project you agree to abide by the terms.\n" }, { "path": "buildupdate/getreact.R", "content": "# use the very nice rgithub\n# devtools::install_github(\"cscheid/rgithub\")\n\nget_react_latest <- function(){\n gsub(\n x=github::get.latest.release(\"facebook\", \"react\")$content$tag_name,\n pattern=\"v\",\n replacement=\"\"\n )\n}\n\nget_babel_latest <- function(){\n gsub(\n x=github::get.latest.release(\"babel\", \"babel-standalone\")$content$tag_name,\n pattern=\"release-\",\n replacement=\"\"\n )\n}\n\n# get newest react\ndownload.file(\n url=sprintf(\n \"https://unpkg.com/react@%s/umd/react.production.min.js\",\n get_react_latest()\n ),\n destfile=\"./inst/www/react/react.min.js\"\n)\n\n# get newest react dom\ndownload.file(\n url=sprintf(\n \"https://unpkg.com/react-dom@%s/umd/react-dom.production.min.js\",\n get_react_latest()\n ),\n destfile=\"./inst/www/react/react-dom.min.js\"\n)\n\n# get newest babel\ndownload.file(\n url=sprintf(\n \"https://unpkg.com/babel-standalone@%s/babel.min.js\",\n get_babel_latest()\n ),\n destfile=\"./inst/www/babel/babel.min.js\"\n)\n\n# write function with newest version\n# for use when creating dependencies\ncat(\n sprintf(\n \"#'@keywords internal\\nreact_version <- function(){'%s'}\\nbabel_version <- function(){'%s'}\",\n get_react_latest(),\n get_babel_latest()\n ),\n file = \"./R/meta.R\"\n)\n" }, { "path": "cran-comments.md", "content": "## Test environments\n* local Windows 10 install, R 4.3.1\n* rhub check_for_cran\n* winbuilder\n* github actions check for cran - ubuntu, mac, windows\n\n## R CMD check results\n\n0 errors | 0 warnings | 0 note\n\n## Reverse dependencies\n\nreactable - consulted with author who has tested and approved the changes\n" }, { "path": "docs/404.html", "content": "\n\n\n\n\n\n\nPage not found (404) • reactR\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n\n
\n\n
\n\n\n \n\n
\n
\n
\n

Page not found (404)

\n
\n\nContent not found. Please use links in the navbar.\n\n
\n\n
\n \n
\n\n
\n\n\n\n
\n

\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/CONDUCT.html", "content": "\nContributor Code of Conduct • reactR\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n
\n
\n\n \n\n
\n
\n
\n

Contributor Code of Conduct

\n
\n\n
\n\n

As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.

\n

We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.

\n

Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.

\n

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.

\n

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.

\n

This Code of Conduct is adapted from the Contributor Covenant (http:contributor-covenant.org), version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/

\n
\n\n
\n\n
\n
\n\n
\n\n\n\n
\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/LICENSE-text.html", "content": "\nLicense • reactR\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n
\n
\n\n \n\n
\n
\n
\n

License

\n
\n\n
YEAR: 2018\nCOPYRIGHT HOLDER: Kent Russell\n
\n\n
\n\n
\n
\n\n
\n\n\n\n
\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/articles/index.html", "content": "\nArticles • reactR\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n
\n
\n\n \n\n
\n
\n
\n

Articles

\n
\n\n
\n

All vignettes

\n

\n\n
Authoring htmlwidgets powered by React with reactR
\n
\n
Authoring inputs powered by React with reactR
\n
\n
Intro to reactR
\n
\n
\n
\n
\n\n\n
\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/articles/intro_htmlwidgets.html", "content": "\n\n\n\n\n\n\nAuthoring htmlwidgets powered by React with reactR • reactR\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n\n
\n\n
\n\n\n \n\n
\n
\n
\n

Authoring htmlwidgets powered by React with\nreactR

\n

Alan\nDipert

\n

Carson\nSievert

\n \n

2024-09-14

\n \n Source: vignettes/intro_htmlwidgets.Rmd\n
intro_htmlwidgets.Rmd
\n\n
\n\n \n \n

The htmlwidgets package\nprovides a framework for creating R bindings to JavaScript libraries.\nUsing the htmlwidgets package alone, it’s not\nnecessarily straight-forward to create an R binding to a React-powered JavaScript library. The\nreactR package builds on the\nhtmlwidgets framework to make it much easier to author\nhtmlwidgets that are powered by React. This vignette\nwill show you how to effectively leverage reactR to\nbuild an htmlwidgets package that interfaces with react-sparklines\nReact JavaScript library.

\n
\n

Software pre-requisites\n

\n

In order to develop a reactR widget, you’ll need to\ninstall R and optionally RStudio. If you’re on Windows, you should also\ninstall Rtools.

\n
\n

For an excellent general introduction to R package concepts, check\nout the R packages online book.

\n
\n

In addition, you’ll need to install the following JavaScript tools on\nyour machine:

\n
    \n
  • \nNode.js: JavaScript engine and\nruntime for development outside of browsers. Provides the\nnode and npm commands.
    • \n
  • \nYarn: Command-line\ndependency management tool, provides the yarn command.
    • \n
\n

To follow along in this vignette, you’ll also need the following R\npackages:

\n
\ninstall.packages(c(\"shiny\", \"devtools\", \"usethis\", \"htmlwidgets\", \"reactR\"))
\n
\n
\n

Scaffolding\n

\n

To create a new widget you can call scaffoldReactWidget\nto generate the basic structure and build configuration. This function\nwill:

\n
    \n
  • Create the .R, .js, .yaml, and .json files required by your\nwidget;
    • \n
  • If provided, take an npm\npackage name and version as a named list with name and\nversion elements. For example, the npm package\nfoo at version ^1.2.0 would be expressed as\nlist(name = \"foo\", version = \"^1.2.0\"). The package, if\nprovided, will be added to the new widget’s package.json as\na build dependency.
    • \n
\n

The following R code will create an R package named\nsparklines, then provide the templating for creating an\nhtmlwidget powered by the react-sparklines npm package:

\n
\n# Create the R package\nusethis::create_package(\"~/sparklines\")\n# Inject the widget templating\nwithr::with_dir(\n  \"~/sparklines\", \n  reactR::scaffoldReactWidget(\"sparklines\", list(\"react-sparklines\" = \"^1.7.0\"), edit = FALSE)\n)
\n
\n
\n

Building and installing\n

\n
\n

Building the JavaScript\n

\n

The next step is to navigate to the newly-created\nsparklines project and run the following R commands:

\n
\nsystem(\"yarn install\")\nsystem(\"yarn run webpack\")
\n
    \n

  • yarn install downloads all of the dependencies\nlisted in package.json and creates a new file,\nyarn.lock. You should add this file to revision control. It\nwill be updated whenever you change dependencies and run\nyarn install. Note: you only need to run it after\nmodifying package.json. For further documentation on\nyarn install, see the yarn\ndocumentation.

    • \n

  • yarn run webpack compiles the ES2015 JavaScript source\nfile at srcjs/sparklines.js into\ninst/htmlwidgets/sparklines.js. The later file is one\nactually used by the R package and includes all the relevant JavaScript\ndependencies in a version of JavaScript that most browsers understand.\nNote that, if you add --mode=development to the end of this\ncommand, it will include a source\nmap is included with the compiled JavaScript, which makes JavaScript\ndebugging much easier, but hopefully you won’t need to do much of any\nJavaScript debugging.

    • \n
\n

yarn run webpack is not strictly a yarn\ncommand. In fact, yarn run simply delegates to the webpack program. Webpack’s\nconfiguration is generated by scaffoldReactWidget in the\nfile webpack.config.js, but you can always change this\nconfiguration and/or modify the yarn run webpack command to\nsuit your needs.

\n
\n
\n

Installing the R package\n

\n

Now that the widget’s JavaScript is compiled, go ahead and install\nthe R package:

\n
\ndevtools::document()\ndevtools::install(quick = TRUE)
\n

Alternatively, in RStudio, you can use the keyboard shortcuts\nCtrl+Shift+D and Ctrl-Shift-B to document and\nbuild the package. (On macOS, the shortcuts are Cmd+Shift+D\nand Cmd+Shift+B)

\n
\n
\n
\n

Run the included demo\n

\n

Now that the widget’s JavaScript is compiled, and the R package is\ninstalled, run app.R to see a demo in action:

\n
\nshiny::runApp()
\n

Alternatively, in RStudio, you can open app.R and press\nCtrl-Shift-Enter (Cmd-Shift-Enter on macOS).\nYou should see something like the following appear in the Viewer\npane:

\n

\n
\n
\n

Authoring a React binding\n

\n

At this point, we’ve built some scaffolding for an htmlwidget powered\nby React. Let’s modify it to create an interface to the\nreact-sparklines library. Authoring the interface requires\nsome changes on both the JavaScript and R side, but most of the hard\nthinking will be in figuring how best to design your interface. To give\nyou an example of how this could work, let’s build an interface to the\nSparklines component of the react-sparklines library.

\n
\n

First, outline an interface\n

\n
\n

Note that the examples in this section are just to demonstrate API\npossibilities and need not be pasted into any file.

\n
\n

Consider the following example taken from the react-sparklines\ndocumentation.

\n
import React from 'react';\nimport { Sparklines } from 'react-sparklines';\n\n<Sparklines data={sampleData}>\n  <SparklinesLine color=\"#56b45d\" />\n  <SparklinesSpots style={{ fill: \"#56b45d\" }} />\n</Sparklines>
\n

You have some choice in terms of how to design an R interface to this\nsort of React library, but usually it makes sense to have one function\nper component and have the arguments to that function feed into the\nproperties of that React component. In other words, our goal is to\ncreate an R function that allows users of our package to recreate this\nexample with the following code:

\n
\nlibrary(sparklines)\nsparklines(\n  data = sampleData,\n  sparklinesLine(color = \"#56b45d\"),\n  sparklinesSpots(style = list(fill = \"#56b45d\"))\n)
\n

The following sections show how to implement this R interface from\nour scaffolded widget.

\n
\n
\n

R implementation\n

\n

Consider the template that reactR::scaffoldReactWidget()\nprovided for us:

\n
\nsparklines <- function(message, width = NULL, height = NULL, elementId = NULL) {\n  \n  # describe a React component to send to the browser for rendering.\n  content <- htmltools::tag(\"div\", list(message))\n  \n  # create widget\n  htmlwidgets::createWidget(\n    name = 'sparklines',\n    reactR::reactMarkup(content),\n    width = width,\n    height = height,\n    package = 'sparklines',\n    elementId = elementId\n  )\n}
\n

This function is designed to simply display a message within an HTML\ndiv using reactR and htmlwidgets. The\ncritical piece here that makes it all work is\nreactR::reactMarkup(). This function can prepare a payload\ncontaining a mix of HTML tags (constructed via\nhtmltools::tag()), React components (constructed via\nreactR::component()), or character vectors in a such way\nthat the reactR and htmlwidgets\ntoolchain will understand and know how to render in the browser\n(assuming we’ve imported our React component appropriately, as we cover\nlater). Thus, to send a <Sparklines> react component\ninstead of an HTML <div>, we could simply change:

\n
\ncontent <- htmltools::tag(\"div\", list(message))
\n

to

\n
\nreactR::component(\"Sparklines\", list(message))
\n

Remember, though, that we’d like <Sparklines> to\nconsume a data property and also accept other valid\ncomponents (e.g., <SparklinesLine>,\n<SparklinesSpot>, etc) from this library as children.\nSo, we could change the body and signature of sparklines()\nin the following way:

\n
\nsparklines <- function(data, ..., width = NULL, height = NULL) {\n  \n  # describe a React component to send to the browser for rendering.\n  content <- reactR::component(\n    \"Sparklines\",\n    list(data = data, ...)\n  )\n  \n  # create widget\n  htmlwidgets::createWidget(\n    name = 'sparklines',\n    reactR::reactMarkup(content),\n    width = width,\n    height = height,\n    package = 'sparklines'\n  )\n}
\n

At this point, we define functions that make it easy for the user to\ncreate the other components by adding these to\nR/sparklines.R

\n
\n#' @export\nsparklinesLine <- function(...) {\n  reactR::React$SparklinesLine(...)\n}\n\n#' @export\nsparklinesSpots <- function(...) {\n  reactR::React$SparklinesSpots(...)\n}
\n
\n
\n

JavaScript changes\n

\n

In order for the reactR toolchain to know how to\nrender components from the ‘react-sparklines’ library, we need to\nregister the React components on the JavaScript side. This can be done\nin the srcjs/sparklines.js file which currently looks like\nthis:

\n
import { reactWidget } from 'reactR';\n\nreactWidget('sparklines', 'output', {});
\n

First, reactWidget is imported\nfrom the 'reactR' JavaScript module. This function will\nregister the React components we want within the reactR\nand htmlwidgets toolchain. Note that the\n'reactR' JavaScript is an html dependency, but webpack is\nconfigured in webpack.config.js to consider it a module, so\nit’s available to us here via import syntax.

\n

Then, there’s a call to reactWidget, and we pass it\nthree arguments:

\n
    \n
  1. The name of the widget ('sparklines')
    2. \n
  2. The type of the widget ('output')
    3. \n
  3. The React components that should be exposed to the widget. In this\ntemplate, we didn’t have to include any because it’s just rendering an\nHTML div.
    4. \n
\n

Instead of passing an empty object ({}) as the React\ncomponents, we provide an object with all the components we need from\nthe ‘react-sparklines’ module:

\n
import { Sparklines, SparklinesLine, SparklinesSpots } from 'react-sparklines';\nimport { reactWidget } from 'reactR';\n\nreactWidget('sparklines', 'output', {\n  Sparklines: Sparklines,\n  SparklinesLine: SparklinesLine,\n  SparklinesSpots: SparklinesSpots\n});
\n
\n
\n

Go for a spin\n

\n

Now that we’ve made the necessary changes to the JavaScript and R\nsource code, it’s time to compile the JavaScript and install the R\npackage:

\n
\nsystem(\"yarn install\")\nsystem(\"yarn run webpack\")\ndevtools::document()\ndevtools::install()\nlibrary(sparklines)\nsparklines(rnorm(10), sparklinesLine())
\n

This should open up the sparklines() widget in your\nbrowser. If it does, congratulations, you created a React-based\nhtmlwidget!

\n
\n
\n

Shiny integration\n

\n

The scaffolding template already provides the glue you need to get\nyour reactR widget to render in Shiny.\nThe two relevant functions are renderSparklines() and\nsparklinesOutput(). You shouldn’t need to modify these\nfunctions — they should work out of the box. You will, however, want to\nmodify the example Shiny app in the app.R\nfile:

\n
\nlibrary(shiny)\nlibrary(sparklines)\n\nui <- fluidPage(\n  titlePanel(\"Sparklines library\"),\n  sliderInput(\"n\", label = \"Number of samples\", min = 2, max = 1000, value = 100),\n  sparklinesOutput(\"myWidget\")\n)\n\nserver <- function(input, output, session) {\n    output$myWidget <- renderSparklines({\n        sparklines(\n            rnorm(input$n),\n            sparklinesLine()\n        )\n    })\n}\n\nshinyApp(ui, server)
\n

Now, when you run shiny::runApp(), you should see your\nreact-based htmlwidget rendering in shiny app!

\n

\n
\n
\n
\n

Further learning\n

\n

This tutorial walked you through the steps taken you create an R\ninterface to the react-sparklines library. The full example package is\naccessible at https://github.com/react-R/sparklines-example. Our\nintention is keep creating example packages under the https://github.com/react-R organization, so head there\nif you’d like to see other examples of interfacing with React.

\n
\n
\n\n
\n\n \n
\n\n
\n\n\n\n
\n

\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/articles/intro_htmlwidgets_files/accessible-code-block-0.0.1/empty-anchor.js", "content": "// Hide empty tag within highlighted CodeBlock for screen reader accessibility (see https://github.com/jgm/pandoc/issues/6352#issuecomment-626106786) -->\n// v0.0.1\n// Written by JooYoung Seo (jooyoung@psu.edu) and Atsushi Yasumoto on June 1st, 2020.\n\ndocument.addEventListener('DOMContentLoaded', function() {\n const codeList = document.getElementsByClassName(\"sourceCode\");\n for (var i = 0; i < codeList.length; i++) {\n var linkList = codeList[i].getElementsByTagName('a');\n for (var j = 0; j < linkList.length; j++) {\n if (linkList[j].innerHTML === \"\") {\n linkList[j].setAttribute('aria-hidden', 'true');\n }\n }\n }\n});\n" }, { "path": "docs/articles/intro_inputs.html", "content": "\n\n\n\n\n\n\nAuthoring inputs powered by React with reactR • reactR\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n\n
\n\n
\n\n\n \n\n
\n
\n
\n

Authoring inputs powered by React with\nreactR

\n

Alan Dipert and\nCarson Sievert

\n \n

2024-09-14

\n \n Source: vignettes/intro_inputs.Rmd\n
intro_inputs.Rmd
\n\n
\n\n \n \n

Shiny comes with a large\nlibrary of input widgets\nfor collecting input from the user and conveying input data to R.

\n

If you want a kind of input not provided by Shiny — like a\ncolor picker, or a different kind of slider — you’ve always been able to\nbuild your own. Shiny’s input system is extensible.\nAll that’s required is an understanding of certain conventions and a\nlittle custom JavaScript.

\n

reactR provides additional tools to ease the creation of new Shiny\ninputs implemented using React. In the following tutorial, we will\ndemonstrate these tools by implementing a new Shiny color picker input\nthat wraps the react-color\nlibrary.

\n
\n

Software pre-requisites\n

\n

In order to develop a reactR Shiny input, you’ll\nneed to install R and optionally RStudio. If you’re on Windows, you\nshould also install Rtools.

\n
\n

For an excellent general introduction to R package concepts, check\nout the R packages online book.

\n
\n

In addition, you’ll need to install the following JavaScript tools on\nyour machine:

\n
    \n
  • \nNode.js: JavaScript engine and\nruntime for development outside of browsers. Provides the\nnode and npm commands.
    • \n
  • \nYarn: Command-line\ndependency management tool, provides the yarn command.
    • \n
\n

To follow along in this vignette, you’ll also need the following R\npackages:

\n
\ninstall.packages(c(\"shiny\", \"devtools\", \"usethis\", \"reactR\"))
\n
\n
\n

Scaffolding\n

\n

To create a new widget you can call\nscaffoldReactShinyInput to generate the basic structure and\nbuild configuration. This function will:

\n
    \n
  • Create the .R, .js, and .json files required by your input;
    • \n
  • If provided, take an npm\npackage name and version as a named list with name and\nversion elements. For example, the npm package\nfoo at version ^1.2.0 would be expressed as\nlist(name = \"foo\", version = \"^1.2.0\"). The package, if\nprovided, will be added to the new widget’s package.json as\na build dependency.
    • \n
\n

The following R code will create an R package named\ncolorpicker, then provide the templating for creating\nan input powered by the react-color library on npm:

\n
\n# Create the R package (rstudio=TRUE is recommended if you're not already comfortable with your terminal)\nusethis::create_package(\"~/colorpicker\", rstudio = TRUE)\n# Scaffold initial input implementation files\nwithr::with_dir(\n  \"~/colorpicker\",\n  reactR::scaffoldReactShinyInput(\"colorpicker\", list(\"react-color\" = \"^2.17.0\"), edit = FALSE)\n)
\n
\n
\n

Building and installing\n

\n
\n

Building the JavaScript\n

\n

The next step is to navigate to the newly-created\ncolorpicker project and run the following commands in the\nterminal. If you’re new the terminal, we recommend opening your newly\ncreated RStudio ~/colorpicker/colorpicker.Rproj project\nfile, then running the following in the RStudio terminal tab:

\n
yarn install\nyarn run webpack
\n
    \n

  • yarn install downloads all of the dependencies\nlisted in package.json and creates a new file,\nyarn.lock. You should add this file to revision control. It\nwill be updated whenever you change dependencies and run\nyarn install. Note: you only need to run it after\nmodifying package.json. For further documentation on\nyarn install, see the yarn\ndocumentation.

    • \n

  • yarn run webpack compiles the modern JavaScript\nwith JSX\nsource file at srcjs/colorpicker.jsx into\nwww/colorpicker/colorpicker/colorpicker.js. The latter file\nis the one actually used by the R package and includes all the relevant\nJavaScript dependencies in a dialect of JavaScript that most browsers\nunderstand.

    • \n
\n

yarn run webpack is not strictly a yarn\ncommand. In fact, yarn run simply delegates to the webpack program. Webpack’s\nconfiguration is generated by scaffoldReactShinyInput in\nthe file webpack.config.js, but you can always change this\nconfiguration and/or modify the yarn run webpack command to\nsuit your needs.

\n
\n
\n

Installing the R package\n

\n

Now that the input’s JavaScript is compiled, go ahead and install the\nR package:

\n
\ndevtools::document()\ndevtools::install(quick = TRUE)
\n

In RStudio, you can use the keyboard shortcuts\nCtrl-Shift-D and Ctrl-Shift-B to document and\nbuild the package. (On macOS, the shortcuts are Cmd-Shift-D\nand Cmd-Shift-B)

\n
\n
\n
\n

Run the included demo\n

\n

Now that the input’s JavaScript is compiled, and the R package is\ninstalled, run app.R to see a demo in action:

\n
\nshiny::runApp()
\n

In RStudio, you can open app.R and press\nCtrl-Shift-Enter (Cmd-Shift-Enter on macOS).\nYou should see something like the following appear in the Viewer\npane:

\n

\n
\n
\n

Authoring a React input\n

\n

At this point, we have a working (if simple) React-powered text\ninput. Let’s modify it to create an interface to the\nreact-color library.

\n
\n

Connecting Shiny with React\n

\n

Consider the following example taken from the react-color\ndocumentation.

\n
import React from 'react';\nimport { SketchPicker } from 'react-color';\n\nclass Component extends React.Component {\n\n  render() {\n    return <SketchPicker />;\n  }\n}
\n

That JavaScript code produces a SketchPicker-type\ninterface that looks like this:

\n

\n

However, that example doesn’t demonstrate a way to default to a\nparticular color, or a way to cause something to happen when the color\nchanges. To accomplish these, react-color components can optionally\ntake the following props:

\n
    \n
  • \ncolor:\naccepts a string of a hex color like '#333'\n
    • \n
  • \nonChangeComplete:\naccepts a JavaScript function taking a single argument, the new\ncolor, that will be called when the new color is\nselected
    • \n
\n

Since this React component calls a configurable function (i.e.,\nonChangeComplete) when the input (i.e., color) value\nchanges, we can supply a function to inform Shiny about these changes.\nYou could, in theory, do this by writing your own custom Shiny input\nwrapper around this component, but reactR provides some\nconventions to make it much easier. These conventions have two main\nparts (R and JavaScript):

\n
    \n
  1. Use reactR::createReactShinyInput() to construct the\nuser-facing R input and route any user-supplied options (e.g., the\ndefault input value and other configuration)\nto the React component. This part was already done for us in the\nR/colorpicker.R file of our colorpicker project:
    2. \n
\n
\ncolorpickerInput <- function(inputId, default = \"\") {\n  reactR::createReactShinyInput(\n    inputId = inputId,\n    class = \"colorpicker\",\n    dependencies = htmltools::htmlDependency(\n      name = \"colorpicker-input\",\n      version = \"1.0.0\",\n      src = \"www/colorpicker/colorpicker\",\n      package = \"colorpicker\",\n      script = \"colorpicker.js\"\n    ),\n    default = default,\n    configuration = list(),\n    container = htmltools::tags$span\n  )\n}
\n
    \n
  1. Design an intermediate React component that routes\ninformation from colorpickerInput() to the\n<SketchPicker> component and also inform Shiny when a\nnew color is chosen. This intermediate component should be a functional\ncomponent with three arguments:
    2. \n
\n
    \n
  • \nconfiguration: The JSON equivalent of the\nconfiguration argument from\nreactR::createReactShinyInput(). In this particular\nexample, configuration isn’t used.
    • \n
  • \nvalue: The input’s values over time, beginning with the\ndefault supplied from\nreactR::createReactShinyInput().
    • \n
  • \nsetValue: A JavaScript function to call with the\ninput’s new value when one is created. This function is not user\nsupplied, but rather an internal hook for informing Shiny about changes\nto the component’s current state (i.e. value).
    • \n
\n

Consider the following intermediate component,\nPickerInput. Note how this intermediate component allows\none to set the default value from R and also calls\nsetValue() inside onChangeComplete in order to\ninform Shiny about new color values. Finally,\nreactR.reactShinyInput() registers this intermediate\ncomponent as a custom Shiny input binding named\ncolorpicker.

\n
import { reactShinyInput } from 'reactR';\nimport { SketchPicker } from 'react-color';\n\nconst PickerInput = ({ configuration, value, setValue }) => {\n  return (\n    <SketchPicker\n      color={ value }\n      onChangeComplete={ color => setValue(color.hex) }\n    />\n  );\n};\n\n// Note the first argument here should match the `class` \n// argument of the reactR::createReactShinyInput() from step 1\nreactShinyInput('.colorpicker', 'colorpicker', PickerInput);
\n

Open the srcjs/colorpicker.jsx file in your colorpicker\nproject and paste this code into it. After saving the file, run\nyarn run webpack in the terminal, re-install the package,\nthen run shiny::runApp() again

\n

When you select new colors, you should see the\ntextOutput update accordingly.

\n

You might have noticed that the input showed up initially without a\ncolor selected. That’s because in app.R we didn’t supply a\ndefault argument to the colorpickerInput\nfunction inside our ui.

\n

Try replacing the call to colorpickerInput with this:\ncolorpickerInput(\"textInput\", default = \"#a76161\")

\n

Now when you run the app, the color should start as a shade of\nred.

\n
\n
\n
\n

Further learning\n

\n

This tutorial walked you through the steps taken to wrap the\nreact-color library in a Shiny input. The full example\npackage is accessible at https://github.com/react-R/colorpicker-example. Our\nintention is keep creating example packages under the https://github.com/react-R organization, so head there\nif you’d like to see other examples of interfacing with React.

\n
\n
\n\n
\n\n \n
\n\n
\n\n\n\n
\n

\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/articles/intro_inputs_files/accessible-code-block-0.0.1/empty-anchor.js", "content": "// Hide empty tag within highlighted CodeBlock for screen reader accessibility (see https://github.com/jgm/pandoc/issues/6352#issuecomment-626106786) -->\n// v0.0.1\n// Written by JooYoung Seo (jooyoung@psu.edu) and Atsushi Yasumoto on June 1st, 2020.\n\ndocument.addEventListener('DOMContentLoaded', function() {\n const codeList = document.getElementsByClassName(\"sourceCode\");\n for (var i = 0; i < codeList.length; i++) {\n var linkList = codeList[i].getElementsByTagName('a');\n for (var j = 0; j < linkList.length; j++) {\n if (linkList[j].innerHTML === \"\") {\n linkList[j].setAttribute('aria-hidden', 'true');\n }\n }\n }\n});\n" }, { "path": "docs/articles/intro_reactR.html", "content": "\n\n\n\n\n\n\nIntro to reactR • reactR\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n\n
\n\n
\n\n\n \n\n
\n
\n
\n

Intro to reactR

\n

Kent\nRussell

\n \n

2024-09-14

\n \n Source: vignettes/intro_reactR.Rmd\n
intro_reactR.Rmd
\n\n
\n\n \n \n
\n

Why reactR?\n

\n

react has become\nincredibly popular, and the ecosystem around react is\nrobust. reactR aims to allow R users to more\neasily incorporate react and JSX.

\n
\n
\n

Install\n

\n
install.packages(\"reactR\")\n\n# for the latest development version\n#  install from Github\n# devtools::install_github(\"timelyportfolio/reactR\")
\n
\n
\n

Quick Example\n

\n

Let’s use react to render a simple h1 HTML\nelement below.

\n
\n\n
\n\n
## Warning: package 'htmltools' was built under R version 4.3.3
\n
\nattachDependencies(\n  tags$script(\n  \"\n    ReactDOM.render(\n      React.createElement(\n        'h1',\n        null,\n        'Powered by React'\n      ),\n      document.getElementById('react-heading-here')\n    )\n  \"\n  ),\n  html_dependency_react()\n)
\n\n
\n
\n

Blog Post\n

\n

For more on how we can use R and React, see the blog post React in R. Also,\nthere are many more examples in the Github repo at inst/examples.

\n
\n
\n

Using JSX\n

\n

JSX\nhelps ease some of the burden caused by\nReact.createElement. reactR provides a\nbabel_transform() function to use JSX.\nHopefully, in the future, we can convince RStudio to modify\nhtmltools to work directly with JSX (see issue).

\n
\n
\n\n
\n\n \n
\n\n
\n\n\n\n
\n

\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/articles/intro_reactR_files/accessible-code-block-0.0.1/empty-anchor.js", "content": "// Hide empty tag within highlighted CodeBlock for screen reader accessibility (see https://github.com/jgm/pandoc/issues/6352#issuecomment-626106786) -->\n// v0.0.1\n// Written by JooYoung Seo (jooyoung@psu.edu) and Atsushi Yasumoto on June 1st, 2020.\n\ndocument.addEventListener('DOMContentLoaded', function() {\n const codeList = document.getElementsByClassName(\"sourceCode\");\n for (var i = 0; i < codeList.length; i++) {\n var linkList = codeList[i].getElementsByTagName('a');\n for (var j = 0; j < linkList.length; j++) {\n if (linkList[j].innerHTML === \"\") {\n linkList[j].setAttribute('aria-hidden', 'true');\n }\n }\n }\n});\n" }, { "path": "docs/articles/intro_reactR_files/react-16.12.0/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "docs/articles/intro_reactR_files/react-16.12.0/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "docs/articles/intro_reactR_files/react-16.7.0/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "docs/articles/intro_reactR_files/react-16.7.0/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "docs/articles/intro_reactR_files/react-16.8.1/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "docs/articles/intro_reactR_files/react-16.8.1/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "docs/articles/intro_reactR_files/react-16.8.6/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "docs/articles/intro_reactR_files/react-16.8.6/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "docs/articles/intro_reactR_files/react-17.0.0/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "docs/articles/intro_reactR_files/react-17.0.0/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "docs/articles/intro_reactR_files/react-18.2.0/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "docs/articles/intro_reactR_files/react-18.2.0/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "docs/authors.html", "content": "\nAuthors and Citation • reactR\n \n\n
\n
\n
\n
\n \n \n reactR\n 0.6.1\n \n
\n\n \n
\n
\n\n \n\n
\n
\n
\n
\n

Authors

\n
\n\n \n
  • \n

    Facebook Inc. Author, copyright holder. \n
    React library in lib, https://reactjs.org/; see AUTHORS for full list of contributors

    \n
    • \n
  • \n

    Michel Weststrate. Author, copyright holder. \n
    mobx library in lib, https://github.com/mobxjs

    \n
    • \n
  • \n

    Kent Russell. Author, maintainer. \n
    R interface

    \n
    • \n
  • \n

    Alan Dipert. Author. \n
    R interface

    \n
    • \n
  • \n

    Greg Lin. Author. \n
    R interface

    \n
    • \n
\n
\n
\n

Citation

\n Source: DESCRIPTION\n
\n
\n\n\n

Inc F, Weststrate M, Russell K, Dipert A, Lin G (2024).\nreactR: React Helpers.\nR package version 0.6.1, https://github.com/react-R/reactR. \n

\n 
@Manual{,\n  title = {reactR: React Helpers},\n  author = {Facebook Inc and Michel Weststrate and Kent Russell and Alan Dipert and Greg Lin},\n  year = {2024},\n  note = {R package version 0.6.1},\n  url = {https://github.com/react-R/reactR},\n}
\n\n
\n\n
\n\n\n\n
\n

Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

\n
\n\n
\n

Site built with pkgdown 2.0.7.

\n
\n\n
\n\n \n\n\n \n\n \n\n" }, { "path": "docs/bootstrap-toc.css", "content": "/*!\n * Bootstrap Table of Contents v0.4.1 (http://afeld.github.io/bootstrap-toc/)\n * Copyright 2015 Aidan Feldman\n * Licensed under MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md) */\n\n/* modified from https://github.com/twbs/bootstrap/blob/94b4076dd2efba9af71f0b18d4ee4b163aa9e0dd/docs/assets/css/src/docs.css#L548-L601 */\n\n/* All levels of nav */\nnav[data-toggle='toc'] .nav > li > a {\n display: block;\n padding: 4px 20px;\n font-size: 13px;\n font-weight: 500;\n color: #767676;\n}\nnav[data-toggle='toc'] .nav > li > a:hover,\nnav[data-toggle='toc'] .nav > li > a:focus {\n padding-left: 19px;\n color: #563d7c;\n text-decoration: none;\n background-color: transparent;\n border-left: 1px solid #563d7c;\n}\nnav[data-toggle='toc'] .nav > .active > a,\nnav[data-toggle='toc'] .nav > .active:hover > a,\nnav[data-toggle='toc'] .nav > .active:focus > a {\n padding-left: 18px;\n font-weight: bold;\n color: #563d7c;\n background-color: transparent;\n border-left: 2px solid #563d7c;\n}\n\n/* Nav: second level (shown on .active) */\nnav[data-toggle='toc'] .nav .nav {\n display: none; /* Hide by default, but at >768px, show it */\n padding-bottom: 10px;\n}\nnav[data-toggle='toc'] .nav .nav > li > a {\n padding-top: 1px;\n padding-bottom: 1px;\n padding-left: 30px;\n font-size: 12px;\n font-weight: normal;\n}\nnav[data-toggle='toc'] .nav .nav > li > a:hover,\nnav[data-toggle='toc'] .nav .nav > li > a:focus {\n padding-left: 29px;\n}\nnav[data-toggle='toc'] .nav .nav > .active > a,\nnav[data-toggle='toc'] .nav .nav > .active:hover > a,\nnav[data-toggle='toc'] .nav .nav > .active:focus > a {\n padding-left: 28px;\n font-weight: 500;\n}\n\n/* from https://github.com/twbs/bootstrap/blob/e38f066d8c203c3e032da0ff23cd2d6098ee2dd6/docs/assets/css/src/docs.css#L631-L634 */\nnav[data-toggle='toc'] .nav > .active > ul {\n display: block;\n}\n" }, { "path": "docs/bootstrap-toc.js", "content": "/*!\n * Bootstrap Table of Contents v0.4.1 (http://afeld.github.io/bootstrap-toc/)\n * Copyright 2015 Aidan Feldman\n * Licensed under MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md) */\n(function() {\n 'use strict';\n\n window.Toc = {\n helpers: {\n // return all matching elements in the set, or their descendants\n findOrFilter: function($el, selector) {\n // http://danielnouri.org/notes/2011/03/14/a-jquery-find-that-also-finds-the-root-element/\n // http://stackoverflow.com/a/12731439/358804\n var $descendants = $el.find(selector);\n return $el.filter(selector).add($descendants).filter(':not([data-toc-skip])');\n },\n\n generateUniqueIdBase: function(el) {\n var text = $(el).text();\n var anchor = text.trim().toLowerCase().replace(/[^A-Za-z0-9]+/g, '-');\n return anchor || el.tagName.toLowerCase();\n },\n\n generateUniqueId: function(el) {\n var anchorBase = this.generateUniqueIdBase(el);\n for (var i = 0; ; i++) {\n var anchor = anchorBase;\n if (i > 0) {\n // add suffix\n anchor += '-' + i;\n }\n // check if ID already exists\n if (!document.getElementById(anchor)) {\n return anchor;\n }\n }\n },\n\n generateAnchor: function(el) {\n if (el.id) {\n return el.id;\n } else {\n var anchor = this.generateUniqueId(el);\n el.id = anchor;\n return anchor;\n }\n },\n\n createNavList: function() {\n return $('');\n },\n\n createChildNavList: function($parent) {\n var $childList = this.createNavList();\n $parent.append($childList);\n return $childList;\n },\n\n generateNavEl: function(anchor, text) {\n var $a = $('');\n $a.attr('href', '#' + anchor);\n $a.text(text);\n var $li = $('
  • ');\n $li.append($a);\n return $li;\n },\n\n generateNavItem: function(headingEl) {\n var anchor = this.generateAnchor(headingEl);\n var $heading = $(headingEl);\n var text = $heading.data('toc-text') || $heading.text();\n return this.generateNavEl(anchor, text);\n },\n\n // Find the first heading level (`

    `, then `

    `, etc.) that has more than one element. Defaults to 1 (for `

    `).\n getTopLevel: function($scope) {\n for (var i = 1; i <= 6; i++) {\n var $headings = this.findOrFilter($scope, 'h' + i);\n if ($headings.length > 1) {\n return i;\n }\n }\n\n return 1;\n },\n\n // returns the elements for the top level, and the next below it\n getHeadings: function($scope, topLevel) {\n var topSelector = 'h' + topLevel;\n\n var secondaryLevel = topLevel + 1;\n var secondarySelector = 'h' + secondaryLevel;\n\n return this.findOrFilter($scope, topSelector + ',' + secondarySelector);\n },\n\n getNavLevel: function(el) {\n return parseInt(el.tagName.charAt(1), 10);\n },\n\n populateNav: function($topContext, topLevel, $headings) {\n var $context = $topContext;\n var $prevNav;\n\n var helpers = this;\n $headings.each(function(i, el) {\n var $newNav = helpers.generateNavItem(el);\n var navLevel = helpers.getNavLevel(el);\n\n // determine the proper $context\n if (navLevel === topLevel) {\n // use top level\n $context = $topContext;\n } else if ($prevNav && $context === $topContext) {\n // create a new level of the tree and switch to it\n $context = helpers.createChildNavList($prevNav);\n } // else use the current $context\n\n $context.append($newNav);\n\n $prevNav = $newNav;\n });\n },\n\n parseOps: function(arg) {\n var opts;\n if (arg.jquery) {\n opts = {\n $nav: arg\n };\n } else {\n opts = arg;\n }\n opts.$scope = opts.$scope || $(document.body);\n return opts;\n }\n },\n\n // accepts a jQuery object, or an options object\n init: function(opts) {\n opts = this.helpers.parseOps(opts);\n\n // ensure that the data attribute is in place for styling\n opts.$nav.attr('data-toggle', 'toc');\n\n var $topContext = this.helpers.createChildNavList(opts.$nav);\n var topLevel = this.helpers.getTopLevel(opts.$scope);\n var $headings = this.helpers.getHeadings(opts.$scope, topLevel);\n this.helpers.populateNav($topContext, topLevel, $headings);\n }\n };\n\n $(function() {\n $('nav[data-toggle=\"toc\"]').each(function(i, el) {\n var $nav = $(el);\n Toc.init($nav);\n });\n });\n})();\n" }, { "path": "docs/docsearch.css", "content": "/* Docsearch -------------------------------------------------------------- */\n/*\n Source: https://github.com/algolia/docsearch/\n License: MIT\n*/\n\n.algolia-autocomplete {\n display: block;\n -webkit-box-flex: 1;\n -ms-flex: 1;\n flex: 1\n}\n\n.algolia-autocomplete .ds-dropdown-menu {\n width: 100%;\n min-width: none;\n max-width: none;\n padding: .75rem 0;\n background-color: #fff;\n background-clip: padding-box;\n border: 1px solid rgba(0, 0, 0, .1);\n box-shadow: 0 .5rem 1rem rgba(0, 0, 0, .175);\n}\n\n@media (min-width:768px) {\n .algolia-autocomplete .ds-dropdown-menu {\n width: 175%\n }\n}\n\n.algolia-autocomplete .ds-dropdown-menu::before {\n display: none\n}\n\n.algolia-autocomplete .ds-dropdown-menu [class^=ds-dataset-] {\n padding: 0;\n background-color: rgb(255,255,255);\n border: 0;\n max-height: 80vh;\n}\n\n.algolia-autocomplete .ds-dropdown-menu .ds-suggestions {\n margin-top: 0\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion {\n padding: 0;\n overflow: visible\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--category-header {\n padding: .125rem 1rem;\n margin-top: 0;\n font-size: 1.3em;\n font-weight: 500;\n color: #00008B;\n border-bottom: 0\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--wrapper {\n float: none;\n padding-top: 0\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--subcategory-column {\n float: none;\n width: auto;\n padding: 0;\n text-align: left\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--content {\n float: none;\n width: auto;\n padding: 0\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--content::before {\n display: none\n}\n\n.algolia-autocomplete .ds-suggestion:not(:first-child) .algolia-docsearch-suggestion--category-header {\n padding-top: .75rem;\n margin-top: .75rem;\n border-top: 1px solid rgba(0, 0, 0, .1)\n}\n\n.algolia-autocomplete .ds-suggestion .algolia-docsearch-suggestion--subcategory-column {\n display: block;\n padding: .1rem 1rem;\n margin-bottom: 0.1;\n font-size: 1.0em;\n font-weight: 400\n /* display: none */\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--title {\n display: block;\n padding: .25rem 1rem;\n margin-bottom: 0;\n font-size: 0.9em;\n font-weight: 400\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--text {\n padding: 0 1rem .5rem;\n margin-top: -.25rem;\n font-size: 0.8em;\n font-weight: 400;\n line-height: 1.25\n}\n\n.algolia-autocomplete .algolia-docsearch-footer {\n width: 110px;\n height: 20px;\n z-index: 3;\n margin-top: 10.66667px;\n float: right;\n font-size: 0;\n line-height: 0;\n}\n\n.algolia-autocomplete .algolia-docsearch-footer--logo {\n background-image: url(\"data:image/svg+xml;utf8,\");\n background-repeat: no-repeat;\n background-position: 50%;\n background-size: 100%;\n overflow: hidden;\n text-indent: -9000px;\n width: 100%;\n height: 100%;\n display: block;\n transform: translate(-8px);\n}\n\n.algolia-autocomplete .algolia-docsearch-suggestion--highlight {\n color: #FF8C00;\n background: rgba(232, 189, 54, 0.1)\n}\n\n\n.algolia-autocomplete .algolia-docsearch-suggestion--text .algolia-docsearch-suggestion--highlight {\n box-shadow: inset 0 -2px 0 0 rgba(105, 105, 105, .5)\n}\n\n.algolia-autocomplete .ds-suggestion.ds-cursor .algolia-docsearch-suggestion--content {\n background-color: rgba(192, 192, 192, .15)\n}\n" }, { "path": "docs/docsearch.js", "content": "$(function() {\n\n // register a handler to move the focus to the search bar\n // upon pressing shift + \"/\" (i.e. \"?\")\n $(document).on('keydown', function(e) {\n if (e.shiftKey && e.keyCode == 191) {\n e.preventDefault();\n $(\"#search-input\").focus();\n }\n });\n\n $(document).ready(function() {\n // do keyword highlighting\n /* modified from https://jsfiddle.net/julmot/bL6bb5oo/ */\n var mark = function() {\n\n var referrer = document.URL ;\n var paramKey = \"q\" ;\n\n if (referrer.indexOf(\"?\") !== -1) {\n var qs = referrer.substr(referrer.indexOf('?') + 1);\n var qs_noanchor = qs.split('#')[0];\n var qsa = qs_noanchor.split('&');\n var keyword = \"\";\n\n for (var i = 0; i < qsa.length; i++) {\n var currentParam = qsa[i].split('=');\n\n if (currentParam.length !== 2) {\n continue;\n }\n\n if (currentParam[0] == paramKey) {\n keyword = decodeURIComponent(currentParam[1].replace(/\\+/g, \"%20\"));\n }\n }\n\n if (keyword !== \"\") {\n $(\".contents\").unmark({\n done: function() {\n $(\".contents\").mark(keyword);\n }\n });\n }\n }\n };\n\n mark();\n });\n});\n\n/* Search term highlighting ------------------------------*/\n\nfunction matchedWords(hit) {\n var words = [];\n\n var hierarchy = hit._highlightResult.hierarchy;\n // loop to fetch from lvl0, lvl1, etc.\n for (var idx in hierarchy) {\n words = words.concat(hierarchy[idx].matchedWords);\n }\n\n var content = hit._highlightResult.content;\n if (content) {\n words = words.concat(content.matchedWords);\n }\n\n // return unique words\n var words_uniq = [...new Set(words)];\n return words_uniq;\n}\n\nfunction updateHitURL(hit) {\n\n var words = matchedWords(hit);\n var url = \"\";\n\n if (hit.anchor) {\n url = hit.url_without_anchor + '?q=' + escape(words.join(\" \")) + '#' + hit.anchor;\n } else {\n url = hit.url + '?q=' + escape(words.join(\" \"));\n }\n\n return url;\n}\n" }, { "path": "docs/index.html", "content": "\n\n\n\n\n\n\nReact Helpers • reactR\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n\n
    \n\n
    \n\n\n \n\n
    \n
    \n
    \n

    reactR \"reactR\n

    \n\n

    \"CRAN_Status_Badge\" \"R-CMD-check\"

    \n

    reactR provides a set of convenience functions for using React in R with htmlwidget constructor templates and local JavaScript dependencies. The React ecosystem is rich with components that can enhance R web and Shiny apps. scaffoldReactWidget() helps build htmlwidgets to integrate these React components as R htmlwidgets. scaffoldReactShinyInput() does the same for Shiny inputs. The local dependency functions are modeled after the html_dependency_* functions from RStudio’s rmarkdown package.

    \n
    \n

    Installation\n

    \n

    You can install reactR from CRAN with install.packages(\"reactR\"). For the development version, please use devtools as shown below.

    \n
    \n# install.packages(\"devtools\")\ndevtools::install_github(\"react-R/reactR\")
    \n
    \n
    \n

    Creating htmlwidgets with React Components\n

    \n

    To wrap a React component as an htmlwidget, please see the tutorial htmlwidgets with reactR. Also, there are a variety of examples in the react-R Github organization.

    \n

    reactable is a very well-built htmlwidget leveraging this functionality.

    \n
    \n
    \n

    Shiny Outputs and Inputs\n

    \n

    htmlwidgets built with reactR work well in Shiny as outputs. In version 0.4.0 Alan Dipert has added the ability to easily create React-based official Shiny inputs with helpers and scaffolds. Please see the tutorial for more details.

    \n
    \n
    \n

    Examples\n

    \n

    Below are examples of using reactR directly.

    \n
    \nlibrary(reactR)\nlibrary(htmltools)\n\nbrowsable(tagList(\n  tags$div(id = \"app\"),\n  tags$script(\n  \"\n    ReactDOM.render(\n      React.createElement(\n        'h1',\n        null,\n        'Powered by React'\n      ),\n      document.getElementById('app')\n    )\n  \"\n  ),\n  #add core-js first to work in RStudio Viewer\n  html_dependency_corejs(),\n  html_dependency_react()\n))
    \n

    reactR uses the V8 package if available to transform JSX and ES2015 code with babel.

    \n
    \nlibrary(reactR)\nlibrary(htmltools)\n\nbrowsable(\n  tagList(\n    tags$div(id = \"app\"),\n    tags$script(\n      babel_transform('ReactDOM.render(<h1>Powered By React/JSX</h1>,document.getElementById(\"app\"))')\n    ),\n    # add core-js shim first for React in older versions of RStudio Viewer\n    #html_dependency_corejs(),\n    html_dependency_react()\n  )\n)
    \n
    \n
    \n

    Contributing and Code of Conduct\n

    \n

    We welcome contributors and would love your participation. Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by the terms.

    \n
    \n
    \n
    \n\n
    \n
    \n

    Links

    \n\n
    \n\n
    \n

    License

    \n\n
    \n\n\n
    \n

    Citation

    \n\n
    \n\n
    \n

    Developers

    \n
      \n
    • Facebook Inc
      Author, copyright holder
      • \n
    • Michel Weststrate
      Author, copyright holder
      • \n
    • Kent Russell
      Author, maintainer
      • \n
    • Alan Dipert
      Author
      • \n
    • Greg Lin
      Author
      • \n
    • More about authors...
      • \n
    \n
    \n\n\n\n
    \n
    \n\n\n
    \n

    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/news/index.html", "content": "\nChangelog • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Changelog

    \n Source: NEWS.md\n
    \n\n
    \n

    reactR 0.6.1

    \n
    • Fix issue where the react-tools.umd.cjs script could be blocked by the browser in some cases, such as apps deployed on shinyapps.io #86\n
      • \n
    \n
    \n

    reactR 0.6.02024-06-26

    \n
    • retain list in reactR::component classes #82\n
      • \n
    • hydrate props/attribs that are tags assuming tag-like props/attribs should be slots#67 #61\n
      • \n
    • update build tools to vite from webpack\n
      • \n
    • update js testing library from karma to vitest\n
      • \n
    \n
    \n

    reactR 0.5.02023-10-11

    \n
    • Update react to 18.2.0\n
      • \n
    \n
    \n

    reactR 0.4.42021-02-22

    \n

    • Update react to 16.12.0

      • \n

    • Add style-loader and css-loader to webpack config pull 50

      • \n

    • Update to PACKAGE::widget_html.WIDGETNAME for new htmlwidgets convention pull 49

      • \n

    • Clean up template pull 45

      • \n
    \n
    \n

    reactR 0.4.32020-07-12

    \n

    • Add element to Shiny input pull 41

      • \n

    • Upgrade npm dependencies

      • \n
    \n
    \n

    reactR 0.4.22020-01-24

    \n

    • Update react to 16.12.0

      • \n

    • Update core-js to 2.6.11

      • \n
    \n
    \n

    reactR 0.4.12019-07-07

    \n
    \n
    \n

    reactR 0.4.02019-04-17

    \n
    \n
    \n

    reactR 0.3.1

    \n
    • Update react and react-dom to 16.8.1
      • \n
    • Add usethis R dependency
      • \n
    • Ignore node_modules in .Rbuildignore and .gitignore\n
      • \n
    • Set {modules:false} in babel_transform to avoid \"use strict\"; pull 15\n
      • \n
    • Use webpack to build react-tools.js; pull 16\n
      • \n
    • Attach component to the htmlwidget
      • \n
    \n
    \n

    reactR 0.3.02019-01-15

    \n
    • Add htmlwidget scaffold and helpers (see tutorial)
      • \n
    • Update react and react-dom to 16.6.7
      • \n
    \n
    \n

    reactR 0.2.12018-10-25

    \n
    • Update react and react-dom to 16.6.0
      • \n
    \n
    \n

    reactR 0.2.02018-02-21

    \n
    • Update react and react-dom to 16.2.0
      • \n
    • Add core-js shim so that React will show up in RStudio Viewer
      • \n
    \n
    \n

    reactR 0.1.42017-11-22

    \n
    • Update react and react-dom to 16.1.1
      • \n
    \n
    \n

    reactR 0.1.32017-10-12

    \n
    • Update react and react-dom to 16.0.0
      • \n
    • Update babel to 6.26.0
      • \n
    \n
    \n

    reactR 0.1.22017-04-10

    \n
    • Update to react 15.5.0\n
      • \n
    • Update to babel 6.24.0\n
      • \n
    • Add fluent-ui(fabric) example
      • \n
    • Build doc site with pkgdown\n
      • \n
    \n
    \n

    reactR 0.1.1

    \n
    • Added a NEWS.md file to track changes to the package.
      • \n
    • Provide offline babel-standalone for babel_transform
      • \n
    \n
    \n

    reactR 0.1.02016-11-05

    \n
    • Initial release
      • \n
    \n
    \n\n
    \n
    \n\n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/pkgdown.css", "content": "/* Sticky footer */\n\n/**\n * Basic idea: https://philipwalton.github.io/solved-by-flexbox/demos/sticky-footer/\n * Details: https://github.com/philipwalton/solved-by-flexbox/blob/master/assets/css/components/site.css\n *\n * .Site -> body > .container\n * .Site-content -> body > .container .row\n * .footer -> footer\n *\n * Key idea seems to be to ensure that .container and __all its parents__\n * have height set to 100%\n *\n */\n\nhtml, body {\n height: 100%;\n}\n\nbody {\n position: relative;\n}\n\nbody > .container {\n display: flex;\n height: 100%;\n flex-direction: column;\n}\n\nbody > .container .row {\n flex: 1 0 auto;\n}\n\nfooter {\n margin-top: 45px;\n padding: 35px 0 36px;\n border-top: 1px solid #e5e5e5;\n color: #666;\n display: flex;\n flex-shrink: 0;\n}\nfooter p {\n margin-bottom: 0;\n}\nfooter div {\n flex: 1;\n}\nfooter .pkgdown {\n text-align: right;\n}\nfooter p {\n margin-bottom: 0;\n}\n\nimg.icon {\n float: right;\n}\n\n/* Ensure in-page images don't run outside their container */\n.contents img {\n max-width: 100%;\n height: auto;\n}\n\n/* Fix bug in bootstrap (only seen in firefox) */\nsummary {\n display: list-item;\n}\n\n/* Typographic tweaking ---------------------------------*/\n\n.contents .page-header {\n margin-top: calc(-60px + 1em);\n}\n\ndd {\n margin-left: 3em;\n}\n\n/* Section anchors ---------------------------------*/\n\na.anchor {\n display: none;\n margin-left: 5px;\n width: 20px;\n height: 20px;\n\n background-image: url(./link.svg);\n background-repeat: no-repeat;\n background-size: 20px 20px;\n background-position: center center;\n}\n\nh1:hover .anchor,\nh2:hover .anchor,\nh3:hover .anchor,\nh4:hover .anchor,\nh5:hover .anchor,\nh6:hover .anchor {\n display: inline-block;\n}\n\n/* Fixes for fixed navbar --------------------------*/\n\n.contents h1, .contents h2, .contents h3, .contents h4 {\n padding-top: 60px;\n margin-top: -40px;\n}\n\n/* Navbar submenu --------------------------*/\n\n.dropdown-submenu {\n position: relative;\n}\n\n.dropdown-submenu>.dropdown-menu {\n top: 0;\n left: 100%;\n margin-top: -6px;\n margin-left: -1px;\n border-radius: 0 6px 6px 6px;\n}\n\n.dropdown-submenu:hover>.dropdown-menu {\n display: block;\n}\n\n.dropdown-submenu>a:after {\n display: block;\n content: \" \";\n float: right;\n width: 0;\n height: 0;\n border-color: transparent;\n border-style: solid;\n border-width: 5px 0 5px 5px;\n border-left-color: #cccccc;\n margin-top: 5px;\n margin-right: -10px;\n}\n\n.dropdown-submenu:hover>a:after {\n border-left-color: #ffffff;\n}\n\n.dropdown-submenu.pull-left {\n float: none;\n}\n\n.dropdown-submenu.pull-left>.dropdown-menu {\n left: -100%;\n margin-left: 10px;\n border-radius: 6px 0 6px 6px;\n}\n\n/* Sidebar --------------------------*/\n\n#pkgdown-sidebar {\n margin-top: 30px;\n position: -webkit-sticky;\n position: sticky;\n top: 70px;\n}\n\n#pkgdown-sidebar h2 {\n font-size: 1.5em;\n margin-top: 1em;\n}\n\n#pkgdown-sidebar h2:first-child {\n margin-top: 0;\n}\n\n#pkgdown-sidebar .list-unstyled li {\n margin-bottom: 0.5em;\n}\n\n/* bootstrap-toc tweaks ------------------------------------------------------*/\n\n/* All levels of nav */\n\nnav[data-toggle='toc'] .nav > li > a {\n padding: 4px 20px 4px 6px;\n font-size: 1.5rem;\n font-weight: 400;\n color: inherit;\n}\n\nnav[data-toggle='toc'] .nav > li > a:hover,\nnav[data-toggle='toc'] .nav > li > a:focus {\n padding-left: 5px;\n color: inherit;\n border-left: 1px solid #878787;\n}\n\nnav[data-toggle='toc'] .nav > .active > a,\nnav[data-toggle='toc'] .nav > .active:hover > a,\nnav[data-toggle='toc'] .nav > .active:focus > a {\n padding-left: 5px;\n font-size: 1.5rem;\n font-weight: 400;\n color: inherit;\n border-left: 2px solid #878787;\n}\n\n/* Nav: second level (shown on .active) */\n\nnav[data-toggle='toc'] .nav .nav {\n display: none; /* Hide by default, but at >768px, show it */\n padding-bottom: 10px;\n}\n\nnav[data-toggle='toc'] .nav .nav > li > a {\n padding-left: 16px;\n font-size: 1.35rem;\n}\n\nnav[data-toggle='toc'] .nav .nav > li > a:hover,\nnav[data-toggle='toc'] .nav .nav > li > a:focus {\n padding-left: 15px;\n}\n\nnav[data-toggle='toc'] .nav .nav > .active > a,\nnav[data-toggle='toc'] .nav .nav > .active:hover > a,\nnav[data-toggle='toc'] .nav .nav > .active:focus > a {\n padding-left: 15px;\n font-weight: 500;\n font-size: 1.35rem;\n}\n\n/* orcid ------------------------------------------------------------------- */\n\n.orcid {\n font-size: 16px;\n color: #A6CE39;\n /* margins are required by official ORCID trademark and display guidelines */\n margin-left:4px;\n margin-right:4px;\n vertical-align: middle;\n}\n\n/* Reference index & topics ----------------------------------------------- */\n\n.ref-index th {font-weight: normal;}\n\n.ref-index td {vertical-align: top; min-width: 100px}\n.ref-index .icon {width: 40px;}\n.ref-index .alias {width: 40%;}\n.ref-index-icons .alias {width: calc(40% - 40px);}\n.ref-index .title {width: 60%;}\n\n.ref-arguments th {text-align: right; padding-right: 10px;}\n.ref-arguments th, .ref-arguments td {vertical-align: top; min-width: 100px}\n.ref-arguments .name {width: 20%;}\n.ref-arguments .desc {width: 80%;}\n\n/* Nice scrolling for wide elements --------------------------------------- */\n\ntable {\n display: block;\n overflow: auto;\n}\n\n/* Syntax highlighting ---------------------------------------------------- */\n\npre, code, pre code {\n background-color: #f8f8f8;\n color: #333;\n}\npre, pre code {\n white-space: pre-wrap;\n word-break: break-all;\n overflow-wrap: break-word;\n}\n\npre {\n border: 1px solid #eee;\n}\n\npre .img, pre .r-plt {\n margin: 5px 0;\n}\n\npre .img img, pre .r-plt img {\n background-color: #fff;\n}\n\ncode a, pre a {\n color: #375f84;\n}\n\na.sourceLine:hover {\n text-decoration: none;\n}\n\n.fl {color: #1514b5;}\n.fu {color: #000000;} /* function */\n.ch,.st {color: #036a07;} /* string */\n.kw {color: #264D66;} /* keyword */\n.co {color: #888888;} /* comment */\n\n.error {font-weight: bolder;}\n.warning {font-weight: bolder;}\n\n/* Clipboard --------------------------*/\n\n.hasCopyButton {\n position: relative;\n}\n\n.btn-copy-ex {\n position: absolute;\n right: 0;\n top: 0;\n visibility: hidden;\n}\n\n.hasCopyButton:hover button.btn-copy-ex {\n visibility: visible;\n}\n\n/* headroom.js ------------------------ */\n\n.headroom {\n will-change: transform;\n transition: transform 200ms linear;\n}\n.headroom--pinned {\n transform: translateY(0%);\n}\n.headroom--unpinned {\n transform: translateY(-100%);\n}\n\n/* mark.js ----------------------------*/\n\nmark {\n background-color: rgba(255, 255, 51, 0.5);\n border-bottom: 2px solid rgba(255, 153, 51, 0.3);\n padding: 1px;\n}\n\n/* vertical spacing after htmlwidgets */\n.html-widget {\n margin-bottom: 10px;\n}\n\n/* fontawesome ------------------------ */\n\n.fab {\n font-family: \"Font Awesome 5 Brands\" !important;\n}\n\n/* don't display links in code chunks when printing */\n/* source: https://stackoverflow.com/a/10781533 */\n@media print {\n code a:link:after, code a:visited:after {\n content: \"\";\n }\n}\n\n/* Section anchors ---------------------------------\n Added in pandoc 2.11: https://github.com/jgm/pandoc-templates/commit/9904bf71\n*/\n\ndiv.csl-bib-body { }\ndiv.csl-entry {\n clear: both;\n}\n.hanging-indent div.csl-entry {\n margin-left:2em;\n text-indent:-2em;\n}\ndiv.csl-left-margin {\n min-width:2em;\n float:left;\n}\ndiv.csl-right-inline {\n margin-left:2em;\n padding-left:1em;\n}\ndiv.csl-indent {\n margin-left: 2em;\n}\n" }, { "path": "docs/pkgdown.js", "content": "/* http://gregfranko.com/blog/jquery-best-practices/ */\n(function($) {\n $(function() {\n\n $('.navbar-fixed-top').headroom();\n\n $('body').css('padding-top', $('.navbar').height() + 10);\n $(window).resize(function(){\n $('body').css('padding-top', $('.navbar').height() + 10);\n });\n\n $('[data-toggle=\"tooltip\"]').tooltip();\n\n var cur_path = paths(location.pathname);\n var links = $(\"#navbar ul li a\");\n var max_length = -1;\n var pos = -1;\n for (var i = 0; i < links.length; i++) {\n if (links[i].getAttribute(\"href\") === \"#\")\n continue;\n // Ignore external links\n if (links[i].host !== location.host)\n continue;\n\n var nav_path = paths(links[i].pathname);\n\n var length = prefix_length(nav_path, cur_path);\n if (length > max_length) {\n max_length = length;\n pos = i;\n }\n }\n\n // Add class to parent
  • , and enclosing
  • if in dropdown\n if (pos >= 0) {\n var menu_anchor = $(links[pos]);\n menu_anchor.parent().addClass(\"active\");\n menu_anchor.closest(\"li.dropdown\").addClass(\"active\");\n }\n });\n\n function paths(pathname) {\n var pieces = pathname.split(\"/\");\n pieces.shift(); // always starts with /\n\n var end = pieces[pieces.length - 1];\n if (end === \"index.html\" || end === \"\")\n pieces.pop();\n return(pieces);\n }\n\n // Returns -1 if not found\n function prefix_length(needle, haystack) {\n if (needle.length > haystack.length)\n return(-1);\n\n // Special case for length-0 haystack, since for loop won't run\n if (haystack.length === 0) {\n return(needle.length === 0 ? 0 : -1);\n }\n\n for (var i = 0; i < haystack.length; i++) {\n if (needle[i] != haystack[i])\n return(i);\n }\n\n return(haystack.length);\n }\n\n /* Clipboard --------------------------*/\n\n function changeTooltipMessage(element, msg) {\n var tooltipOriginalTitle=element.getAttribute('data-original-title');\n element.setAttribute('data-original-title', msg);\n $(element).tooltip('show');\n element.setAttribute('data-original-title', tooltipOriginalTitle);\n }\n\n if(ClipboardJS.isSupported()) {\n $(document).ready(function() {\n var copyButton = \"\";\n\n $(\"div.sourceCode\").addClass(\"hasCopyButton\");\n\n // Insert copy buttons:\n $(copyButton).prependTo(\".hasCopyButton\");\n\n // Initialize tooltips:\n $('.btn-copy-ex').tooltip({container: 'body'});\n\n // Initialize clipboard:\n var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', {\n text: function(trigger) {\n return trigger.parentNode.textContent.replace(/\\n#>[^\\n]*/g, \"\");\n }\n });\n\n clipboardBtnCopies.on('success', function(e) {\n changeTooltipMessage(e.trigger, 'Copied!');\n e.clearSelection();\n });\n\n clipboardBtnCopies.on('error', function() {\n changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy');\n });\n });\n }\n})(window.jQuery || window.$)\n" }, { "path": "docs/pkgdown.yml", "content": "pandoc: 3.1.11\npkgdown: 2.0.7\npkgdown_sha: ~\narticles:\n intro_htmlwidgets: intro_htmlwidgets.html\n intro_inputs: intro_inputs.html\n intro_reactR: intro_reactR.html\nlast_built: 2024-09-14T13:01Z\n\n" }, { "path": "docs/reference/React.html", "content": "\nReact component builder. — React • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    React component builder.

    \n Source: R/reacttools.R\n
    React.Rd
    \n
    \n\n
    \n

    React is a syntactically-convenient way to create instances of React\ncomponents that can be sent to the browser for display. It is a list for\nwhich extract methods are defined, allowing\nobject creation syntax like React$MyComponent(x = 1) where\nMyComponent is a React component you have exposed to Shiny in\nJavaScript.

    \n
    \n\n
    \n 
    React
    \n
    \n\n
    \n

    Format

    \n

    An object of class react_component_builder of length 0.

    \n
    \n
    \n

    Details

    \n

    Internally, the component function is used to create the\ncomponent instance.

    \n
    \n\n
    \n

    Examples

    \n 
    # Create an instance of ParentComponent with two children,\n# ChildComponent and OtherChildComponent.\nReact$ParentComponent(\n  x = 1,\n  y = 2,\n  React$ChildComponent(),\n  React$OtherChildComponent()\n)\n#> <ParentComponent x=\"1\" y=\"2\">\n#>   <ChildComponent></ChildComponent>\n#>   <OtherChildComponent></OtherChildComponent>\n#> </ParentComponent>\n
    \n
    \n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/babel_transform.html", "content": "\nTransform Code with Babel — babel_transform • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Transform Code with Babel

    \n Source: R/babel.R\n
    babel_transform.Rd
    \n
    \n\n
    \n

    Helper function to use V8 with Babel so we can\navoid a JSX transformer with using reactR.

    \n
    \n\n
    \n 
    babel_transform(code = \"\")
    \n
    \n\n
    \n

    Arguments

    \n
    code
    \n

    character

    \n\n
    \n
    \n

    Value

    \n \n\n

    transformed character

    \n\n\n
    \n\n
    \n

    Examples

    \n 
    if (FALSE) {\nlibrary(reactR)\nbabel_transform('<div>react div</div>')\n}\n
    \n
    \n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/component.html", "content": "\nCreate a React component — component • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Create a React component

    \n Source: R/reacttools.R\n
    component.Rd
    \n
    \n\n
    \n

    Create a React component

    \n
    \n\n
    \n 
    component(name, varArgs = list())
    \n
    \n\n
    \n

    Arguments

    \n
    name
    \n

    Name of the React component, which must start with an upper-case\ncharacter.

    \n\n\n
    varArgs
    \n

    Attributes and children of the element to pass along to\ntag as varArgs.

    \n\n
    \n
    \n

    Value

    \n \n\n

    An htmltools tag object

    \n
    \n\n
    \n

    Examples

    \n 
    component(\"ParentComponent\",\n  list(\n    x = 1,\n    y = 2,\n    component(\"ChildComponent\"),\n    component(\"OtherChildComponent\")\n  )\n)\n#> <ParentComponent x=\"1\" y=\"2\">\n#>   <ChildComponent></ChildComponent>\n#>   <OtherChildComponent></OtherChildComponent>\n#> </ParentComponent>\n
    \n
    \n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/createReactShinyInput.html", "content": "\nCreate a React-based input — createReactShinyInput • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Create a React-based input

    \n Source: R/reacttools.R\n
    createReactShinyInput.Rd
    \n
    \n\n
    \n

    Create a React-based input

    \n
    \n\n
    \n 
    createReactShinyInput(\n  inputId,\n  class,\n  dependencies,\n  default = NULL,\n  configuration = list(),\n  container = htmltools::tags$div\n)
    \n
    \n\n
    \n

    Arguments

    \n
    inputId
    \n

    The input slot that will be used to access the value.

    \n\n\n
    class
    \n

    Space-delimited list of CSS class names that should identify\nthis input type in the browser.

    \n\n\n
    dependencies
    \n

    HTML dependencies to include in addition to those\nsupporting React. Must contain at least one dependency, that of the input's\nimplementation.

    \n\n\n
    default
    \n

    Initial value.

    \n\n\n
    configuration
    \n

    Static configuration data.

    \n\n\n
    container
    \n

    Function to generate an HTML element to contain the input.

    \n\n
    \n
    \n

    Value

    \n \n\n

    Shiny input suitable for inclusion in a UI.

    \n
    \n\n
    \n

    Examples

    \n 
    myInput <- function(inputId, default = \"\") {\n  # The value of createReactShinyInput should be returned from input constructor functions.\n  createReactShinyInput(\n    inputId,\n    \"myinput\",\n    # At least one htmlDependency must be provided -- the JavaScript implementation of the input.\n    htmlDependency(\n      name = \"my-input\",\n      version = \"1.0.0\",\n      src = \"www/mypackage/myinput\",\n      package = \"mypackage\",\n      script = \"myinput.js\"\n    ),\n    default\n  )\n}\n
    \n
    \n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/html_dependency_corejs.html", "content": "\nShim Dependency for React in RStudio Viewer — html_dependency_corejs • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Shim Dependency for React in RStudio Viewer

    \n Source: R/dependencies.R\n
    html_dependency_corejs.Rd
    \n
    \n\n
    \n

    Add this first for 'React' to work in RStudio Viewer.

    \n
    \n\n
    \n 
    html_dependency_corejs()
    \n
    \n\n
    \n

    Value

    \n \n\n

    htmlDependency

    \n\n\n
    \n\n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/html_dependency_mobx.html", "content": "\nDependencies for 'mobx' — html_dependency_mobx • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Dependencies for 'mobx'

    \n Source: R/dependencies.R\n
    html_dependency_mobx.Rd
    \n
    \n\n
    \n

    Add JavaScript 'mobx' and 'mobx-react' dependency. When using with 'react', the order\nof the dependencies is important, so please add html_dependency_react() before\nhtml_dependency_mobx().

    \n
    \n\n
    \n 
    html_dependency_mobx(react = TRUE)
    \n
    \n\n
    \n

    Arguments

    \n
    react
    \n

    logical to add react 'mobx' dependencies.

    \n\n
    \n
    \n

    Value

    \n \n\n

    htmlDependency

    \n\n\n
    \n\n
    \n

    Examples

    \n 
    if(interactive()) {\n\nlibrary(htmltools)\nlibrary(reactR)\n\nbrowsable(\n  tagList(\n    html_dependency_mobx(react = FALSE),\n    div(id=\"test\"),\n    tags$script(HTML(\n\"\n  var obs = mobx.observable({val: null})\n  mobx.autorun(function() {\n    document.querySelector('#test').innerText = obs.val\n  })\n  setInterval(\n    function() {obs.val++},\n    1000\n  )\n\"\n    ))\n  )\n)\n}\n\nif (FALSE) {\n# use with react\nlibrary(htmltools)\nlibrary(reactR)\n\nbrowsable(\n  tagList(\n    html_dependency_react(),\n    html_dependency_mobx(),\n    div(id=\"test\"),\n    tags$script(HTML(babel_transform(\n\"\n  var obs = mobx.observable({val: null})\n  var App = mobxReact.observer((props) => <div>{props.obs.val}</div>)\n\n  ReactDOM.render(<App obs = {obs}/>, document.querySelector('#test'))\n\n  setInterval(\n    function() {obs.val++},\n    1000\n  )\n\"\n    )))\n  )\n)\n}\n
    \n
    \n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/html_dependency_react.html", "content": "\nDependencies for React — html_dependency_react • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Dependencies for React

    \n Source: R/dependencies.R\n
    html_dependency_react.Rd
    \n
    \n\n
    \n

    Add JavaScript 'React' dependency. For this to work in RStudio Viewer, also include\nhtml_dependency_corejs.

    \n
    \n\n
    \n 
    html_dependency_react(offline = TRUE)
    \n
    \n\n
    \n

    Arguments

    \n
    offline
    \n

    logical to use local file dependencies. If FALSE,\nthen the dependencies use the Facebook cdn as its src.\nTo use with JSX see babel_transform.

    \n\n
    \n
    \n

    Value

    \n \n\n

    htmlDependency

    \n\n\n
    \n\n
    \n

    Examples

    \n 
    library(reactR)\nlibrary(htmltools)\n#> Warning: package 'htmltools' was built under R version 4.3.3\n\ntagList(\n  tags$script(\n  \"\n    ReactDOM.render(\n      React.createElement(\n        'h1',\n        null,\n        'Powered by React'\n      ),\n      document.body\n    )\n  \"\n  ),\n   #add core-js first to work in RStudio Viewer\n  html_dependency_corejs(),\n  html_dependency_react() #offline=FALSE for CDN\n)\n#> <script>\n#>     ReactDOM.render(\n#>       React.createElement(\n#>         'h1',\n#>         null,\n#>         'Powered by React'\n#>       ),\n#>       document.body\n#>     )\n#>   </script>\n
    \n
    \n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/html_dependency_reacttools.html", "content": "\nAdds window.reactR.exposeComponents and window.reactR.hydrate — html_dependency_reacttools • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Adds window.reactR.exposeComponents and window.reactR.hydrate

    \n Source: R/dependencies.R\n
    html_dependency_reacttools.Rd
    \n
    \n\n
    \n

    Adds window.reactR.exposeComponents and window.reactR.hydrate

    \n
    \n\n
    \n 
    html_dependency_reacttools()
    \n
    \n\n
    \n

    Value

    \n \n\n

    htmlDependency

    \n\n\n
    \n\n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/index.html", "content": "\nFunction reference • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Reference

    \n
    \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
    \n

    All functions

    \n

    \n
    \n

    babel_transform()

    \n

    Transform Code with Babel

    \n

    component()

    \n

    Create a React component

    \n

    createReactShinyInput()

    \n

    Create a React-based input

    \n

    html_dependency_corejs()

    \n

    Shim Dependency for React in RStudio Viewer

    \n

    html_dependency_mobx()

    \n

    Dependencies for 'mobx'

    \n

    html_dependency_react()

    \n

    Dependencies for React

    \n

    html_dependency_reacttools()

    \n

    Adds window.reactR.exposeComponents and window.reactR.hydrate

    \n

    React

    \n

    React component builder.

    \n

    reactMarkup()

    \n

    Prepare data that represents a single-element character vector, a React\ncomponent, or an htmltools tag for sending to the client.

    \n

    scaffoldReactShinyInput()

    \n

    Create implementation scaffolding for a React.js-based Shiny input.

    \n

    scaffoldReactWidget()

    \n

    Create implementation scaffolding for a React.js-based HTML widget

    \n\n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/reactMarkup.html", "content": "\nPrepare data that represents a single-element character vector, a React\ncomponent, or an htmltools tag for sending to the client. — reactMarkup • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Prepare data that represents a single-element character vector, a React\ncomponent, or an htmltools tag for sending to the client.

    \n Source: R/reacttools.R\n
    reactMarkup.Rd
    \n
    \n\n
    \n

    Tag lists as returned by htmltools tagList are not currently\nsupported.

    \n
    \n\n
    \n 
    reactMarkup(tag)
    \n
    \n\n
    \n

    Arguments

    \n
    tag
    \n

    character vector or React component or\ntag

    \n\n
    \n
    \n

    Value

    \n \n\n

    A reactR markup object suitable for being passed to

    \n

    \n

    createWidget as widget instance data.

    \n
    \n\n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/scaffoldReactShinyInput.html", "content": "\nCreate implementation scaffolding for a React.js-based Shiny input. — scaffoldReactShinyInput • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Create implementation scaffolding for a React.js-based Shiny input.

    \n Source: R/scaffold_input.R\n
    scaffoldReactShinyInput.Rd
    \n
    \n\n
    \n

    Add the minimal code required to implement a React.js-based Shiny input to an\nR package.

    \n
    \n\n
    \n 
    scaffoldReactShinyInput(name, npmPkgs = NULL, edit = interactive())
    \n
    \n\n
    \n

    Arguments

    \n
    name
    \n

    Name of input

    \n\n\n
    npmPkgs
    \n

    Optional NPM packages upon which\nthis input is based which will be used to populate package.json.\nShould be a named list of names to\nversions.

    \n\n\n
    edit
    \n

    Automatically open the input's source files after creating the\nscaffolding.

    \n\n
    \n
    \n

    Note

    \n

    This function must be executed from the root directory of the package\n you wish to add the input to.

    \n
    \n\n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/reference/scaffoldReactWidget.html", "content": "\nCreate implementation scaffolding for a React.js-based HTML widget — scaffoldReactWidget • reactR\n \n\n
    \n
    \n
    \n
    \n \n \n reactR\n 0.6.1\n \n
    \n\n \n
    \n
    \n\n \n\n
    \n
    \n
    \n

    Create implementation scaffolding for a React.js-based HTML widget

    \n Source: R/scaffold_widget.R\n
    scaffoldReactWidget.Rd
    \n
    \n\n
    \n

    Add the minimal code required to implement a React.js-based HTML widget to an\nR package.

    \n
    \n\n
    \n 
    scaffoldReactWidget(name, npmPkgs = NULL, edit = interactive())
    \n
    \n\n
    \n

    Arguments

    \n
    name
    \n

    Name of widget

    \n\n\n
    npmPkgs
    \n

    Optional NPM packages upon which\nthis widget is based which will be used to populate package.json.\nShould be a named list of names to\nversions.

    \n\n\n
    edit
    \n

    Automatically open the widget's JavaScript source file after\ncreating the scaffolding.

    \n\n
    \n
    \n

    Note

    \n

    This function must be executed from the root directory of the package\n you wish to add the widget to.

    \n
    \n\n
    \n
    \n
    \n
    \n\n\n
    \n

    Developed by Facebook Inc, Michel Weststrate, Kent Russell, Alan Dipert, Greg Lin.

    \n
    \n\n
    \n

    Site built with pkgdown 2.0.7.

    \n
    \n\n
    \n\n \n\n\n \n\n \n\n" }, { "path": "docs/sitemap.xml", "content": "\n\n \n /404.html\n \n \n /articles/index.html\n \n \n /articles/intro_htmlwidgets.html\n \n \n /articles/intro_inputs.html\n \n \n /articles/intro_reactR.html\n \n \n /authors.html\n \n \n /CONDUCT.html\n \n \n /index.html\n \n \n /LICENSE-text.html\n \n \n /news/index.html\n \n \n /reference/babel_transform.html\n \n \n /reference/component.html\n \n \n /reference/createReactShinyInput.html\n \n \n /reference/html_dependency_corejs.html\n \n \n /reference/html_dependency_mobx.html\n \n \n /reference/html_dependency_react.html\n \n \n /reference/html_dependency_reacttools.html\n \n \n /reference/index.html\n \n \n /reference/React.html\n \n \n /reference/reactMarkup.html\n \n \n /reference/scaffoldReactShinyInput.html\n \n \n /reference/scaffoldReactWidget.html\n \n\n" }, { "path": "inst/examples/antd.R", "content": "library(htmltools)\nlibrary(reactR)\nlibrary(pipeR)\n\nantd <- htmlDependency(\n name = \"antd\",\n version = \"2.13.10\",\n src = c(href=\"https://unpkg.com/antd@2.13.10/dist\"),\n script = \"antd.min.js\",\n stylesheet = \"antd.min.css\"\n)\n\n\n### menu ####\ntl <- tagList(\n tags$div(id=\"app\",style=\"width:25%;\"),\n tags$script(HTML(babel_transform('\n var menu = \n \n Navigation One\n \n \n Navigation Two\n \n \n\n ReactDOM.render(menu, document.querySelector(\"#app\"))\n ')))\n)\n\nbrowsable(\n tagList(\n tl,\n html_dependency_react(),\n antd\n )\n)\n\n\n### steps ####\nsteps <- tag(\n \"antd.Steps\",\n list(\n current=noquote(\"{1}\"),\n tag(\"antd.Steps.Step\", list(title=\"Finished\", description=\"This is a description.\" )),\n tag(\"antd.Steps.Step\", list(title=\"In Progress\",description=\"This is a description.\" )),\n tag(\"antd.Steps.Step\", list(title=\"Waiting\", description=\"This is a description.\" ))\n )\n)\n\ntagList(\n tags$div(id=\"stepapp\"),\n steps %>>%\n {\n sprintf(\n\"\nconst steps = %s;\nReactDOM.render(steps, document.querySelector('#stepapp'));\n\",\n .\n\n )\n } %>>%\n babel_transform() %>>%\n HTML %>>%\n tags$script()\n) %>>%\n attachDependencies(\n list(\n html_dependency_react(),\n antd\n )\n ) %>>%\n browsable()\n\n\n### steps with button ####\nsteps_button <- list(\n list(\n title= 'Data',\n content= 'Raw Data'\n ),\n list(\n title= 'Model',\n content= 'Code for Model'\n ),\n list(\n title= 'Plot',\n content= 'Beautiful Plot'\n )\n) %>>% jsonlite::toJSON(auto_unbox=TRUE)\n\ncontent_data <- tags$pre(\n HTML(paste0(\n capture.output(str(iris,max.level=1)),\n collapse=\"
    \"\n ))\n)\n\ncontent_model <- tags$pre(\"lm(Petal.Width~Petal.Length, data=iris)\")\n\ncontent_plot <- HTML(\n svglite::htmlSVG({plot(lm(Petal.Length~Petal.Width,data=iris),which=1)},standalone=FALSE)\n)\n\ntagList(\n tags$div(id=\"stepapp\", style=\"width:30%;\"),\n steps_button %>>%\n {\n sprintf(\n'\nconst steps = %s;\n\nsteps[0].content = %s;\nsteps[1].content = %s;\nsteps[2].content = \n\nclass App extends React.Component {\n constructor(props) {\n super(props);\n this.state = {\n current: 0,\n };\n }\n next() {\n const current = this.state.current + 1;\n this.setState({ current });\n }\n prev() {\n const current = this.state.current - 1;\n this.setState({ current });\n }\n render() {\n const { current } = this.state;\n return (\n
    \n \n {steps.map(item => )}\n \n
    \n {steps[this.state.current].content}\n
    \n
    \n {\n this.state.current < steps.length - 1\n &&\n this.next()}>Next\n }\n {\n this.state.current === steps.length - 1\n &&\n message.success(\"Processing complete!\")}>Done\n }\n {\n this.state.current > 0\n &&\n this.prev()}>\n Previous\n \n }\n
    \n
    \n );\n }\n}\n\nReactDOM.render(, document.querySelector(\"#stepapp\"));\n ',\n .,\n content_data,\n content_model,\n base64enc::dataURI(rsvg::rsvg_png(charToRaw(content_plot)),mime=\"image/png\")\n )\n } %>>%\n babel_transform() %>>%\n HTML %>>%\n tags$script()\n) %>>%\n attachDependencies(\n list(\n html_dependency_react(offline=FALSE),\n antd\n )\n ) %>>%\n browsable()\n" }, { "path": "inst/examples/office-fabric.R", "content": "library(htmltools)\nlibrary(reactR)\n\nfabric <- htmlDependency(\n name = \"office-fabric-ui-react\",\n version = \"7.121.12\",\n src = c(href=\"https://unpkg.com/office-ui-fabric-react@7.121.12/dist/\"),\n script = \"office-ui-fabric-react.min.js\",\n stylesheet = \"css/fabric.min.css\"\n)\n\nbrowsable(\n tagList(\n html_dependency_react(),\n fabric\n )\n)\n\nbrowsable(\n tagList(\n html_dependency_react(),\n fabric,\n tags$div(id = \"app-button\"),\n tags$script(HTML(babel_transform(\n\"\nlet btn =
    \n Command button\n \n Create account\n \n
    \n\nReactDOM.render(btn, document.querySelector('#app-button'));\n\"\n )))\n )\n)\n\n\nbrowsable(\n tagList(\n html_dependency_react(),\n fabric,\n tags$div(id=\"pivot-example\"),\n tags$script(HTML(babel_transform(\n\"\nclass PivotBasicExample extends React.Component {\n render() {\n return (\n
    \n \n \n Pivot #1\n \n \n Pivot #2\n \n \n Pivot #3\n \n \n
    \n );\n }\n}\nReactDOM.render(, document.querySelector('#pivot-example'));\n\"\n )))\n )\n)\n" }, { "path": "inst/templates/input_app.R.txt", "content": "library(shiny)\nlibrary(${package})\n\nui <- fluidPage(\n titlePanel(\"reactR Input Example\"),\n ${name}Input(\"textInput\"),\n textOutput(\"textOutput\")\n)\n\nserver <- function(input, output, session) {\n output$textOutput <- renderText({\n sprintf(\"You entered: %s\", input$textInput)\n })\n}\n\nshinyApp(ui, server)\n" }, { "path": "inst/templates/input_js.txt", "content": "import { reactShinyInput } from 'reactR';\n\nconst TextInput = ({ configuration, value, setValue }) => {\n return setValue(e.target.value)}/>;\n};\n\nreactShinyInput('.${name}', '${package}.${name}', TextInput);\n" }, { "path": "inst/templates/input_r.txt", "content": "#' \n#'\n#' \n#'\n#' @importFrom reactR createReactShinyInput\n#' @importFrom htmltools htmlDependency tags\n#'\n#' @export\n${name}Input <- function(inputId, default = \"\") {\n reactR::createReactShinyInput(\n inputId,\n \"${name}\",\n htmltools::htmlDependency(\n name = \"${name}-input\",\n version = \"1.0.0\",\n src = \"www/${package}/${name}\",\n package = \"${package}\",\n script = \"${name}.js\"\n ),\n default,\n list(),\n htmltools::tags$span\n )\n}\n\n#' \n#'\n#' \n#'\n#' @export\nupdate${capName}Input <- function(session, inputId, value, configuration = NULL) {\n message <- list(value = value)\n if (!is.null(configuration)) message$configuration <- configuration\n session$sendInputMessage(inputId, message);\n}\n" }, { "path": "inst/templates/package.json.txt", "content": "{\n \"private\": true,\n \"dependencies\": {\n ${npmPkgs}\n },\n \"devDependencies\": {\n \"webpack\": \"^4.27.1\",\n \"webpack-cli\": \"^3.1.2\",\n \"@babel/core\": \"^7.2.0\",\n \"babel-loader\": \"^8.0.4\",\n \"@babel/preset-env\": \"^7.2.0\",\n \"@babel/preset-react\": \"^7.0.0\",\n \"css-loader\": \"^5.0.1\",\n \"style-loader\": \"^2.0.0\"\n },\n \"scripts\": {\n \"watch\": \"webpack --watch\",\n \"build\": \"webpack\"\n }\n}\n" }, { "path": "inst/templates/webpack.config.js.txt", "content": "var path = require('path');\n\nmodule.exports = {\n entry: path.join(__dirname, 'srcjs', '${name}.jsx'),\n output: {\n path: path.join(__dirname, '${outputPath}'),\n filename: '${name}.js'\n },\n module: {\n rules: [\n {\n test: /\\.jsx?$/,\n loader: 'babel-loader',\n options: {\n presets: ['@babel/preset-env', '@babel/preset-react']\n }\n },\n // For CSS so that import \"path/style.css\"; works\n {\n test: /\\.css$/,\n use: ['style-loader', 'css-loader']\n }\n ]\n },\n externals: {\n 'react': 'window.React',\n 'react-dom': 'window.ReactDOM',\n 'reactR': 'window.reactR'\n },\n stats: {\n colors: true\n },\n devtool: 'source-map'\n};\n" }, { "path": "inst/templates/widget_app.R.txt", "content": "library(shiny)\nlibrary(${name})\n\nui <- fluidPage(\n titlePanel(\"reactR HTMLWidget Example\"),\n ${name}Output('widgetOutput')\n)\n\nserver <- function(input, output, session) {\n output$widgetOutput <- render${capName}(\n ${name}(\"Hello world!\")\n )\n}\n\nshinyApp(ui, server)\n" }, { "path": "inst/templates/widget_js.txt", "content": "import { reactWidget } from 'reactR';\n\nreactWidget('${name}', 'output', {}, {});\n" }, { "path": "inst/templates/widget_r.txt", "content": "#' \n#'\n#' \n#'\n#' @import htmlwidgets\n#'\n#' @export\n${name} <- function(message, width = NULL, height = NULL, elementId = NULL) {\n\n # describe a React component to send to the browser for rendering.\n component <- reactR::reactMarkup(htmltools::tag(\"div\", list(message)))\n\n # create widget\n htmlwidgets::createWidget(\n name = '${name}',\n component,\n width = width,\n height = height,\n package = '${package}',\n elementId = elementId\n )\n}\n\n#' Called by HTMLWidgets to produce the widget's root element.\n#' @noRd\nwidget_html.${name} <- function(id, style, class, ...) {\n htmltools::tagList(\n # Necessary for RStudio viewer version < 1.2\n reactR::html_dependency_corejs(),\n reactR::html_dependency_react(),\n reactR::html_dependency_reacttools(),\n htmltools::tags$div(id = id, class = class, style = style)\n )\n}\n\n#' Shiny bindings for ${name}\n#'\n#' Output and render functions for using ${name} within Shiny\n#' applications and interactive Rmd documents.\n#'\n#' @param outputId output variable to read from\n#' @param width,height Must be a valid CSS unit (like \\code{'100\\%'},\n#' \\code{'400px'}, \\code{'auto'}) or a number, which will be coerced to a\n#' string and have \\code{'px'} appended.\n#' @param expr An expression that generates a ${name}\n#' @param env The environment in which to evaluate \\code{expr}.\n#' @param quoted Is \\code{expr} a quoted expression (with \\code{quote()})? This\n#' is useful if you want to save an expression in a variable.\n#'\n#' @name ${name}-shiny\n#'\n#' @export\n${name}Output <- function(outputId, width = '100%', height = '400px'){\n htmlwidgets::shinyWidgetOutput(outputId, '${name}', width, height, package = '${package}')\n}\n\n#' @rdname ${name}-shiny\n#' @export\nrender${capName} <- function(expr, env = parent.frame(), quoted = FALSE) {\n if (!quoted) { expr <- substitute(expr) } # force quoted\n htmlwidgets::shinyRenderWidget(expr, ${name}Output, env, quoted = TRUE)\n}\n" }, { "path": "inst/templates/widget_yaml.txt", "content": "# (uncomment to add a dependency)\n# dependencies:\n# - name:\n# version:\n# src:\n# script:\n# stylesheet:\n\n" }, { "path": "inst/www/core-js/LICENSE", "content": "Copyright (c) 2014-2017 Denis Pushkarev\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n" }, { "path": "inst/www/core-js/package.json", "content": "{\n \"devDependencies\": {\n \"@babel/cli\": \"^7.7.7\",\n \"@babel/core\": \"^7.7.7\",\n \"@babel/plugin-proposal-nullish-coalescing-operator\": \"^7.7.4\",\n \"@babel/plugin-proposal-optional-catch-binding\": \"^7.7.4\",\n \"@babel/plugin-proposal-optional-chaining\": \"^7.7.5\",\n \"@babel/plugin-transform-arrow-functions\": \"^7.7.4\",\n \"@babel/plugin-transform-block-scoped-functions\": \"^7.7.4\",\n \"@babel/plugin-transform-block-scoping\": \"^7.7.4\",\n \"@babel/plugin-transform-classes\": \"^7.7.4\",\n \"@babel/plugin-transform-computed-properties\": \"^7.7.4\",\n \"@babel/plugin-transform-destructuring\": \"^7.7.4\",\n \"@babel/plugin-transform-exponentiation-operator\": \"^7.7.4\",\n \"@babel/plugin-transform-literals\": \"^7.7.4\",\n \"@babel/plugin-transform-member-expression-literals\": \"^7.7.4\",\n \"@babel/plugin-transform-parameters\": \"^7.7.7\",\n \"@babel/plugin-transform-property-literals\": \"^7.7.4\",\n \"@babel/plugin-transform-shorthand-properties\": \"^7.7.4\",\n \"@babel/plugin-transform-spread\": \"^7.7.4\",\n \"@babel/plugin-transform-template-literals\": \"^7.7.4\",\n \"babel-loader\": \"^8.0.6\",\n \"babel-plugin-transform-es2015-modules-simple-commonjs\": \"~0.3.0\",\n \"babel-plugin-transform-for-of-as-array\": \"^1.1.1\",\n \"es-observable\": \"git+https://github.com/tc39/proposal-observable.git#bf4d87144b6189e793593868e3c022eb51a7d292\",\n \"eslint\": \"^6.8.0\",\n \"eslint-import-resolver-webpack\": \"^0.12.0\",\n \"eslint-plugin-import\": \"^2.19.1\",\n \"eslint-plugin-node\": \"^10.0.0\",\n \"eslint-plugin-optimize-regex\": \"^1.1.7\",\n \"eslint-plugin-qunit\": \"^4.0.0\",\n \"eslint-plugin-sonarjs\": \"^0.5.0\",\n \"eslint-plugin-unicorn\": \"^15.0.0\",\n \"grunt\": \"^1.0.4\",\n \"grunt-cli\": \"^1.3.2\",\n \"grunt-contrib-clean\": \"^2.0.0\",\n \"grunt-contrib-copy\": \"^1.0.0\",\n \"grunt-contrib-uglify\": \"^4.0.1\",\n \"grunt-karma\": \"^3.0.2\",\n \"grunt-webpack\": \"^3.1.3\",\n \"karma\": \"^4.4.1\",\n \"karma-chrome-launcher\": \"^3.1.0\",\n \"karma-phantomjs-launcher\": \"~1.0.4\",\n \"karma-qunit\": \"^4.0.0\",\n \"lerna\": \"^3.19.0\",\n \"moon-unit\": \"^0.2.2\",\n \"phantomjs-prebuilt\": \"~2.1.16\",\n \"promises-aplus-tests\": \"^2.1.2\",\n \"puppeteer\": \"~2.0.0\",\n \"qunit\": \"~2.9.3\",\n \"webpack\": \"^4.41.4\"\n },\n \"license\": \"MIT\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/zloirock/core-js.git\"\n },\n \"scripts\": {\n \"bootstrap\": \"lerna bootstrap --no-ci\",\n \"build\": \"grunt clean copy && npm run bootstrap && npm run build-compat && grunt bundle uglify\",\n \"build-compat\": \"npm run build-compat-data && npm run build-compat-entries && npm run build-compat-modules-by-versions\",\n \"build-compat-data\": \"node packages/core-js-compat/src/build-data\",\n \"build-compat-entries\": \"node packages/core-js-compat/src/build-entries\",\n \"build-compat-modules-by-versions\": \"node packages/core-js-compat/src/build-modules-by-versions\",\n \"lint\": \"grunt clean copy && npm run bootstrap && npm run build-compat && eslint ./\",\n \"unit-tests\": \"grunt clean copy && npm run bootstrap && npm run build-compat && grunt bundle webpack:helpers webpack:tests karma:tests\",\n \"unit-tests-pure\": \"grunt clean copy && npm run build-compat && grunt webpack:helpers webpack:pure karma:pure\",\n \"bundle-promises-tests\": \"grunt webpack:promises-aplus-tests\",\n \"promises-tests\": \"promises-aplus-tests tests/promises-aplus/adapter --timeout 1000\",\n \"observables-tests\": \"babel node_modules/es-observable/test/ -d tests/bundles/observables-tests/ && node tests/observables/adapter && node tests/observables/adapter-pure\",\n \"commonjs-tests\": \"node tests/commonjs\",\n \"commonjs-entries-content\": \"node tests/commonjs-entries-content\",\n \"targets-parser-tests\": \"node tests/targets-parser\",\n \"test\": \"grunt clean copy && npm run bootstrap && npm run build-compat && eslint ./ && grunt webpack:helpers webpack:tests bundle uglify karma:tests webpack:helpers webpack:pure karma:pure && npm run promises-tests && npm run observables-tests && npm run commonjs-tests && npm run commonjs-entries-content && npm run targets-parser-tests\"\n },\n \"engines\": {\n \"node\": \">=8.9.0\"\n }\n}\n" }, { "path": "inst/www/mobx/LICENSE", "content": "The MIT License (MIT)\n\nCopyright (c) 2015 Michel Weststrate\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "inst/www/mobx/mobx-react-lite.js", "content": "(function (global, factory) {\n typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('mobx'), require('react')) :\n typeof define === 'function' && define.amd ? define(['exports', 'mobx', 'react'], factory) :\n (global = global || self, factory(global.mobxReactLite = {}, global.mobx, global.React));\n}(this, function (exports, mobx, React) { 'use strict';\n\n var React__default = 'default' in React ? React['default'] : React;\n\n if (!React.useState) {\n throw new Error(\"mobx-react-lite requires React with Hooks support\");\n }\n if (!mobx.spy) {\n throw new Error(\"mobx-react-lite requires mobx at least version 4 to be available\");\n }\n\n function useObservable(initialValue) {\n var observableRef = React.useRef(null);\n if (!observableRef.current) {\n observableRef.current = mobx.observable(initialValue);\n }\n return observableRef.current;\n }\n\n function useComputed(func, inputs) {\n if (inputs === void 0) { inputs = []; }\n var computed = React.useMemo(function () { return mobx.computed(func); }, inputs);\n return computed.get();\n }\n\n var doNothingDisposer = function () {\n // empty\n };\n /**\n * Adds an observable effect (reaction, autorun, or anything else that returns a disposer) that will be registered upon component creation and disposed upon unmounting.\n * Returns the generated disposer for early disposal.\n *\n * @export\n * @template D\n * @param {() => D} disposerGenerator A function that returns the disposer of the wanted effect.\n * @param {ReadonlyArray} [inputs=[]] If you want the effect to be automatically re-created when some variable(s) are changed then pass them in this array.\n * @returns {D}\n */\n function useDisposable(disposerGenerator, inputs) {\n if (inputs === void 0) { inputs = []; }\n var disposerRef = React.useRef(null);\n var earlyDisposedRef = React.useRef(false);\n React.useEffect(function () {\n return lazyCreateDisposer(false);\n }, inputs);\n function lazyCreateDisposer(earlyDisposal) {\n // ensure that we won't create a new disposer if it was early disposed\n if (earlyDisposedRef.current) {\n return doNothingDisposer;\n }\n if (!disposerRef.current) {\n var newDisposer = disposerGenerator();\n if (typeof newDisposer !== \"function\") {\n var error = new Error(\"generated disposer must be a function\");\n {\n // tslint:disable-next-line:no-console\n console.error(error);\n return doNothingDisposer;\n }\n }\n disposerRef.current = newDisposer;\n }\n return function () {\n if (disposerRef.current) {\n disposerRef.current();\n disposerRef.current = null;\n }\n if (earlyDisposal) {\n earlyDisposedRef.current = true;\n }\n };\n }\n return lazyCreateDisposer(true);\n }\n\n var globalIsUsingStaticRendering = false;\n function useStaticRendering(enable) {\n globalIsUsingStaticRendering = enable;\n }\n function isUsingStaticRendering() {\n return globalIsUsingStaticRendering;\n }\n\n /*! *****************************************************************************\n Copyright (c) Microsoft Corporation. All rights reserved.\n Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use\n this file except in compliance with the License. You may obtain a copy of the\n License at http://www.apache.org/licenses/LICENSE-2.0\n\n THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED\n WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,\n MERCHANTABLITY OR NON-INFRINGEMENT.\n\n See the Apache Version 2.0 License for specific language governing permissions\n and limitations under the License.\n ***************************************************************************** */\n\n var __assign = function() {\n __assign = Object.assign || function __assign(t) {\n for (var s, i = 1, n = arguments.length; i < n; i++) {\n s = arguments[i];\n for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\n }\n return t;\n };\n return __assign.apply(this, arguments);\n };\n\n function __read(o, n) {\n var m = typeof Symbol === \"function\" && o[Symbol.iterator];\n if (!m) return o;\n var i = m.call(o), r, ar = [], e;\n try {\n while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\n }\n catch (error) { e = { error: error }; }\n finally {\n try {\n if (r && !r.done && (m = i[\"return\"])) m.call(i);\n }\n finally { if (e) throw e.error; }\n }\n return ar;\n }\n\n function printDebugValue(v) {\n if (!v.current) {\n return \"\";\n }\n return mobx.getDependencyTree(v.current);\n }\n\n var EMPTY_ARRAY = [];\n function useUnmount(fn) {\n React.useEffect(function () { return fn; }, EMPTY_ARRAY);\n }\n function useForceUpdate() {\n var _a = __read(React.useState(0), 2), setTick = _a[1];\n var update = React.useCallback(function () {\n setTick(function (tick) { return tick + 1; });\n }, []);\n return update;\n }\n function isPlainObject(value) {\n if (!value || typeof value !== \"object\") {\n return false;\n }\n var proto = Object.getPrototypeOf(value);\n return !proto || proto === Object.prototype;\n }\n\n var EMPTY_OBJECT = {};\n function useObserver(fn, baseComponentName, options) {\n if (baseComponentName === void 0) { baseComponentName = \"observed\"; }\n if (options === void 0) { options = EMPTY_OBJECT; }\n if (isUsingStaticRendering()) {\n return fn();\n }\n var wantedForceUpdateHook = options.useForceUpdate || useForceUpdate;\n var forceUpdate = wantedForceUpdateHook();\n var reaction = React.useRef(null);\n if (!reaction.current) {\n reaction.current = new mobx.Reaction(\"observer(\" + baseComponentName + \")\", function () {\n forceUpdate();\n });\n }\n var dispose = function () {\n if (reaction.current && !reaction.current.isDisposed) {\n reaction.current.dispose();\n }\n };\n React.useDebugValue(reaction, printDebugValue);\n useUnmount(function () {\n dispose();\n });\n // render the original component, but have the\n // reaction track the observables, so that rendering\n // can be invalidated (see above) once a dependency changes\n var rendering;\n var exception;\n reaction.current.track(function () {\n try {\n rendering = fn();\n }\n catch (e) {\n exception = e;\n }\n });\n if (exception) {\n dispose();\n throw exception; // re-throw any exceptions catched during rendering\n }\n return rendering;\n }\n\n // n.b. base case is not used for actual typings or exported in the typing files\n function observer(baseComponent, options) {\n // The working of observer is explained step by step in this talk: https://www.youtube.com/watch?v=cPF4iBedoF0&feature=youtu.be&t=1307\n if (isUsingStaticRendering()) {\n return baseComponent;\n }\n var realOptions = __assign({ forwardRef: false }, options);\n var baseComponentName = baseComponent.displayName || baseComponent.name;\n var wrappedComponent = function (props, ref) {\n return useObserver(function () { return baseComponent(props, ref); }, baseComponentName);\n };\n wrappedComponent.displayName = baseComponentName;\n // memo; we are not intested in deep updates\n // in props; we assume that if deep objects are changed,\n // this is in observables, which would have been tracked anyway\n var memoComponent;\n if (realOptions.forwardRef) {\n // we have to use forwardRef here because:\n // 1. it cannot go before memo, only after it\n // 2. forwardRef converts the function into an actual component, so we can't let the baseComponent do it\n // since it wouldn't be a callable function anymore\n memoComponent = React.memo(React.forwardRef(wrappedComponent));\n }\n else {\n memoComponent = React.memo(wrappedComponent);\n }\n copyStaticProperties(baseComponent, memoComponent);\n memoComponent.displayName = baseComponentName;\n return memoComponent;\n }\n // based on https://github.com/mridgway/hoist-non-react-statics/blob/master/src/index.js\n var hoistBlackList = {\n $$typeof: true,\n render: true,\n compare: true,\n type: true\n };\n function copyStaticProperties(base, target) {\n Object.keys(base).forEach(function (key) {\n if (base.hasOwnProperty(key) && !hoistBlackList[key]) {\n Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(base, key));\n }\n });\n }\n\n function ObserverComponent(_a) {\n var children = _a.children, render = _a.render;\n var component = children || render;\n if (typeof component !== \"function\") {\n return null;\n }\n return useObserver(component);\n }\n ObserverComponent.propTypes = {\n children: ObserverPropsCheck,\n render: ObserverPropsCheck\n };\n ObserverComponent.displayName = \"Observer\";\n function ObserverPropsCheck(props, key, componentName, location, propFullName) {\n var extraKey = key === \"children\" ? \"render\" : \"children\";\n var hasProp = typeof props[key] === \"function\";\n var hasExtraProp = typeof props[extraKey] === \"function\";\n if (hasProp && hasExtraProp) {\n return new Error(\"MobX Observer: Do not use children and render in the same time in`\" + componentName);\n }\n if (hasProp || hasExtraProp) {\n return null;\n }\n return new Error(\"Invalid prop `\" +\n propFullName +\n \"` of type `\" +\n typeof props[key] +\n \"` supplied to\" +\n \" `\" +\n componentName +\n \"`, expected `function`.\");\n }\n\n function useAsObservableSourceInternal(current, usedByLocalStore) {\n if (usedByLocalStore && current === undefined) {\n return undefined;\n }\n var _a = __read(React__default.useState(function () { return mobx.observable(current, {}, { deep: false }); }), 1), res = _a[0];\n mobx.runInAction(function () {\n Object.assign(res, current);\n });\n return res;\n }\n function useAsObservableSource(current) {\n return useAsObservableSourceInternal(current, false);\n }\n\n function useLocalStore(initializer, current) {\n var source = useAsObservableSourceInternal(current, true);\n return React__default.useState(function () {\n var local = mobx.observable(initializer(source));\n if (isPlainObject(local)) {\n mobx.runInAction(function () {\n Object.keys(local).forEach(function (key) {\n var value = local[key];\n if (typeof value === \"function\") {\n local[key] = wrapInTransaction(value, local);\n }\n });\n });\n }\n return local;\n })[0];\n }\n // tslint:disable-next-line: ban-types\n function wrapInTransaction(fn, context) {\n return function () {\n var args = [];\n for (var _i = 0; _i < arguments.length; _i++) {\n args[_i] = arguments[_i];\n }\n return mobx.transaction(function () { return fn.apply(context, args); });\n };\n }\n\n exports.Observer = ObserverComponent;\n exports.isUsingStaticRendering = isUsingStaticRendering;\n exports.observer = observer;\n exports.useAsObservableSource = useAsObservableSource;\n exports.useComputed = useComputed;\n exports.useDisposable = useDisposable;\n exports.useForceUpdate = useForceUpdate;\n exports.useLocalStore = useLocalStore;\n exports.useObservable = useObservable;\n exports.useObserver = useObserver;\n exports.useStaticRendering = useStaticRendering;\n\n Object.defineProperty(exports, '__esModule', { value: true });\n\n}));\n" }, { "path": "inst/www/mobx/mobx-react.umd.js", "content": "!function(e,r){\"object\"==typeof exports&&\"undefined\"!=typeof module?r(exports,require(\"react-dom\"),require(\"mobx-react-lite\"),require(\"react\"),require(\"mobx\")):\"function\"==typeof define&&define.amd?define([\"exports\",\"react-dom\",\"mobx-react-lite\",\"react\",\"mobx\"],r):r(e.mobxReact={},e.ReactDOM,e.mobxReactLite,e.React,e.mobx)}(this,function(e,r,t,n,o){var i=\"default\"in n?n.default:n,a=0,c={};function s(e){return c[e]||(c[e]=function(e){if(\"function\"==typeof Symbol)return Symbol(e);var r=\"__$mobx-react \"+e+\" (\"+a+\")\";return a++,r}(e)),c[e]}function u(e,r){if(f(e,r))return!0;if(\"object\"!=typeof e||null===e||\"object\"!=typeof r||null===r)return!1;var t=Object.keys(e),n=Object.keys(r);if(t.length!==n.length)return!1;for(var o=0;o0;)n[o]=arguments[o+2];r.locks++;try{var i;return null!=e&&(i=e.apply(this,n)),i}finally{r.locks--,0===r.locks&&r.methods.forEach(function(e){e.apply(t,n)})}}function h(e,r){return function(){for(var t=[],n=arguments.length;n--;)t[n]=arguments[n];y.call.apply(y,[this,e,r].concat(t))}}function v(e,r,t){var n=function(e,r){var t=e[d]=e[d]||{},n=t[r]=t[r]||{};return n.locks=n.locks||0,n.methods=n.methods||[],n}(e,r);n.methods.indexOf(t)<0&&n.methods.push(t);var o=Object.getOwnPropertyDescriptor(e,r);if(!o||!o[b]){var i=function e(r,t,n,o,i){var a,c=h(i,o);return(a={})[b]=!0,a.get=function(){return c},a.set=function(i){if(this===r)c=h(i,o);else{var a=e(this,t,n,o,i);Object.defineProperty(this,t,a)}},a.configurable=!0,a.enumerable=n,a}(e,r,o?o.enumerable:void 0,n,e[r]);Object.defineProperty(e,r,i)}}var m=o.$mobx||\"$mobx\",g=s(\"isUnmounted\"),O=s(\"skipRender\"),w=s(\"isForcingUpdate\");function j(e,r){return t.isUsingStaticRendering()&&console.warn(\"[mobx-react] It seems that a re-rendering of a React component is triggered while in static (server-side) mode. Please make sure components are rendered only once server-side.\"),this.state!==r||!u(this.props,e)}function x(e,r){var t=s(\"reactProp_\"+r+\"_valueHolder\"),n=s(\"reactProp_\"+r+\"_atomHolder\");function i(){return this[n]||l(this,n,o.createAtom(\"reactive \"+r)),this[n]}Object.defineProperty(e,r,{configurable:!0,enumerable:!0,get:function(){return i.call(this).reportObserved(),this[t]},set:function(e){this[w]||u(this[t],e)?l(this,t,e):(l(this,t,e),l(this,O,!0),i.call(this).reportChanged(),l(this,O,!1))}})}var P=\"function\"==typeof n.forwardRef&&n.forwardRef(function(e,r){}).$$typeof;function R(e){if(!0===e.isMobxInjector&&console.warn(\"Mobx observer: You are trying to use 'observer' on a component that already has 'inject'. Please apply 'observer' before applying 'inject'\"),P&&e.$$typeof===P){var r=e.render;if(\"function\"!=typeof r)throw new Error(\"render property of ForwardRef was not a function\");return n.forwardRef(function(){var e=arguments;return i.createElement(t.Observer,null,function(){return r.apply(void 0,e)})})}return\"function\"!=typeof e||e.prototype&&e.prototype.render||e.isReactClass||n.Component.isPrototypeOf(e)?function(e){var r=e.prototype;if(r.componentWillReact)throw new Error(\"The componentWillReact life-cycle event is no longer supported\");if(e.__proto__!==n.PureComponent)if(r.shouldComponentUpdate){if(r.shouldComponentUpdate!==j)throw new Error(\"It is not allowed to use shouldComponentUpdate in observer based components.\")}else r.shouldComponentUpdate=j;x(r,\"props\"),x(r,\"state\");var i=r.render;return r.render=function(){return function(e){var r=this;if(!0===t.isUsingStaticRendering())return e.call(this);l(this,O,!1),l(this,w,!1);var i=this.displayName||this.name||this.constructor&&(this.constructor.displayName||this.constructor.name)||\"\",a=e.bind(this),c=!1,s=new o.Reaction(i+\".render()\",function(){if(!c&&(c=!0,!0!==r[g])){var e=!0;try{l(r,w,!0),r[O]||n.Component.prototype.forceUpdate.call(r),e=!1}finally{l(r,w,!1),e&&s.dispose()}}});function u(){c=!1;var e=void 0,r=void 0;if(s.track(function(){try{r=o._allowStateChanges(!1,a)}catch(r){e=r}}),e)throw e;return r}return s.reactComponent=this,u[m]=s,this.render=u,u.call(this)}.call(this,i)},v(r,\"componentWillUnmount\",function(){!0!==t.isUsingStaticRendering()&&(this.render[m]&&this.render[m].dispose(),this[g]=!0)}),e}(e):t.observer(e)}var C={children:!0,key:!0,ref:!0},E=n.createContext({}),S=function(e){function r(r,t){e.call(this,r,t),this.state=Object.assign({},t,U(r))}return e&&(r.__proto__=e),(r.prototype=Object.create(e&&e.prototype)).constructor=r,r.prototype.render=function(){return n.createElement(E.Provider,{value:this.state},n.Children.only(this.props.children))},r.getDerivedStateFromProps=function(e,r){if(\"production\"!==process.env.NODE_ENV&&!u(r,Object.assign({},r,U(e))))throw new Error(\"MobX Provider: The set of provided stores has changed. Please avoid changing stores as the change might not propagate to all children\");return r},r}(n.Component);function U(e){var r={};if(!e)return r;for(var t in e)_(t)&&(r[t]=e[t]);return r}function _(e){return!C[e]&&\"suppressChangedStoreWarning\"!==e}function k(e,r,t,o){var a=function(e,r){var t=e.displayName||e.name||e.constructor&&e.constructor.name||\"Component\";return r?\"inject-with-\"+r+\"(\"+t+\")\":\"inject(\"+t+\")\"}(r,t),c=function(t){function o(){t.apply(this,arguments)}return t&&(o.__proto__=t),(o.prototype=Object.create(t&&t.prototype)).constructor=o,o.prototype.render=function(){var t=this.props,o=t.forwardRef,i=function(e,r){var t={};for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&-1===r.indexOf(n)&&(t[n]=e[n]);return t}(t,[\"forwardRef\"]);return Object.assign(i,e(this.context||{},i)||{}),o&&!function(e){return!(e.prototype&&e.prototype.render)}(r)&&(i.ref=this.props.forwardRef),n.createElement(r,i)},o}(n.Component);c.contextType=E,o&&(c=R(c)),c.isMobxInjector=!0;var s,u,f,l=i.forwardRef(function(e,r){return i.createElement(c,Object.assign({},e,{forwardRef:r}))});return s=r,u=l,f=Object.getOwnPropertyNames(Object.getPrototypeOf(s)),Object.getOwnPropertyNames(s).forEach(function(e){p[e]||-1!==f.indexOf(e)||Object.defineProperty(u,e,Object.getOwnPropertyDescriptor(s,e))}),l.wrappedComponent=r,l.displayName=a,l}S.contextType=E;var A=s(\"disposeOnUnmountProto\"),M=s(\"disposeOnUnmountInst\");function T(){var e=this;(this[A]||[]).concat(this[M]||[]).forEach(function(r){var t=\"string\"==typeof r?e[r]:r;null!=t&&(Array.isArray(t)?t.map(function(e){return e()}):t())})}function D(e){function r(r,t,n,i,a,c){for(var s=[],u=arguments.length-6;u-- >0;)s[u]=arguments[u+6];return o.untracked(function(){return i=i||\"<>\",c=c||n,null==t[n]?r?new Error(\"The \"+a+\" `\"+c+\"` is marked as required in `\"+i+\"`, but its value is `\"+(null===t[n]?\"null\":\"undefined\")+\"`.\"):null:e.apply(void 0,[t,n,i,a,c].concat(s))})}var t=r.bind(null,!1);return t.isRequired=r.bind(null,!0),t}function $(e){var r=typeof e;return Array.isArray(e)?\"array\":e instanceof RegExp?\"object\":function(e,r){return\"symbol\"===e||\"Symbol\"===r[\"@@toStringTag\"]||\"function\"==typeof Symbol&&r instanceof Symbol}(r,e)?\"symbol\":r}function q(e,r){return D(function(t,n,i,a,c){return o.untracked(function(){if(e&&$(t[n])===r.toLowerCase())return null;var a;switch(r){case\"Array\":a=o.isObservableArray;break;case\"Object\":a=o.isObservableObject;break;case\"Map\":a=o.isObservableMap;break;default:throw new Error(\"Unexpected mobxType: \"+r)}var s=t[n];if(!a(s)){var u=function(e){var r=$(e);if(\"object\"===r){if(e instanceof Date)return\"date\";if(e instanceof RegExp)return\"regexp\"}return r}(s),f=e?\" or javascript `\"+r.toLowerCase()+\"`\":\"\";return new Error(\"Invalid prop `\"+c+\"` of type `\"+u+\"` supplied to `\"+i+\"`, expected `mobx.Observable\"+r+\"`\"+f+\".\")}return null})})}function N(e,r){return D(function(t,n,i,a,c){for(var s=[],u=arguments.length-5;u-- >0;)s[u]=arguments[u+5];return o.untracked(function(){if(\"function\"!=typeof r)return new Error(\"Property `\"+c+\"` of component `\"+i+\"` has invalid PropType notation.\");var o=q(e,\"Array\")(t,n,i);if(o instanceof Error)return o;for(var u=t[n],f=0;f/node_modules/\"\n ]\n },\n \"husky\": {\n \"hooks\": {\n \"pre-commit\": \"lint-staged\"\n }\n }\n}" }, { "path": "inst/www/react/AUTHORS", "content": "39 <8398a7@gmail.com>\nAaron Franks \nAaron Gelter \nAdam Bloomston \nAdam Krebs \nAdam Mark \nAdam Solove \nAdam Timberlake \nAdam Zapletal \nAhmad Wali Sidiqi \nAlan Plum \nAlan Souza \nAlan deLevie \nAlastair Hole \nAlex \nAlex Boatwright \nAlex Boyd \nAlex Dajani \nAlex Lopatin \nAlex Mykyta \nAlex Pien \nAlex Smith \nAlex Zelenskiy \nAlexander Shtuchkin \nAlexander Solovyov \nAlexander Tseung \nAlexandre Gaudencio \nAlexey Raspopov \nAlexey Shamrin \nAli Ukani \nAndre Z Sanchez \nAndreas Savvides \nAndreas Svensson \nAndres Kalle \nAndres Suarez \nAndrew Clark \nAndrew Cobby \nAndrew Davey \nAndrew Henderson \nAndrew Kulakov \nAndrew Rasmussen \nAndrew Sokolov \nAndrew Zich \nAndrey Popp <8mayday@gmail.com>\nAnthony van der Hoorn \nAnto Aravinth \nAntonio Ruberto \nAntti Ahti \nAnuj Tomar \nAoDev \nApril Arcus \nAreeb Malik \nAria Buckles \nAria Stewart \nArian Faurtosh \nArtem Nezvigin \nAustin Wright \nAyman Osman \nBaraa Hamodi \nBartosz Kaszubowski \nBasarat Ali Syed \nBattaile Fauber \nBeau Smith \nBen Alpert \nBen Anderson \nBen Brooks \nBen Foxall \nBen Halpern \nBen Jaffe \nBen Moss \nBen Newman \nBen Ripkens \nBenjamin Keen \nBenjamin Leiken \nBenjamin Woodruff \nBenjy Cui \nBill Blanchard \nBill Fisher \nBlaine Hatab \nBlaine Kasten \nBob Eagan \nBob Ralian \nBob Renwick \nBobby \nBojan Mihelac \nBradley Spaulding \nBrandon Bloom \nBrandon Tilley \nBrenard Cubacub \nBrian Cooke \nBrian Holt \nBrian Hsu \nBrian Kim \nBrian Kung \nBrian Reavis \nBrian Rue \nBruno Škvorc \nCam Song \nCam Spiers \nCameron Chamberlain \nCameron Matheson \nCarter Chung \nCassus Adam Banko \nCat Chen \nCedric Sohrauer \nCesar William Alvarenga \nChangsoon Bok \nCharles Marsh \nChase Adams \nCheng Lou \nChitharanjan Das \nChris Bolin \nChris Grovers \nChris Ha \nChris Rebert \nChris Sciolla \nChristian Alfoni \nChristian Oliff \nChristian Roman \nChristoffer Sawicki \nChristoph Pojer \nChristopher Monsanto \nClay Allsopp \nConnor McSheffrey \nConor Hastings \nCory House \nCotton Hou \nCraig Akimoto \nCristovao Verstraeten \nDamien Pellier \nDan Abramov \nDan Fox \nDan Schafer \nDaniel Carlsson \nDaniel Cousens \nDaniel Friesen \nDaniel Gasienica \nDaniel Hejl \nDaniel Hejl \nDaniel Lo Nigro \nDaniel Mané \nDaniel Miladinov \nDaniel Rodgers-Pryor \nDaniel Schonfeld \nDanny Ben-David \nDarcy \nDaryl Lau \nDarío Javier Cravero \nDave Galbraith \nDavid Baker \nDavid Ed Mellum \nDavid Goldberg \nDavid Granado \nDavid Greenspan \nDavid Hellsing \nDavid Hu \nDavid Khourshid \nDavid Mininger \nDavid Neubauer \nDavid Percy \nDean Shi \nDenis Sokolov \nDeniss Jacenko \nDennis Johnson \nDevon Blandin \nDevon Harvey \nDmitrii Abramov \nDmitriy Rozhkov \nDmitry Blues \nDmitry Mazuro \nDomenico Matteo \nDon Abrams \nDongsheng Liu \nDustan Kasten \nDustin Getz \nDylan Harrington \nEduardo Garcia \nEdvin Erikson \nElaine Fang \nEnguerran \nEric Clemmons \nEric Eastwood \nEric Florenzano \nEric O'Connell \nEric Schoffstall \nErik Harper \nEspen Hovlandsdal \nEvan Coonrod \nEvan Vosberg \nFabio M. Costa \nFederico Rampazzo \nFelipe Oliveira Carvalho \nFelix Gnass \nFelix Kling \nFernando Correia \nFrankie Bagnardi \nFrançois-Xavier Bois \nFred Zhao \nFreddy Rangel \nFyodor Ivanishchev \nG Scott Olson \nG. Kay Lee \nGabe Levi \nGajus Kuizinas \nGareth Nicholson \nGarren Smith \nGavin McQuistin \nGeert Pasteels \nGeert-Jan Brits \nGeorge A Sisco III \nGeorgii Dolzhykov \nGilbert \nGlen Mailer \nGrant Timmerman \nGreg Hurrell \nGreg Perkins \nGreg Roodt \nGregory \nGuangqiang Dong \nGuido Bouman \nHarry Hull \nHarry Marr \nHarry Moreno \nHarshad Sabne \nHekar Khani \nHendrik Swanepoel \nHenrik Nyh \nHenry Wong \nHenry Zhu \nHideo Matsumoto \nHou Chia \nHuang-Wei Chang \nHugo Agbonon \nHugo Jobling \nHyeock Kwon \nHéliton Nordt \nIan Obermiller \nIgnacio Carbajo \nIgor Scekic \nIlia Pavlenkov \nIlya Shuklin \nIlyá Belsky \nIngvar Stepanyan \nIrae Carvalho \nIsaac Salier-Hellendag \nIurii Kucherov \nIvan Kozik \nIvan Krechetov \nIvan Vergiliev \nJ. Andrew Brassington \nJ. Renée Beach \nJD Isaacks \nJJ Weber \nJW \nJack Zhang \nJackie Wung \nJacob Gable \nJacob Greenleaf \nJae Hun Ro \nJaeho Lee \nJaime Mingo \nJake Worth \nJakub Malinowski \nJames \nJames Brantly \nJames Burnett \nJames Friend \nJames Ide \nJames Long \nJames Pearce \nJames Seppi \nJames South \nJames Wen \nJamie Wong \nJamis Charles \nJamison Dance \nJan Hancic \nJan Kassens \nJan Raasch \nJared Forsyth \nJason \nJason Bonta \nJason Ly \nJason Miller \nJason Quense \nJason Trill \nJason Webster \nJay Jaeho Lee \nJean Lauliac \nJed Watson \nJeff Barczewski \nJeff Carpenter \nJeff Chan \nJeff Hicken \nJeff Kolesky \nJeff Morrison \nJeff Welch \nJeffrey Lin \nJeremy Fairbank \nJesse Skinner \nJignesh Kakadiya \nJim OBrien \nJim Sproch \nJimmy Jea \nJing Chen \nJinwoo Oh \nJinxiu Lee \nJiyeon Seo \nJody McIntyre \nJoe Critchley \nJoe Stein \nJoel Auterson \nJohannes Baiter \nJohannes Emerich \nJohannes Lumpe \nJohn Heroy \nJohn Ryan \nJohn Watson \nJohn-David Dalton \nJon Beebe \nJon Chester \nJon Hester \nJon Madison \nJon Scott Clark \nJon Tewksbury \nJonas Enlund \nJonas Gebhardt \nJonathan Hsu \nJonathan Persson \nJordan Harband \nJordan Walke \nJorrit Schippers \nJoseph Nudell \nJoseph Savona \nJosh Bassett \nJosh Duck \nJosh Perez \nJosh Yudaken \nJoshua Evans \nJoshua Go \nJoshua Goldberg \nJoshua Ma \nJoão Valente \nJuan Serrano \nJulen Ruiz Aizpuru \nJulian Viereck \nJulien Bordellier \nJulio Lopez \nJun Wu \nJuraj Dudak \nJustas Brazauskas \nJustin Jaffray \nJustin Robison \nJustin Woo \nKale \nKamron Batman \nKarl Mikkelsen \nKarpich Dmitry \nKeito Uchiyama \nKen Powers \nKent C. Dodds \nKevin Cheng <09chengk@gmail.com>\nKevin Coughlin \nKevin Huang \nKevin Lau \nKevin Old \nKevin Robinson \nKewei Jiang \nKier Borromeo \nKimCoding \nKirk Steven Hansen \nKit Randel \nKohei TAKATA \nKoo Youngmin \nKrystian Karczewski \nKunal Mehta \nKurt Ruppel \nKyle Kelley \nKyle Mathews \nLaurence Rowe \nLaurent Etiemble \nLee Byron \nLee Jaeyoung \nLei \nLeland Richardson \nLeon Fedotov \nLeon Yip \nLeonardo YongUk Kim \nLevi Buzolic \nLevi McCallum \nLily \nLogan Allen \nLovisa Svallingson \nLudovico Fischer \nLuigy Leon \nLuke Horvat \nMIKAMI Yoshiyuki \nMaher Beg \nManas \nMarcin K. \nMarcin Kwiatkowski \nMarcin Szczepanski \nMariano Desanze \nMarjan \nMark Anderson \nMark Funk \nMark Hintz \nMark IJbema \nMark Murphy \nMark Richardson \nMark Rushakoff \nMark Sun \nMarlon Landaverde \nMarshall Roch \nMartin Andert \nMartin Hujer \nMartin Jul \nMartin Konicek \nMartin Mihaylov \nMasaki KOBAYASHI \nMathieu M-Gosselin \nMathieu Savy \nMatias Singers \nMatsunoki \nMatt Brookes \nMatt Dunn-Rankin \nMatt Harrison \nMatt Huggins \nMatt Stow \nMatt Zabriskie \nMatthew Dapena-Tretter \nMatthew Herbst \nMatthew Hodgson \nMatthew Johnston \nMatthew King \nMatthew Looi \nMatthew Miner \nMatthias Le Brun \nMatti Nelimarkka \nMattijs Kneppers \nMax F. Albrecht <1@178.is>\nMax Heiber \nMax Stoiber \nMaxi Ferreira \nMaxim Abramchuk \nMerrick Christensen \nMert Kahyaoğlu \nMichael Chan \nMichael McDermott \nMichael Randers-Pehrson \nMichael Ridgway \nMichael Warner \nMichael Wiencek \nMichael Ziwisky \nMichal Srb \nMichelle Todd \nMihai Parparita \nMike D Pilsbury \nMike Groseclose \nMike Nordick \nMikolaj Dadela \nMiles Johnson \nMinwe LUO \nMiorel Palii \nMorhaus \nMoshe Kolodny \nMouad Debbar \nMurad \nMurray M. Moss \nNadeesha Cabral \nNaman Goel \nNate Hunzaker \nNate Lee \nNathan Smith \nNathan White \nNee <944316342@qq.com>\nNeri Marschik \nNguyen Truong Duy \nNicholas Bergson-Shilcock \nNicholas Clawson \nNick Balestra \nNick Fitzgerald \nNick Gavalas \nNick Merwin \nNick Presta \nNick Raienko \nNick Thompson \nNick Williams \nNiklas Boström \nNing Xia \nNiole Nelson \nOiva Eskola \nOleg \nOleksii Markhovskyi \nOliver Zeigermann \nOlivier Tassinari \nOwen Coutts \nPablo Lacerda de Miranda \nPaolo Moretti \nPascal Hartig \nPatrick \nPatrick Laughlin \nPatrick Stapleton \nPaul Benigeri \nPaul Harper \nPaul O’Shannessy \nPaul Seiffert \nPaul Shen \nPedro Nauck \nPete Hunt \nPeter Blazejewicz \nPeter Cottle \nPeter Jaros \nPeter Newnham \nPetri Lehtinen \nPetri Lievonen \nPieter Vanderwerff \nPouja Nikray \nPrathamesh Sonpatki \nPrayag Verma \nPreston Parry \nRafael \nRafal Dittwald \nRainer Oviir \nRajat Sehgal \nRajiv Tirumalareddy \nRam Kaniyur \nRandall Randall \nRay \nRaymond Ha \nReed Loden \nRemko Tronçon \nRichard D. Worth \nRichard Feldman \nRichard Kho \nRichard Littauer \nRichard Livesey \nRichard Wood \nRick Beerendonk \nRick Ford \nRiley Tomasek \nRob Arnold \nRobert Binna \nRobert Knight \nRobert Sedovsek \nRobin Berjon \nRobin Frischmann \nRoman Pominov \nRoman Vanesyan \nRuss \nRyan Seddon \nSahat Yalkabov \nSaif Hakim \nSaiichi Hashimoto \nSam Beveridge \nSam Saccone \nSam Selikoff \nSamy Al Zahrani \nSander Spies \nScott Burch \nScott Feeney \nSean Kinsey \nSebastian Markbåge \nSebastian McKenzie \nSeoh Char \nSercan Eraslan \nSerg \nSergey Generalov \nSergey Rubanov \nSeyi Adebajo \nShane O'Sullivan \nShaun Trennery \nShihChi Huang \nShim Won \nShinnosuke Watanabe \nShogun Sea \nShota Kubota \nShripad K \nSibi \nSimen Bekkhus \nSimon Højberg \nSimon Welsh \nSimone Vittori \nSoichiro Kawamura \nSophia Westwood \nSota Ohara \nSpencer Handley \nStefan Dombrowski \nStephen Murphy \nSterling Cobb \nSteve Baker <_steve_@outlook.com>\nSteven Luscher \nSteven Vachon \nStoyan Stefanov \nSundeep Malladi \nSunny Juneja \nSven Helmberger \nSverre Johansen \nSébastien Lorber \nSławomir Laskowski \nTaeho Kim \nTay Yang Shun \nTed Kim \nTengfei Guo \nTeodor Szente \nThomas Aylott \nThomas Boyt \nThomas Broadley \nThomas Reggi \nThomas Röggla \nThomas Shaddox \nThomas Shafer \nThomasCrvsr \nTienchai Wirojsaksaree \nTim Routowicz \nTim Schaub \nTimothy Yung \nTimur Carpeev \nTobias Reiss \nTom Duncalf \nTom Haggie \nTom Hauburger \nTom MacWright \nTom Occhino \nTomasz Kołodziejski \nTomoya Suzuki \nTony Spiro \nToru Kobayashi \nTrinh Hoang Nhu \nTsung Hung \nTyler Brock \nUstin Zarubin \nVadim Chernysh \nVarun Rau \nVasiliy Loginevskiy \nVictor Alvarez \nVictor Homyakov \nVictor Koenders \nVille Immonen \nVincent Riemer \nVincent Siao \nVipul A M \nVitaly Kramskikh \nVitor Balocco \nVjeux \nVolkan Unsal \nWander Wang \nWayne Larsen \nWickyNilliams \nWincent Colaiuta \nWout Mertens \nXavier Morel \nXuefengWu \nYakov Dalinchuk \nYasar icli \nYouBao Nong \nYuichi Hagio \nYuriy Dybskiy \nYutaka Nakajima \nYuval Dekel \nZach Bruggeman \nZach Ramaekers \nZacharias \nZeke Sikelianos \nZhangjd \nadraeth \narush \nbrafdlog \nchen \nclariroid \nclaudiopro \ncutbko \ndavidxi \ndongmeng.ldm \niamchenxin \niamdoron \niawia002 \nimagentleman \nkoh-taka \nkohashi85 \nlaiso \nleeyoungalias \nli.li \nmaxprafferty \nrgarifullin \nsongawee \nsugarshin \nwali-s \nyiminghe \nyoumoo \nzhangjg \nzwhitchcox \nÁrni Hermann Reynisson \n元彦 \n凌恒 \n张敏 \n" }, { "path": "inst/www/react/LICENSE.txt", "content": "MIT License\n\nCopyright (c) 2013-present, Facebook, Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "inst/www/react-tools/react-tools.js", "content": "(function(s,u){typeof exports==\"object\"&&typeof module<\"u\"?u(exports):typeof define==\"function\"&&define.amd?define([\"exports\"],u):(s=typeof globalThis<\"u\"?globalThis:s||self,u(s.reactR={}))})(this,function(s){\"use strict\";function u(n,t){if(typeof t==\"string\")return t;if(t.name[0]===t.name[0].toUpperCase()&&!n.hasOwnProperty(t.name))throw new Error(\"Unknown component: \"+t.name);for(let i in t.attribs)g(t.attribs[i])&&(t.attribs[i]=u(n,t.attribs[i]));for(var a=n.hasOwnProperty(t.name)?n[t.name]:t.name,r=[a,t.attribs],e=0;e{this.props.message.toUpperCase()};\n }\n}\n\nconst FunctionalShout = ({ message }) => {\n return {message.toUpperCase()};\n}\n\nclass TodoList extends React.Component {\n render() {\n return
      \n {this.props.children.map((child, i) => {\n return
    1. {child}
      2. ;\n })}\n
    \n }\n}\n\n// Converts a parse-xml style tree to an htmltools::tag style tree of JSON.\nfunction objectToTag(obj) {\n return {\n name: obj.name,\n attribs: obj.attributes,\n children: obj.children.map(child => {\n if (child.type === 'text') {\n return child.text;\n } else {\n return objectToTag(child);\n }\n })\n }\n}\n\n// Converts a string of markup to an htmltools::tag style tree of JSON.\nfunction stringToTag(str) {\n return objectToTag(parseXml(str).children[0]);\n}\n\n// Compares two parse-xml style trees for \"deep\" equality\nfunction xmlEqual(x1, x2) {\n if (x1.type === 'text'\n && x2.type === 'text'\n && x1.text === x2.text)\n return true;\n return x1.name === x2.name\n // Test attributes for equality\n && Object.keys(x1).length === Object.keys(x2).length\n && Object.keys(x1).every(k => x1[k] === x2[k])\n // Test children for equality\n && x1.children.length === x2.children.length\n && x1.children.every((child, i) => xmlEqual(child, x2.children[i]))\n}\n\ndescribe('window.reactR', () => {\n describe('#hydrate() with HTML', () => {\n it('hydrates an HTML5 component with a text child', () => {\n const markup = '

    Hello

    ';\n assert.equal(\n renderToString(parse(markup)),\n renderToString(hydrate({}, stringToTag(markup)))\n )\n })\n it('hydrates nested HTML5 components', () => {\n const markup = '

    Hello

    Oh, hello.

    '\n assert.equal(\n renderToString(parse(markup)),\n renderToString(hydrate({}, stringToTag(markup)))\n )\n })\n });\n describe('#hydrate() with Components', () => {\n it('should throw an exception with an unknown component', () => {\n assert.throws(() => {\n hydrate({ Shout: Shout }, stringToTag(''))\n }, Error, /Unknown component/);\n });\n })\n});\n" }, { "path": "man/React.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/reacttools.R\n\\docType{data}\n\\name{React}\n\\alias{React}\n\\title{React component builder.}\n\\format{\nAn object of class \\code{react_component_builder} of length 0.\n}\n\\usage{\nReact\n}\n\\description{\n\\code{React} is a syntactically-convenient way to create instances of React\ncomponents that can be sent to the browser for display. It is a list for\nwhich \\link[=InternalMethods]{extract methods} are defined, allowing\nobject creation syntax like \\code{React$MyComponent(x = 1)} where\n\\code{MyComponent} is a React component you have exposed to Shiny in\nJavaScript.\n}\n\\details{\nInternally, the \\code{\\link{component}} function is used to create the\ncomponent instance.\n}\n\\examples{\n# Create an instance of ParentComponent with two children,\n# ChildComponent and OtherChildComponent.\nReact$ParentComponent(\n x = 1,\n y = 2,\n React$ChildComponent(),\n React$OtherChildComponent()\n)\n}\n\\keyword{datasets}\n" }, { "path": "man/babel_transform.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/babel.R\n\\name{babel_transform}\n\\alias{babel_transform}\n\\title{Transform Code with Babel}\n\\usage{\nbabel_transform(code = \"\")\n}\n\\arguments{\n\\item{code}{\\code{character}}\n}\n\\value{\ntransformed \\code{character}\n}\n\\description{\nHelper function to use \\code{V8} with \\code{Babel} so we can\navoid a JSX transformer with using \\code{reactR}.\n}\n\\examples{\n\\dontrun{\nlibrary(reactR)\nbabel_transform('
    react div
    ')\n}\n}\n" }, { "path": "man/component.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/reacttools.R\n\\name{component}\n\\alias{component}\n\\title{Create a React component}\n\\usage{\ncomponent(name, varArgs = list())\n}\n\\arguments{\n\\item{name}{Name of the React component, which must start with an upper-case\ncharacter.}\n\n\\item{varArgs}{Attributes and children of the element to pass along to\n\\code{\\link[htmltools]{tag}} as \\code{varArgs}.}\n}\n\\value{\nAn htmltools \\code{\\link[htmltools]{tag}} object\n}\n\\description{\nCreate a React component\n}\n\\examples{\ncomponent(\"ParentComponent\",\n list(\n x = 1,\n y = 2,\n component(\"ChildComponent\"),\n component(\"OtherChildComponent\")\n )\n)\n}\n" }, { "path": "man/createReactShinyInput.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/reacttools.R\n\\name{createReactShinyInput}\n\\alias{createReactShinyInput}\n\\title{Create a React-based input}\n\\usage{\ncreateReactShinyInput(\n inputId,\n class,\n dependencies,\n default = NULL,\n configuration = list(),\n container = htmltools::tags$div\n)\n}\n\\arguments{\n\\item{inputId}{The \\code{input} slot that will be used to access the value.}\n\n\\item{class}{Space-delimited list of CSS class names that should identify\nthis input type in the browser.}\n\n\\item{dependencies}{HTML dependencies to include in addition to those\nsupporting React. Must contain at least one dependency, that of the input's\nimplementation.}\n\n\\item{default}{Initial value.}\n\n\\item{configuration}{Static configuration data.}\n\n\\item{container}{Function to generate an HTML element to contain the input.}\n}\n\\value{\nShiny input suitable for inclusion in a UI.\n}\n\\description{\nCreate a React-based input\n}\n\\examples{\nmyInput <- function(inputId, default = \"\") {\n # The value of createReactShinyInput should be returned from input constructor functions.\n createReactShinyInput(\n inputId,\n \"myinput\",\n # At least one htmlDependency must be provided -- the JavaScript implementation of the input.\n htmlDependency(\n name = \"my-input\",\n version = \"1.0.0\",\n src = \"www/mypackage/myinput\",\n package = \"mypackage\",\n script = \"myinput.js\"\n ),\n default\n )\n}\n}\n" }, { "path": "man/html_dependency_corejs.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/dependencies.R\n\\name{html_dependency_corejs}\n\\alias{html_dependency_corejs}\n\\title{Shim Dependency for React in RStudio Viewer}\n\\usage{\nhtml_dependency_corejs()\n}\n\\value{\n\\code{\\link[htmltools]{htmlDependency}}\n}\n\\description{\nAdd this first for 'React' to work in RStudio Viewer.\n}\n" }, { "path": "man/html_dependency_mobx.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/dependencies.R\n\\name{html_dependency_mobx}\n\\alias{html_dependency_mobx}\n\\title{Dependencies for 'mobx'}\n\\usage{\nhtml_dependency_mobx(react = TRUE)\n}\n\\arguments{\n\\item{react}{\\code{logical} to add react 'mobx' dependencies.}\n}\n\\value{\n\\code{\\link[htmltools]{htmlDependency}}\n}\n\\description{\nAdd JavaScript 'mobx' and 'mobx-react' dependency. When using with 'react', the order\nof the dependencies is important, so please add \\code{html_dependency_react()} before\n\\code{html_dependency_mobx()}.\n}\n\\examples{\nif(interactive()) {\n\nlibrary(htmltools)\nlibrary(reactR)\n\nbrowsable(\n tagList(\n html_dependency_mobx(react = FALSE),\n div(id=\"test\"),\n tags$script(HTML(\n\"\n var obs = mobx.observable({val: null})\n mobx.autorun(function() {\n document.querySelector('#test').innerText = obs.val\n })\n setInterval(\n function() {obs.val++},\n 1000\n )\n\"\n ))\n )\n)\n}\n\n\\dontrun{\n# use with react\nlibrary(htmltools)\nlibrary(reactR)\n\nbrowsable(\n tagList(\n html_dependency_react(),\n html_dependency_mobx(),\n div(id=\"test\"),\n tags$script(HTML(babel_transform(\n\"\n var obs = mobx.observable({val: null})\n var App = mobxReact.observer((props) =>
    {props.obs.val}
    )\n\n ReactDOM.render(, document.querySelector('#test'))\n\n setInterval(\n function() {obs.val++},\n 1000\n )\n\"\n )))\n )\n)\n}\n}\n" }, { "path": "man/html_dependency_react.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/dependencies.R\n\\name{html_dependency_react}\n\\alias{html_dependency_react}\n\\title{Dependencies for React}\n\\usage{\nhtml_dependency_react(offline = TRUE)\n}\n\\arguments{\n\\item{offline}{\\code{logical} to use local file dependencies. If \\code{FALSE},\nthen the dependencies use the Facebook cdn as its \\code{src}.\nTo use with \\code{JSX} see \\code{\\link{babel_transform}}.}\n}\n\\value{\n\\code{\\link[htmltools]{htmlDependency}}\n}\n\\description{\nAdd JavaScript 'React' dependency. For this to work in RStudio Viewer, also include\n\\code{\\link{html_dependency_corejs}}.\n}\n\\examples{\nlibrary(reactR)\nlibrary(htmltools)\n\ntagList(\n tags$script(\n \"\n ReactDOM.render(\n React.createElement(\n 'h1',\n null,\n 'Powered by React'\n ),\n document.body\n )\n \"\n ),\n #add core-js first to work in RStudio Viewer\n html_dependency_corejs(),\n html_dependency_react() #offline=FALSE for CDN\n)\n}\n" }, { "path": "man/html_dependency_reacttools.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/dependencies.R\n\\name{html_dependency_reacttools}\n\\alias{html_dependency_reacttools}\n\\title{Adds window.reactR.exposeComponents and window.reactR.hydrate}\n\\usage{\nhtml_dependency_reacttools()\n}\n\\value{\n\\code{\\link[htmltools]{htmlDependency}}\n}\n\\description{\nAdds window.reactR.exposeComponents and window.reactR.hydrate\n}\n" }, { "path": "man/reactMarkup.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/reacttools.R\n\\name{reactMarkup}\n\\alias{reactMarkup}\n\\title{Prepare data that represents a single-element character vector, a React\ncomponent, or an htmltools tag for sending to the client.}\n\\usage{\nreactMarkup(tag)\n}\n\\arguments{\n\\item{tag}{character vector or React component or\n\\code{\\link[htmltools]{tag}}}\n}\n\\value{\nA reactR markup object suitable for being passed to\n \\code{\\link[htmlwidgets]{createWidget}} as widget instance data.\n}\n\\description{\nTag lists as returned by \\code{htmltools tagList} are not currently\nsupported.\n}\n" }, { "path": "man/scaffoldReactShinyInput.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/scaffold_input.R\n\\name{scaffoldReactShinyInput}\n\\alias{scaffoldReactShinyInput}\n\\title{Create implementation scaffolding for a React.js-based Shiny input.}\n\\usage{\nscaffoldReactShinyInput(name, npmPkgs = NULL, edit = interactive())\n}\n\\arguments{\n\\item{name}{Name of input}\n\n\\item{npmPkgs}{Optional \\href{https://www.npmjs.com/}{NPM} packages upon which\nthis input is based which will be used to populate \\code{package.json}.\nShould be a named list of names to\n\\href{https://docs.npmjs.com/files/package.json/}{versions}.}\n\n\\item{edit}{Automatically open the input's source files after creating the\nscaffolding.}\n}\n\\description{\nAdd the minimal code required to implement a React.js-based Shiny input to an\nR package.\n}\n\\note{\nThis function must be executed from the root directory of the package\n you wish to add the input to.\n}\n" }, { "path": "man/scaffoldReactWidget.Rd", "content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/scaffold_widget.R\n\\name{scaffoldReactWidget}\n\\alias{scaffoldReactWidget}\n\\title{Create implementation scaffolding for a React.js-based HTML widget}\n\\usage{\nscaffoldReactWidget(name, npmPkgs = NULL, edit = interactive())\n}\n\\arguments{\n\\item{name}{Name of widget}\n\n\\item{npmPkgs}{Optional \\href{https://www.npmjs.com/}{NPM} packages upon which\nthis widget is based which will be used to populate \\code{package.json}.\nShould be a named list of names to\n\\href{https://docs.npmjs.com/files/package.json/}{versions}.}\n\n\\item{edit}{Automatically open the widget's JavaScript source file after\ncreating the scaffolding.}\n}\n\\description{\nAdd the minimal code required to implement a React.js-based HTML widget to an\nR package.\n}\n\\note{\nThis function must be executed from the root directory of the package\n you wish to add the widget to.\n}\n" }, { "path": "package.json", "content": "{\n \"name\": \"react-tools\",\n \"private\": true,\n \"type\": \"module\",\n \"scripts\": {\n \"build\": \"vite build\",\n \"test\": \"vitest run\"\n },\n \"devDependencies\": {\n \"@rgrove/parse-xml\": \"^4.1.0\",\n \"html-react-parser\": \"^5.1.1\",\n \"react\": \"^18.2.0\",\n \"react-dom\": \"^18.2.0\",\n \"vite\": \"^5.0.11\",\n \"vitest\": \"^1.2.1\"\n }\n}\n" }, { "path": "reactR.Rproj", "content": "Version: 1.0\n\nRestoreWorkspace: Default\nSaveWorkspace: Default\nAlwaysSaveHistory: Default\n\nEnableCodeIndexing: Yes\nUseSpacesForTab: Yes\nNumSpacesForTab: 2\nEncoding: UTF-8\n\nRnwWeave: Sweave\nLaTeX: XeLaTeX\n\nAutoAppendNewline: Yes\nStripTrailingWhitespace: Yes\n\nBuildType: Package\nPackageUseDevtools: Yes\nPackageInstallArgs: --no-multiarch --with-keep.source\nPackageRoxygenize: rd,collate,namespace\n" }, { "path": "srcjs/input.js", "content": "/*\n * This default receiveMessage implementation expects data to contain whole\n * configuration and value properties. If either is present, it will be set and\n * the component will be re-rendered. Because receiveMessage is typically used\n * by input authors to perform incremental updates, this default implementation\n * can be overriden by the user with the receiveMessage arguments to\n * reactShinyInput.\n */\nfunction defaultReceiveMessage(el, { configuration, value }) {\n let dirty = false;\n if (configuration !== undefined) {\n this.setInputConfiguration(el, configuration);\n dirty = true;\n }\n if (value !== undefined) {\n this.setInputValue(el, value);\n dirty = true;\n }\n if (dirty) {\n this.getCallback(el)();\n this.render(el);\n }\n}\n\nconst defaultOptions = {\n receiveMessage: defaultReceiveMessage,\n type: false,\n ratePolicy: null\n};\n\n/**\n * Installs a new Shiny input binding based on a React component.\n *\n * @param {string} selector - jQuery selector that should identify the set of\n * container elements within the scope argument of Shiny.InputBinding.find.\n * @param {string} name - A name such as 'acme.FooInput' that should uniquely\n * identify the component.\n * @param {Object} component - React Component, either class or function.\n * @param {Object} options - Additional configuration options. Supported\n * options are:\n * - receiveMessage: Implementation of Shiny.InputBinding to use in place of\n * the default. Typically overridden as an optimization to perform\n * incremental value updates.\n * - type: `false`, a string, or a function.\n * - `false` (the default): denotes that the value produced by this input\n * should not be intercepted by any handlers registered in R on the\n * server using shiny::registerInputHandler().\n * - string: denotes the input's *type* and should correspond to the\n * type parameter of shiny::registerInputHandler().\n * - function: A function called with `this` bound to the InputBinding\n * instance and passed a single argument, the input's containing DOM\n * element. The function should return either `false` or a string\n * corresponding to the type parameter of shiny::registerInputHandler().\n * - ratePolicy: A rate policy object as defined in the documentation for\n * getRatePolicy(): https://shiny.rstudio.com/articles/building-inputs.html\n * A rate policy object has two members:\n * - `policy`: Valid values are the strings \"direct\", \"debounce\", and\n * \"throttle\". \"direct\" means that all events are sent immediately.\n * - `delay`: Number indicating the number of milliseconds that should be\n * used when debouncing or throttling. Has no effect if the policy is\n * direct.\n * The specified rate policy is only applied when `true` is passed as the\n * second argument to the `setValue` function passed as a prop to the\n * input component.\n *\n */\nexport function reactShinyInput(selector,\n name,\n component,\n options) {\n options = Object.assign({}, defaultOptions, options);\n Shiny.inputBindings.register(new class extends Shiny.InputBinding {\n\n /*\n * Methods override those in Shiny.InputBinding\n */\n\n find(scope) {\n return $(scope).find(selector);\n }\n getValue(el) {\n return this.getInputValue(el);\n }\n setValue(el, value, rateLimited = false) {\n /*\n * We have to check whether $(el).data('callback') is undefined here\n * in case shiny::renderUI() is involved. If an input is contained in a\n * shiny::uiOutput(), the following strange thing happens occasionally:\n *\n * 1. setValue() is bound to an el in this.render(), below\n * 2. An event that will call setValue() is enqueued\n * 3. While the event is still enqueued, el is unbound and removed\n * from the DOM by the JS code associated with shiny::uiOutput()\n * - That code uses jQuery .html() in output_binding_html.js\n * - .html() removes el from the DOM and clears ist data and events\n * 4. By the time the setValue() bound to the original el is invoked,\n * el has been unbound and its data cleared.\n *\n * Since the original input is gone along with its callback, it\n * seems to make the most sense to do nothing.\n */\n if ($(el).data('callback') !== undefined) {\n this.setInputValue(el, value);\n this.getCallback(el)(rateLimited);\n this.render(el);\n }\n }\n initialize(el) {\n $(el).data('value', JSON.parse($(el).next().text()));\n $(el).data('configuration', JSON.parse($(el).next().next().text()));\n }\n subscribe(el, callback) {\n $(el).data('callback', callback);\n this.render(el);\n }\n unsubscribe(el) {\n ReactDOM.render(null, el);\n }\n receiveMessage(el, data) {\n options.receiveMessage.call(this, el, data);\n }\n getType(el) {\n if (typeof options.type === 'function') {\n return options.type.call(this, el);\n } else if (options.type === false || typeof options.type === 'string') {\n return options.type;\n } else {\n throw new Error('options.type must be false, a string, or a function');\n }\n }\n getRatePolicy() {\n return options.ratePolicy;\n }\n\n /*\n * Methods not present in Shiny.InputBinding but accessible to users\n * through `this` in receiveMessage\n */\n\n getInputValue(el) {\n return $(el).data('value');\n }\n setInputValue(el, value) {\n $(el).data('value', value);\n }\n getInputConfiguration(el) {\n return $(el).data('configuration');\n }\n setInputConfiguration(el, configuration) {\n $(el).data('configuration', configuration);\n }\n getCallback(el) {\n return $(el).data('callback');\n }\n render(el) {\n const element = React.createElement(component, {\n configuration: this.getInputConfiguration(el),\n value: this.getValue(el),\n setValue: this.setValue.bind(this, el),\n el: el\n });\n ReactDOM.render(element, el);\n }\n }, name);\n}\n\n" }, { "path": "srcjs/react-tools.js", "content": "import { reactWidget, hydrate } from './widget';\nimport { reactShinyInput } from './input';\n\nexport {\n reactShinyInput,\n reactWidget,\n hydrate\n};\n" }, { "path": "srcjs/widget.js", "content": "/**\n * Recursively transforms tag, a JSON representation of an instance of a\n * React component and its children, into a React element suitable for\n * passing to ReactDOM.render.\n * @param {Object} components\n * @param {Object} tag\n */\nexport function hydrate(components, tag) {\n if (typeof tag === 'string') return tag;\n if (tag.name[0] === tag.name[0].toUpperCase()\n && !components.hasOwnProperty(tag.name)) {\n throw new Error(\"Unknown component: \" + tag.name);\n }\n // thanks https://github.com/stla\n // https://github.com/react-R/reactR/issues/61\n // attribs that are slots will likely contain tags that also need hydration\n // convert any attribs that contain object that matches tag structure\n for(let attrib in tag.attribs) {\n if(isTag(tag.attribs[attrib])) {\n tag.attribs[attrib] = hydrate(components, tag.attribs[attrib]);\n }\n }\n var elem = components.hasOwnProperty(tag.name) ? components[tag.name] : tag.name,\n args = [elem, tag.attribs];\n for (var i = 0; i < tag.children.length; i++) {\n args.push(hydrate(components, tag.children[i]));\n }\n return React.createElement.apply(React, args);\n}\n\nexport const defaultOptions = {\n // The name of the property on the root tag to use for the width, if\n // it's updated.\n widthProperty: \"width\",\n // The name of the property on the root tag to use for the height, if\n // it's updated.\n heightProperty: \"height\",\n // Whether or not to append the string 'px' to the width and height\n // properties when they change.\n appendPx: false,\n // Whether or not to dynamically update the width and height properties\n // of the last known tag when the computed width and height change in\n // the browser.\n renderOnResize: false\n};\n\nexport function mergeOptions(options) {\n var merged = {};\n for (var k in defaultOptions) {\n merged[k] = defaultOptions[k];\n }\n for (var k in options) {\n if (!defaultOptions.hasOwnProperty(k)) {\n throw new Error(\"Unrecognized option: \" + k);\n }\n merged[k] = options[k];\n }\n return merged;\n}\n\nexport function formatDimension(dim, options) {\n if (options.appendPx) {\n return dim + 'px';\n } else {\n return dim;\n }\n}\n\nexport function isTag(value) {\n return (typeof value === 'object')\n && value.hasOwnProperty('name')\n && value.hasOwnProperty('attribs')\n && value.hasOwnProperty('children');\n}\n\n/**\n * Creates an HTMLWidget that is updated by rendering a React component.\n * React component constructors are made available by specifying them by\n * name in the components object.\n * @param {string} name\n * @param {string} type\n * @param {Object} components\n * @param {Object} options\n */\nexport function reactWidget(name, type, components, options) {\n var actualOptions = mergeOptions(options);\n window.HTMLWidgets.widget({\n name: name,\n type: type,\n factory: function (el, width, height) {\n var lastValue,\n instance = {},\n renderValue = (function (value) {\n if (actualOptions.renderOnResize) {\n // value.tag might be a primitive string, in which\n // case there is no attribs property.\n if (typeof value.tag === 'object') {\n value.tag.attribs[actualOptions[\"widthProperty\"]] = formatDimension(width);\n value.tag.attribs[actualOptions[\"heightProperty\"]] = formatDimension(height);\n }\n lastValue = value;\n }\n // with functional stateless components this will be null\n // see https://reactjs.org/docs/react-dom.html#render for more details\n this.instance.component = ReactDOM.render(hydrate(components, value.tag), el);\n });\n return {\n instance: instance,\n renderValue: renderValue,\n resize: function (newWidth, newHeight) {\n if (actualOptions.renderOnResize) {\n width = newWidth;\n height = newHeight;\n renderValue(lastValue);\n }\n }\n };\n }\n })\n}\n\n" }, { "path": "vignettes/intro_htmlwidgets.Rmd", "content": "---\ntitle: \"Authoring htmlwidgets powered by React with reactR\"\nauthor:\n - Alan Dipert\n - Carson Sievert\ndate: \"`r Sys.Date()`\"\noutput: rmarkdown::html_vignette\nvignette: >\n %\\VignetteIndexEntry{htmlwidgets with reactR}\n %\\VignetteEngine{knitr::rmarkdown}\n %\\VignetteEncoding{UTF-8}\n---\n \n```{r, echo=FALSE, include=FALSE}\nknitr::opts_chunk$set(eval = FALSE)\n```\n\nThe [htmlwidgets](https://www.htmlwidgets.org) package provides a framework for creating R bindings to JavaScript libraries. Using the **htmlwidgets** package alone, it's not necessarily straight-forward to create an R binding to a [React](https://reactjs.org/)-powered JavaScript library. The **reactR** package builds on the **htmlwidgets** framework to make it much easier to author **htmlwidgets** that are powered by React. This vignette will show you how to effectively leverage **reactR** to build an **htmlwidgets** package that interfaces with [react-sparklines](https://github.com/borisyankov/react-sparklines) React JavaScript library.\n\n## Software pre-requisites\n\nIn order to develop a **reactR** widget, you'll need to install R and optionally RStudio. If you're on Windows, you should also install [Rtools](https://cran.r-project.org/bin/windows/Rtools/).\n\n> For an excellent general introduction to R package concepts, check out the [R packages](https://r-pkgs.org/) online book.\n\nIn addition, you'll need to install the following JavaScript tools on your machine:\n\n* [Node.js](https://nodejs.org): JavaScript engine and runtime for development outside of browsers. Provides the `node` and `npm` commands.\n* [Yarn](https://classic.yarnpkg.com/en/): Command-line dependency management tool, provides the `yarn` command.\n\nTo follow along in this vignette, you'll also need the following R packages:\n\n```{r}\ninstall.packages(c(\"shiny\", \"devtools\", \"usethis\", \"htmlwidgets\", \"reactR\"))\n```\n\n## Scaffolding\n\nTo create a new widget you can call `scaffoldReactWidget` to generate the basic structure and build configuration. This function will:\n\n* Create the .R, .js, .yaml, and .json files required by your widget;\n* If provided, take an [npm](https://www.npmjs.com/) package name and version as a named list with `name` and `version` elements. For example, the npm package `foo` at version `^1.2.0` would be expressed as `list(name = \"foo\", version = \"^1.2.0\")`. The package, if provided, will be added to the new widget's `package.json` as a build dependency.\n\nThe following R code will create an R package named **sparklines**, then provide the templating for creating an htmlwidget powered by the `react-sparklines` npm package:\n\n```{r}\n# Create the R package\nusethis::create_package(\"~/sparklines\")\n# Inject the widget templating\nwithr::with_dir(\n \"~/sparklines\", \n reactR::scaffoldReactWidget(\"sparklines\", list(\"react-sparklines\" = \"^1.7.0\"), edit = FALSE)\n)\n```\n\n## Building and installing\n\n### Building the JavaScript\n\nThe next step is to navigate to the newly-created `sparklines` project and run the following R commands:\n\n```{r}\nsystem(\"yarn install\")\nsystem(\"yarn run webpack\")\n```\n\n* `yarn install` downloads all of the dependencies listed in `package.json` and creates a new file, `yarn.lock`. You should add this file to revision control. It will be updated whenever you change dependencies and run `yarn install`. **Note: you only need to run it after modifying package.json**. For further documentation on `yarn install`, see the [yarn documentation](https://classic.yarnpkg.com/en/docs/cli/install/).\n\n* `yarn run webpack` compiles the [ES2015](https://babeljs.io/docs/en/learn/) JavaScript source file at `srcjs/sparklines.js` into `inst/htmlwidgets/sparklines.js`. The later file is one actually used by the R package and includes all the relevant JavaScript dependencies in a version of JavaScript that most browsers understand. Note that, if you add `--mode=development` to the end of this command, it will include a [source map](https://firefox-source-docs.mozilla.org/devtools-user/debugger/how_to/use_a_source_map/index.html) is included with the compiled JavaScript, which makes JavaScript debugging much easier, but hopefully you won't need to do much of any JavaScript debugging.\n\n`yarn run webpack` is not strictly a `yarn` command. In fact, `yarn run` simply delegates to the [webpack](https://webpack.js.org/) program. Webpack's configuration is generated by `scaffoldReactWidget` in the file `webpack.config.js`, but you can always change this configuration and/or modify the `yarn run webpack` command to suit your needs.\n\n### Installing the R package\n\nNow that the widget's JavaScript is compiled, go ahead and install the R package:\n\n```{r}\ndevtools::document()\ndevtools::install(quick = TRUE)\n```\n\nAlternatively, in RStudio, you can use the keyboard shortcuts `Ctrl+Shift+D` and `Ctrl-Shift-B` to document and build the package. (On macOS, the shortcuts are `Cmd+Shift+D` and `Cmd+Shift+B`)\n\n## Run the included demo\n\nNow that the widget's JavaScript is compiled, and the R package is installed, run `app.R` to see a demo in action:\n\n```{r}\nshiny::runApp()\n```\n\nAlternatively, in RStudio, you can open `app.R` and press `Ctrl-Shift-Enter` (`Cmd-Shift-Enter` on macOS). You should see something like the following appear in the Viewer pane:\n\n![](./widget_app.jpg)\n\n## Authoring a React binding\n\nAt this point, we've built some scaffolding for an htmlwidget powered by React. Let's modify it to create an interface to the `react-sparklines` library. Authoring the interface requires some changes on both the JavaScript and R side, but most of the hard thinking will be in figuring how best to design your interface. To give you an example of how this could work, let's build an interface to the `Sparklines` component of the react-sparklines library.\n\n### First, outline an interface\n\n> Note that the examples in this section are just to demonstrate API possibilities and need not be pasted into any file.\n\nConsider the following example taken from the [react-sparklines documentation](http://borisyankov.github.io/react-sparklines/).\n\n```js\nimport React from 'react';\nimport { Sparklines } from 'react-sparklines';\n\n\n \n \n\n```\n\nYou have some choice in terms of how to design an R interface to this sort of React library, but usually it makes sense to have one function per component and have the arguments to that function feed into the properties of that React component. In other words, our goal is to create an R function that allows users of our package to recreate this example with the following code:\n\n```r\nlibrary(sparklines)\nsparklines(\n data = sampleData,\n sparklinesLine(color = \"#56b45d\"),\n sparklinesSpots(style = list(fill = \"#56b45d\"))\n)\n```\n\nThe following sections show how to implement this R interface from our scaffolded widget.\n\n### R implementation\n\nConsider the template that `reactR::scaffoldReactWidget()` provided for us:\n\n```{r}\nsparklines <- function(message, width = NULL, height = NULL, elementId = NULL) {\n \n # describe a React component to send to the browser for rendering.\n content <- htmltools::tag(\"div\", list(message))\n \n # create widget\n htmlwidgets::createWidget(\n name = 'sparklines',\n reactR::reactMarkup(content),\n width = width,\n height = height,\n package = 'sparklines',\n elementId = elementId\n )\n}\n```\n\nThis function is designed to simply display a message within an HTML div using **reactR** and **htmlwidgets**. The critical piece here that makes it all work is `reactR::reactMarkup()`. This function can prepare a payload containing a mix of HTML tags (constructed via `htmltools::tag()`), React components (constructed via `reactR::component()`), or character vectors in a such way that the **reactR** and **htmlwidgets** toolchain will understand and know how to render in the browser (assuming we've imported our React component appropriately, as we cover later). Thus, to send a `` react component instead of an HTML `
    `, we could simply change:\n\n```r\ncontent <- htmltools::tag(\"div\", list(message))\n```\n\nto\n\n```r\nreactR::component(\"Sparklines\", list(message))\n```\n\nRemember, though, that we'd like `` to consume a `data` property and also accept other valid components (e.g., ``, ``, etc) from this library as children. So, we could change the body and signature of `sparklines()` in the following way:\n\n```{r}\nsparklines <- function(data, ..., width = NULL, height = NULL) {\n \n # describe a React component to send to the browser for rendering.\n content <- reactR::component(\n \"Sparklines\",\n list(data = data, ...)\n )\n \n # create widget\n htmlwidgets::createWidget(\n name = 'sparklines',\n reactR::reactMarkup(content),\n width = width,\n height = height,\n package = 'sparklines'\n )\n}\n```\n\nAt this point, we define functions that make it easy for the user to create the other components by adding these to `R/sparklines.R`\n\n```{r}\n#' @export\nsparklinesLine <- function(...) {\n reactR::React$SparklinesLine(...)\n}\n\n#' @export\nsparklinesSpots <- function(...) {\n reactR::React$SparklinesSpots(...)\n}\n```\n\n### JavaScript changes\n\nIn order for the **reactR** toolchain to know how to render components from the 'react-sparklines' library, we need to register the React components on the JavaScript side. This can be done in the `srcjs/sparklines.js` file which currently looks like this:\n\n```{js}\nimport { reactWidget } from 'reactR';\n\nreactWidget('sparklines', 'output', {});\n```\n\nFirst, `reactWidget` is [imported](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import) from the `'reactR'` JavaScript module. This function will register the React components we want within the **reactR** and **htmlwidgets** toolchain. Note that the `'reactR'` JavaScript is an html dependency, but webpack is configured in `webpack.config.js` to consider it a module, so it's available to us here via `import` syntax.\n\nThen, there's a call to `reactWidget`, and we pass it three arguments:\n\n1. The name of the widget (`'sparklines'`)\n1. The type of the widget (`'output'`)\n1. The React components that should be exposed to the widget. In this template, we didn't have to include any because it's just rendering an HTML div. \n\nInstead of passing an empty object (`{}`) as the React components, we provide an object with all the components we need from the 'react-sparklines' module:\n\n```{js}\nimport { Sparklines, SparklinesLine, SparklinesSpots } from 'react-sparklines';\nimport { reactWidget } from 'reactR';\n\nreactWidget('sparklines', 'output', {\n Sparklines: Sparklines,\n SparklinesLine: SparklinesLine,\n SparklinesSpots: SparklinesSpots\n});\n```\n\n### Go for a spin\n\nNow that we've made the necessary changes to the JavaScript and R source code, it's time to compile the JavaScript and install the R package:\n\n```{r}\nsystem(\"yarn install\")\nsystem(\"yarn run webpack\")\ndevtools::document()\ndevtools::install()\nlibrary(sparklines)\nsparklines(rnorm(10), sparklinesLine())\n```\n\nThis should open up the `sparklines()` widget in your browser. If it does, congratulations, you created a React-based htmlwidget!\n\n### Shiny integration\n\nThe scaffolding template already provides the glue you need to get your **reactR** widget to render in **Shiny**. The two relevant functions are `renderSparklines()` and `sparklinesOutput()`. You shouldn't need to modify these functions — they should work out of the box. You will, however, want to modify the example **Shiny** app in the `app.R` file:\n\n```{r}\nlibrary(shiny)\nlibrary(sparklines)\n\nui <- fluidPage(\n titlePanel(\"Sparklines library\"),\n sliderInput(\"n\", label = \"Number of samples\", min = 2, max = 1000, value = 100),\n sparklinesOutput(\"myWidget\")\n)\n\nserver <- function(input, output, session) {\n output$myWidget <- renderSparklines({\n sparklines(\n rnorm(input$n),\n sparklinesLine()\n )\n })\n}\n\nshinyApp(ui, server)\n```\n\nNow, when you run `shiny::runApp()`, you should see your react-based htmlwidget rendering in **shiny** app!\n\n![](./widget_app_improved.jpg)\n\n## Further learning\n\nThis tutorial walked you through the steps taken you create an R interface to the react-sparklines library. The full example package is accessible at . Our intention is keep creating example packages under the organization, so head there if you'd like to see other examples of interfacing with React.\n" }, { "path": "vignettes/intro_inputs.Rmd", "content": "---\ntitle: \"Authoring inputs powered by React with reactR\"\nauthor:\n - Alan Dipert and Carson Sievert\ndate: \"`r Sys.Date()`\"\noutput: rmarkdown::html_vignette\nvignette: >\n %\\VignetteIndexEntry{Shiny inputs with reactR}\n %\\VignetteEngine{knitr::rmarkdown}\n %\\VignetteEncoding{UTF-8}\n---\n\n```{r, echo=FALSE, include=FALSE}\nknitr::opts_chunk$set(eval = FALSE)\n```\n\n[Shiny](https://shiny.posit.co/) comes with a large library of input\n[widgets](https://shiny.posit.co/r/gallery/widgets/widget-gallery/) for collecting\ninput from the user and conveying input data to R.\n\nIf you want a kind of input *not* provided by Shiny — like a color picker,\nor a different kind of slider — you've always been able to build your own.\nShiny's input system is\n[extensible](https://shiny.rstudio.com/articles/building-inputs.html). All\nthat's required is an understanding of certain conventions and a little custom\nJavaScript.\n\nreactR provides additional tools to ease the creation of new Shiny inputs\nimplemented using React. In the following tutorial, we will demonstrate these\ntools by implementing a new Shiny color picker input that wraps the\n[react-color](https://github.com/casesandberg/react-color) library.\n\n## Software pre-requisites\n\nIn order to develop a **reactR** Shiny input, you'll need to install R and\noptionally RStudio. If you're on Windows, you should also install\n[Rtools](https://cran.r-project.org/bin/windows/Rtools/).\n\n> For an excellent general introduction to R package concepts, check out the [R\n> packages](https://r-pkgs.org/) online book.\n\nIn addition, you'll need to install the following JavaScript tools on your\nmachine:\n\n* [Node.js](https://nodejs.org): JavaScript engine and runtime for development\n outside of browsers. Provides the `node` and `npm` commands.\n* [Yarn](https://classic.yarnpkg.com/en/): Command-line dependency management tool,\n provides the `yarn` command.\n\nTo follow along in this vignette, you'll also need the following R packages:\n\n```{r}\ninstall.packages(c(\"shiny\", \"devtools\", \"usethis\", \"reactR\"))\n```\n\n## Scaffolding\n\nTo create a new widget you can call `scaffoldReactShinyInput` to generate the basic\nstructure and build configuration. This function will:\n\n* Create the .R, .js, and .json files required by your input;\n* If provided, take an [npm](https://www.npmjs.com/) package name and version as\n a named list with `name` and `version` elements. For example, the npm package\n `foo` at version `^1.2.0` would be expressed as `list(name = \"foo\", version =\n \"^1.2.0\")`. The package, if provided, will be added to the new widget's\n `package.json` as a build dependency.\n\nThe following R code will create an R package named **colorpicker**, then\nprovide the templating for creating an input powered by the\n`react-color` library on npm:\n\n```{r}\n# Create the R package (rstudio=TRUE is recommended if you're not already comfortable with your terminal)\nusethis::create_package(\"~/colorpicker\", rstudio = TRUE)\n# Scaffold initial input implementation files\nwithr::with_dir(\n \"~/colorpicker\",\n reactR::scaffoldReactShinyInput(\"colorpicker\", list(\"react-color\" = \"^2.17.0\"), edit = FALSE)\n)\n```\n\n\n## Building and installing\n\n### Building the JavaScript\n\nThe next step is to navigate to the newly-created `colorpicker` project and run\nthe following commands in the terminal. If you're new the terminal, we recommend opening your newly created RStudio `~/colorpicker/colorpicker.Rproj` project file, then running the following in the RStudio terminal tab:\n\n```\nyarn install\nyarn run webpack\n```\n\n* `yarn install` downloads all of the dependencies listed in `package.json` and\n creates a new file, `yarn.lock`. You should add this file to revision control.\n It will be updated whenever you change dependencies and run `yarn install`.\n **Note: you only need to run it after modifying package.json**. For further\n documentation on `yarn install`, see the [yarn\n documentation](https://classic.yarnpkg.com/en/docs/cli/install/).\n\n* `yarn run webpack` compiles the [modern JavaScript](https://babeljs.io/docs/en/babel-preset-env) \n with [JSX](https://babeljs.io/docs/en/babel-preset-react) source file at `srcjs/colorpicker.jsx` into\n `www/colorpicker/colorpicker/colorpicker.js`. The latter file is the one\n actually used by the R package and includes all the relevant JavaScript\n dependencies in a dialect of JavaScript that most browsers understand.\n\n`yarn run webpack` is not strictly a `yarn` command. In fact, `yarn run` simply\ndelegates to the [webpack](https://webpack.js.org/) program. Webpack's\nconfiguration is generated by `scaffoldReactShinyInput` in the file\n`webpack.config.js`, but you can always change this configuration and/or modify\nthe `yarn run webpack` command to suit your needs.\n\n### Installing the R package\n\nNow that the input's JavaScript is compiled, go ahead and install the R\npackage:\n\n```{r}\ndevtools::document()\ndevtools::install(quick = TRUE)\n```\n\nIn RStudio, you can use the keyboard shortcuts `Ctrl-Shift-D` and\n`Ctrl-Shift-B` to document and build the package. (On macOS, the shortcuts are\n`Cmd-Shift-D` and `Cmd-Shift-B`)\n\n## Run the included demo\n\nNow that the input's JavaScript is compiled, and the R package is installed,\nrun `app.R` to see a demo in action:\n\n```{r}\nshiny::runApp()\n```\n\nIn RStudio, you can open `app.R` and press `Ctrl-Shift-Enter`\n(`Cmd-Shift-Enter` on macOS). You should see something like the following appear\nin the Viewer pane:\n\n![](./input_app.jpg)\n\n## Authoring a React input\n\nAt this point, we have a working (if simple) React-powered text input.\nLet's modify it to create an interface to the `react-color` library.\n\n### Connecting Shiny with React\n\nConsider the following example taken from the [react-color\ndocumentation](http://casesandberg.github.io/react-color/).\n\n```js\nimport React from 'react';\nimport { SketchPicker } from 'react-color';\n\nclass Component extends React.Component {\n\n render() {\n return ;\n }\n}\n```\n\nThat JavaScript code produces a `SketchPicker`-type interface that looks like\nthis:\n\n![](./input_sketchpicker.jpg)\n\nHowever, that example doesn't demonstrate a way to default to a particular\ncolor, or a way to cause something to happen when the color changes. To\naccomplish these, `react-color` components can [optionally\ntake](http://casesandberg.github.io/react-color/#api) the following\n[props](https://reactjs.org/docs/components-and-props.html):\n\n* [`color`](http://casesandberg.github.io/react-color/#api-color): accepts a \n string of a hex color like `'#333'`\n* [`onChangeComplete`](http://casesandberg.github.io/react-color/#api-onChangeComplete): \n accepts a JavaScript function taking a single argument, the new `color`, that \n will be called when the new color is selected\n\nSince this React component calls a configurable function (i.e., `onChangeComplete`) when the input (i.e., color) value changes, we can supply a function to inform Shiny about these changes. You could, in theory, do this by writing your own custom Shiny input wrapper around this component, but `reactR` provides some conventions to make it much easier. These conventions have two main parts (R and JavaScript):\n\n1. Use `reactR::createReactShinyInput()` to construct the user-facing R input and route any user-supplied options (e.g., the `default` input value and other `configuration`) to the React component. This part was already done for us in the `R/colorpicker.R` file of our colorpicker project:\n\n```r\ncolorpickerInput <- function(inputId, default = \"\") {\n reactR::createReactShinyInput(\n inputId = inputId,\n class = \"colorpicker\",\n dependencies = htmltools::htmlDependency(\n name = \"colorpicker-input\",\n version = \"1.0.0\",\n src = \"www/colorpicker/colorpicker\",\n package = \"colorpicker\",\n script = \"colorpicker.js\"\n ),\n default = default,\n configuration = list(),\n container = htmltools::tags$span\n )\n}\n```\n\n2. Design an *intermediate* React component that routes information from `colorpickerInput()` to the `` component and also inform Shiny when a new color is chosen. This intermediate component should be a [functional component](https://reactjs.org/docs/components-and-props.html#function-and-class-components) with three arguments:\n\n* `configuration`: The JSON equivalent of the `configuration` argument from `reactR::createReactShinyInput()`. In this particular example, `configuration` isn't used.\n* `value`: The input's values over time, beginning with the `default` supplied from `reactR::createReactShinyInput()`.\n* `setValue`: A JavaScript function to call with the input's new value when one is created. This function is not user supplied, but rather an internal hook for informing Shiny about changes to the component's current state (i.e. value). \n\nConsider the following intermediate component, `PickerInput`. Note how this intermediate component allows one to set the default `value` from R and also calls `setValue()` inside `onChangeComplete` in order to inform Shiny about new color values. Finally, `reactR.reactShinyInput()` registers this intermediate component as a custom Shiny input binding named `colorpicker`.\n\n```js\nimport { reactShinyInput } from 'reactR';\nimport { SketchPicker } from 'react-color';\n\nconst PickerInput = ({ configuration, value, setValue }) => {\n return (\n setValue(color.hex) }\n />\n );\n};\n\n// Note the first argument here should match the `class` \n// argument of the reactR::createReactShinyInput() from step 1\nreactShinyInput('.colorpicker', 'colorpicker', PickerInput);\n```\n\nOpen the `srcjs/colorpicker.jsx` file in your colorpicker project and paste this code into it. After saving the file, run `yarn run webpack` in the terminal, re-install the\npackage, then run `shiny::runApp()` again\n\n\n\nWhen you select new colors, you should see the `textOutput` update accordingly.\n\nYou might have noticed that the input showed up initially without a color\nselected. That's because in `app.R` we didn't supply a `default` argument to the\n`colorpickerInput` function inside our `ui`.\n\nTry replacing the call to `colorpickerInput` with this:\n`colorpickerInput(\"textInput\", default = \"#a76161\")`\n\nNow when you run the app, the color should start as a shade of red.\n\n## Further learning\n\nThis tutorial walked you through the steps taken to wrap the `react-color`\nlibrary in a Shiny input. The full example package is accessible at\n. Our intention is keep creating\nexample packages under the organization, so head\nthere if you'd like to see other examples of interfacing with React.\n" }, { "path": "vignettes/intro_reactR.Rmd", "content": "---\ntitle: \"Intro to reactR\"\nauthor: \"Kent Russell\"\ndate: \"`r Sys.Date()`\"\noutput: rmarkdown::html_vignette\nvignette: >\n %\\VignetteIndexEntry{Intro to reactR}\n %\\VignetteEngine{knitr::rmarkdown}\n %\\VignetteEncoding{UTF-8}\n---\n\n## Why reactR?\n\n[`react`](https://reactjs.org/) has become incredibly popular, and the ecosystem around `react` is robust. `reactR` aims to allow `R` users to more easily incorporate `react` and `JSX`.\n\n## Install\n\n```\ninstall.packages(\"reactR\")\n\n# for the latest development version\n# install from Github\n# devtools::install_github(\"timelyportfolio/reactR\")\n```\n\n## Quick Example\n\nLet's use `react` to render a simple `h1` HTML element below.\n\n
    \n\n```{r}\nlibrary(reactR)\nlibrary(htmltools)\n\nattachDependencies(\n tags$script(\n \"\n ReactDOM.render(\n React.createElement(\n 'h1',\n null,\n 'Powered by React'\n ),\n document.getElementById('react-heading-here')\n )\n \"\n ),\n html_dependency_react()\n)\n```\n\n## Blog Post\n\nFor more on how we can use R and React, see the blog post [React in R](https://www.jsinr.me/2017/11/19/react-in-r/). Also, there are many more examples in the Github repo at [inst/examples](https://github.com/react-R/reactR/tree/master/inst/examples).\n\n## Using JSX\n\n[`JSX`](https://reactjs.org/docs/jsx-in-depth.html) helps ease some of the burden caused by `React.createElement`. `reactR` provides a `babel_transform()` function to use `JSX`. Hopefully, in the future, we can convince RStudio to modify `htmltools` to work directly with `JSX` (see [issue](https://github.com/rstudio/htmltools/pull/72)).\n" }, { "path": "vite.config.js", "content": "import { resolve, join } from 'path';\nimport { defineConfig } from 'vite';\n\nexport default defineConfig({\n define: { 'process.env.NODE_ENV': '\"production\"' },\n build: {\n outDir: join(__dirname, \"inst/www/react-tools/\"),\n lib: {\n // Could also be a dictionary or array of multiple entry points\n entry: resolve(__dirname, 'srcjs/react-tools.js'),\n name: 'reactR',\n fileName: () => 'react-tools.js',\n formats: ['umd'],\n },\n rollupOptions: {\n external: ['react', 'react-dom', 'jquery', 'shiny'],\n output: {\n globals: {\n 'react': 'React',\n 'react-dom': 'ReactDOM',\n 'jquery': '$',\n 'shiny': 'Shiny'\n },\n },\n },\n },\n});\n" } ]