survey-react-ui 1.9.74 → 1.9.76

package/README.md

@@ -1,6 +1,4 @@
-## **SurveyJS** is a JavaScript Survey and Form Library.
-
-**SurveyJS** is a modern way to add surveys and forms to your website. It has versions for Angular, jQuery, knockout, react and vue.
+# SurveyJS React Form Library
 
 [![Build Status](https://dev.azure.com/SurveyJS/SurveyJS%20Integration%20Tests/_apis/build/status/SurveyJS%20Library?branchName=master)](https://dev.azure.com/SurveyJS/SurveyJS%20Integration%20Tests/_build/latest?definitionId=7&branchName=master)
 [![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE)
@@ -14,203 +12,32 @@
 <img alt="Closed issues" title="Closed Issues" src="https://img.shields.io/github/issues-closed/surveyjs/survey-library.svg">
 </a>
 
-https://user-images.githubusercontent.com/22315929/218698798-22b095a7-c28b-42f7-baf8-6c56df8e1490.mp4
-
-## Documentation
-
-[SurveyJS Library Documentation](https://surveyjs.io/Documentation/Library)
-
-## Live Examples
-
-[SurveyJS Library Live Examples](https://surveyjs.io/Examples/Library)
-
-## Survey Creator / Form Builder
-
-[Create your Survey or Form now](https://surveyjs.io/create-survey)
-
-Survey Creator sources are [here](https://github.com/surveyjs/survey-creator)
-
-## Export Survey to PDF
-
-[Export to PDF overview](https://surveyjs.io/Overview/Survey-Pdf-Export)
-
-Export to PDF sources are [here](https://github.com/surveyjs/survey-pdf)
-
-## More info about SurveyJS
-
-**SurveyJS** is the most feature-rich Survey / Form Library available at the current moment. It can be easily customized and extended to suit your needs.
-
-![alt tag](https://cloud.githubusercontent.com/assets/22315929/22462339/ed33f60a-e7bd-11e6-942b-72882e6bf1db.gif)
-
-## Main Features
-
-### A lot of question types with a lot of built-in functionalities.
-
-* [Text Question](https://surveyjs.io/Examples/Library/?id=questiontype-text)
-* [Radigroup Question](https://surveyjs.io/Examples/Library/?id=questiontype-radiogroup)
-* [Dropdown Question](https://surveyjs.io/Examples/Library/?id=questiontype-dropdown)
-* [Checkboxes Question](https://surveyjs.io/Examples/Library/?id=questiontype-checkbox)
-* [Boolean Question](https://surveyjs.io/Examples/Library/?id=questiontype-boolean)
-* [Matrix Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrix)
-* [Matrix Rubric Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrix-rubric)
-* [Matrix Dropdown Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrixdropdown)
-* [Matrix Dynamic Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrixdynamic)
-* [Multiple Text Question](https://surveyjs.io/Examples/Library/?id=questiontype-multipletext)
-* [Rating Question](https://surveyjs.io/Examples/Library/?id=questiontype-rating)
-* [Ranking Question](https://surveyjs.io/Examples/Library?id=questiontype-ranking)
-* [Comment Question](https://surveyjs.io/Examples/Library/?id=questiontype-comment)
-* [Html Question](https://surveyjs.io/Examples/Library/?id=questiontype-html)
-* [Files uploading Question](https://surveyjs.io/Examples/Library/?id=questiontype-file)
-* [Panel Container](https://surveyjs.io/Examples/Library/?id=questiontype-panel)
-* [Panel Dynamic Question](https://surveyjs.io/Examples/Library/?id=questiontype-paneldynamic)
-* [Expression Question](https://surveyjs.io/Examples/Library/?id=questiontype-expression)
-* [Image Picker Question](https://surveyjs.io/Examples/Library/?id=questiontype-imagepicker)
-* [Support for third-party popular UI widgets](https://surveyjs.io/Examples/Library/?id=custom-widget-select2). The custom widgets [GitHub repo](https://github.com/surveyjs/widgets)
-
-### Multiple Pages Support
-
-You may create a very complex forms with a lot of pages, like [this one](https://surveyjs.io/Examples/Library/?id=real-patient-history).
-
-### Dynamically change survey logic and questions content
-
-* [Change questions visibility using logical expressions](https://surveyjs.io/Examples/Library/?id=condition-kids)
-* [Create custom functions to use it in expression](https://surveyjs.io/Examples/Library/?id=condition-customfunctions)
-* [Filter choices in checkbox, radiogroup and dropdown questions](https://surveyjs.io/Examples/Library/?id=condition-choicesVisibleIf)
-* [Filter rows and columns in matrix question](https://surveyjs.io/Examples/Library/?id=condition-matrixVisibleIf)
-* [Disabled/enabled questions based on logical expressions](https://surveyjs.io/Examples/Library/?id=condition-enable-kids)
-* [Questions value validation](https://surveyjs.io/Examples/Library/?id=validators-standard)
-
-### Localization and Multiple language support
-
-* [Localization for over 20 languages](https://surveyjs.io/Examples/Library/?id=survey-localization&platform)
-* [Multiple language support in one survey](https://surveyjs.io/Examples/Library/?id=survey-multilanguages)
-
-### Appearance and custom Rendering
-
-* [Seven built-in Themes](https://surveyjs.io/Examples/Library/?id=darkblue-theme)
-* [Bootstrap support](https://surveyjs.io/Examples/Library/?id=bootstrap-theme)
-* [CSS styles customization](https://surveyjs.io/Examples/Library/?id=survey-cssclasses)
-* [API for adding new or changing existing HTML elements](https://surveyjs.io/Examples/Library/?id=survey-afterrender)
-* [Render Questions in one line](https://surveyjs.io/Examples/Library/?id=survey-startwithnewline)
-* [Markdown support](https://surveyjs.io/Examples/Library/?id=survey-markdown-radiogroup)
-
-### Frequently used functionalities
-
-* [Quiz creation](https://surveyjs.io/Examples/Library/?id=survey-quiz)
-* [Show survey or form in the popup window](https://surveyjs.io/Examples/Library/?id=survey-window)
-* [Display mode](https://surveyjs.io/Examples/Library/?id=survey-displaymode)
-* [Custom navigation](https://surveyjs.io/Examples/Library/?id=survey-customnavigation)
-* [Sharing same data between questions](https://surveyjs.io/Examples/Library/?id=survey-shareddata)
-
-### To find out more about the library
-
-* go to the [SurveyJS Library Site](https://surveyjs.io/Library)
-* explore the live [Examples](https://www.surveyjs.io/Examples/Library)
-* and create a survey or form using [Survey Creator](https://surveyjs.io/survey/Builder/)
-
-#### You can use our quickstart repos:
-
-* [Angular CLI](https://github.com/surveyjs/surveyjs_angular_cli)
-* [React](https://github.com/surveyjs/surveyjs_react_quickstart)
-* [Vue](https://github.com/surveyjs/surveyjs_vue_quickstart)
-
-## Getting started
-
-Install the library using npm.
-
-Angular version:
-
-```
-npm install survey-angular
-```
-
-jQuery version:
-
-```
-npm install survey-jquery
-```
-
-Knockout version:
-
-```
-npm install survey-knockout
-```
-
-React version:
-
-```
-npm install survey-react
-```
-
-Vue version:
-
-```
-npm install survey-vue
-```
-
-Or use unpkg CDN:
-
-* https://unpkg.com/survey-angular@{version-number}/survey.angular.min.js
-* https://unpkg.com/survey-knockout@{version-number}/survey.ko.min.js
-* https://unpkg.com/survey-react@{version-number}/survey.react.min.js
-* https://unpkg.com/survey-jquery@{version-number}/survey.jquery.min.js
-* https://unpkg.com/survey-vue@{version-number}/survey.vue.min.js
-
-You find all versions/builds in the [surveyjs/build repo](https://github.com/surveyjs/builds).
-
-Or dowload a version as zip file from [Releases](https://github.com/surveyjs/survey-library/releases)
-
-If you want to import it in another script:
-
-```javascript
-import * as Survey from "survey-jquery";
-```
-
-## Building survey.js from sources
-
-To build library yourself:
-
-1.  **Clone the repo from GitHub**
-
-    ```
-    git clone https://github.com/surveyjs/survey-library.git
-    cd survey-library
-    ```
-
-2.  **Acquire build dependencies.** Make sure you have [Node.js](http://nodejs.org/) installed on your workstation. You need a version of Node.js greater than 6.0.0 and npm greater than 2.7.0. This is only needed to _build_ surveyjs from sources.
-
-    ```
-    npm install -g karma-cli
-    npm install
-    ```
-
-3.  **Build the library**
-
-    ```
-    npm run build_prod
-    ```
-
-    After that you should have the libraries (angular, jquery, knockout, react and vue) at 'packages' directory.
+A free and open-source MIT-licensed JavaScript form builder library that allows you to design dynamic, data-driven, multi-language survey forms and run them in your React applications.
 
-4.  **Run samples**
+## Features
 
-    ```
-    npm start
-    ```
+- Dynamic forms, surveys, polls, and quizzes for your JavaScript application
+- Integration with React, Angular, Vue, jQuery, and Knockout
+- 20+ built-in question types and support for custom question types
+- Built-in themes and CSS customization
+- Answer validation
+- TypeScript support
+- Community-supported UI localization to 50+ languages
+- Integration with any backend framework (examples for PHP, NodeJS, and ASP.NET included)
+- Compatibility with any server + database combination
+- Third-party component integration
 
-    This command will run local http server at the http://localhost:7777
-    You can open http://localhost:7777/examples/knockout to view KnockoutJS samples, http://localhost:7777/examples/react to view ReactJS samples and so on
+## Get Started
 
-5.  **Run unit tests**
-    ```
-    karma start
-    ```
-    This command will run unit tests using [Karma](https://karma-runner.github.io/0.13/index.html)
+To get started with SurveyJS React Form Library, refer to the following tutorial: [Add a Survey to a React Application](https://surveyjs.io/Documentation/Library?id=get-started-react).
 
-### WordPress integration
+## Resources
 
-[SurveyJS WordPress plugin](https://wordpress.org/plugins/surveyjs/)
+- [Website](https://surveyjs.io/)
+- [Documentation](https://surveyjs.io/Documentation/Library)
+- [Live Examples](https://surveyjs.io/form-library/examples/nps-question/reactjs)
+- [What's New](https://surveyjs.io/WhatsNew)
 
-## License
+## Licensing
 
-[MIT license](https://github.com/surveyjs/survey-library/blob/master/LICENSE)
+SurveyJS Form Library is distributed under the [MIT license](https://github.com/surveyjs/survey-library/blob/master/LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "survey-react-ui",
-  "version": "1.9.74",
+  "version": "1.9.76",
   "description": "survey.js is a JavaScript Survey Library. It is a modern way to add a survey to your website. It uses JSON for survey metadata and results.",
   "keywords": [
     "Survey",
@@ -25,7 +25,7 @@
   },
   "typings": "survey-react-ui.d.ts",
   "dependencies": {
-    "survey-core": "*",
+    "survey-core": "1.9.76",
     "react": "^16.5.0 || ^17.0.1 || ^18.1.0",
     "react-dom": "^16.5.0 || ^17.0.1 || ^18.1.0"
   }

package/survey-react-ui.d.ts

@@ -29,6 +29,18 @@ declare module "react/reactquestion_factory" {
         createQuestion(questionType: string, params: any): JSX.Element | null;
     }
 }
+declare module "react/components/character-counter" {
+    import { Base, CharacterCounter } from "survey-core";
+    import { SurveyElementBase } from "react/reactquestion_element";
+    export interface ICharacterCounterComponentProps {
+        counter: CharacterCounter;
+        remainingCharacterCounter: string;
+    }
+    export class CharacterCounterComponent extends SurveyElementBase<ICharacterCounterComponentProps, any> {
+        protected getStateElement(): Base;
+        renderElement(): JSX.Element | null;
+    }
+}
 declare module "react/reactquestion_comment" {
     import { ReactSurveyElement, SurveyQuestionUncontrolledElement } from "react/reactquestion_element";
     import { QuestionCommentModel } from "survey-core";
@@ -1067,15 +1079,33 @@ declare module "react/reactSurveyProgressButtons" {
         componentWillUnmount(): void;
     }
 }
+declare module "react/components/rating/rating-item" {
+    import { QuestionRatingModel, RenderedRatingItem } from "survey-core";
+    import { SurveyElementBase } from "react/reactquestion_element";
+    interface IRatingItemProps {
+        question: QuestionRatingModel;
+        data: RenderedRatingItem;
+        index: any;
+        handleOnClick: any;
+        isDisplayMode: boolean;
+    }
+    export class RatingItem extends SurveyElementBase<IRatingItemProps, any> {
+        get question(): QuestionRatingModel;
+        get item(): RenderedRatingItem;
+        get index(): any;
+        getStateElement(): RenderedRatingItem;
+        render(): JSX.Element | null;
+        componentDidMount(): void;
+    }
+}
 declare module "react/reactquestion_rating" {
     import { SurveyQuestionElementBase } from "react/reactquestion_element";
-    import { QuestionRatingModel, RenderedRatingItem } from "survey-core";
+    import { QuestionRatingModel } from "survey-core";
     export class SurveyQuestionRating extends SurveyQuestionElementBase {
         constructor(props: any);
         protected get question(): QuestionRatingModel;
         handleOnClick(event: any): void;
         protected renderElement(): JSX.Element;
-        protected renderItem(key: string, item: RenderedRatingItem, index: number, cssClasses: any): JSX.Element;
     }
 }
 declare module "react/rating-dropdown" {
@@ -1368,6 +1398,7 @@ declare module "entries/react-ui-model" {
     export { MatrixRow } from "react/components/matrix/row";
     export { Skeleton } from "react/components/skeleton";
     export { NotifierComponent } from "react/components/notifier";
+    export { CharacterCounterComponent } from "react/components/character-counter";
     export { SurveyLocStringViewer } from "react/string-viewer";
     export { SurveyLocStringEditor } from "react/string-editor";
 }