@cocreate/validation 1.22.0 → 2.0.0

package/CONTRIBUTING.md

@@ -1,19 +1,19 @@
 # Contributing to CoCreate-validation
 
-This project is work of [many contributors](https://github.com/CoCreate-app/CoCreate-validation/graphs/contributors).
-You're encouraged to submit [pull requests](https://github.com/CoCreate-app/CoCreate-validation/pulls),
-[propose features and discuss issues](https://github.com/CoCreate-app/CoCreate-validation/issues).
+This project is work of [many contributors](https://github.com/CoCreateJS/validation/graphs/contributors).
+You're encouraged to submit [pull requests](https://github.com/CoCreateJS/validation/pulls),
+[propose features and discuss issues](https://github.com/CoCreateJS/validation/issues).
 
 In the examples below, substitute your Github username for `contributor` in URLs.
 
 ## Fork the Project
 
-Fork the [project on Github](https://github.com/CoCreate-app/CoCreate-validation) and check out your copy.
+Fork the [project on Github](https://github.com/CoCreateJS/validation) and check out your copy.
 
 ```
 git clone https://github.com/contributor/CoCreate-validation.git
 cd CoCreate-validation
-git remote add upstream https://gitlab.com/cocreatejs/CoCreate-validation.git
+git remote add upstream https://github.com/CoCreateJS/validation.git
 ```
 
 ## Create a Topic Branch
@@ -75,7 +75,7 @@ git push origin my-feature-branch
 
 ## Make a Pull Request
 
-Go to [https://github.com/CoCreate-app/CoCreate-validation](https://github.com/CoCreate-app/CoCreate-validation) and select your feature branch.
+Go to [https://github.com/CoCreateJS/validation](https://github.com/CoCreateJS/validation) and select your feature branch.
 Click the 'Pull Request' button and fill out the form. Pull requests are usually reviewed within a few days.
 
 ## Rebase

package/README.md

@@ -1,28 +1,28 @@
 # CoCreate-validation
 
-A simple validation component in vanilla javascript. Easily configured using HTML5 attributes and/or JavaScript API. Take it for a spin in our [playground!](https://cocreate.app/docs/validation)
+A simple validation component in vanilla javascript. Easily configured using HTML5 attributes and/or JavaScript API. Take it for a spin in our [playground!](https://CoCreateJS.com/docs/validation)
 
-![min file size in bytes](https://img.badgesize.io/https://cdn.cocreate.app/validation/latest/CoCreate-validation.min.js?style=flat-square&label=minified&color=orange)
-![gzip file size in bytes](https://img.badgesize.io/https://cdn.cocreate.app/validation/latest/CoCreate-validation.min.js?compression=gzip&style=flat-square&label=gzip&color=yellow)
-![brotlifile size in bytes](https://img.badgesize.io/https://cdn.cocreate.app/validation/latest/CoCreate-validation.min.js?compression=brotli&style=flat-square&label=brotli)
-![GitHub latest release](https://img.shields.io/github/v/release/CoCreate-app/CoCreate-validation?style=flat-square)
-![GitHub](https://img.shields.io/github/license/CoCreate-app/CoCreate-validation?style=flat-square)
+![min file size in bytes](https://img.badgesize.io/https://cdn.CoCreateJS.com/validation/latest/CoCreate-validation.min.js?style=flat-square&label=minified&color=orange)
+![gzip file size in bytes](https://img.badgesize.io/https://cdn.CoCreateJS.com/validation/latest/CoCreate-validation.min.js?compression=gzip&style=flat-square&label=gzip&color=yellow)
+![brotlifile size in bytes](https://img.badgesize.io/https://cdn.CoCreateJS.com/validation/latest/CoCreate-validation.min.js?compression=brotli&style=flat-square&label=brotli)
+![GitHub latest release](https://img.shields.io/github/v/release/CoCreateJS/validation?style=flat-square)
+![GitHub](https://img.shields.io/github/license/CoCreateJS/validation?style=flat-square)
 ![GitHub](https://img.shields.io/static/v1?style=flat-square&label=&message=Hiring&color=blueviolet)
 
-![CoCreate-validation](https://cdn.cocreate.app/docs/CoCreate-validation.gif)
+![CoCreate-validation](https://cdn.CoCreateJS.com/docs/CoCreate-validation.gif)
 
-## [Docs & Demo](https://cocreate.app/docs/validation)
+## [Docs & Demo](https://CoCreateJS.com/docs/validation)
 
-For a complete guide and working demo refer to the [doumentation](https://cocreate.app/docs/validation)
+For a complete guide and working demo refer to the [doumentation](https://CoCreateJS.com/docs/validation)
 
 ## CDN
 
 ```html
-<script src="https://cdn.cocreate.app/validation/latest/CoCreate-validation.min.js"></script>
+<script src="https://cdn.CoCreateJS.com/validation/latest/CoCreate-validation.min.js"></script>
 ```
 
 ```html
-<script src="https://cdn.cocreate.app/validation/latest/CoCreate-validation.min.css"></script>
+<script src="https://cdn.CoCreateJS.com/validation/latest/CoCreate-validation.min.css"></script>
 ```
 
 ## NPM
@@ -50,13 +50,13 @@ $ yarn install @cocreate/validation
 
 # Announcements
 
-All updates to this library are documented in our [CHANGELOG](https://github.com/CoCreate-app/CoCreate-validation/blob/master/CHANGELOG.md) and [releases](https://github.com/CoCreate-app/CoCreate-validation/releases). You may also subscribe to email for releases and breaking changes.
+All updates to this library are documented in our [CHANGELOG](https://github.com/CoCreateJS/validation/blob/master/CHANGELOG.md) and [releases](https://github.com/CoCreateJS/validation/releases). You may also subscribe to email for releases and breaking changes.
 
 <a name="roadmap"></a>
 
 # Roadmap
 
-If you are interested in the future direction of this project, please take a look at our open [issues](https://github.com/CoCreate-app/CoCreate-validation/issues) and [pull requests](https://github.com/CoCreate-app/CoCreate-validation/pulls). We would love to hear your feedback.
+If you are interested in the future direction of this project, please take a look at our open [issues](https://github.com/CoCreateJS/validation/issues) and [pull requests](https://github.com/CoCreateJS/validation/pulls). We would love to hear your feedback.
 
 <a name="about"></a>
 
@@ -64,7 +64,7 @@ If you are interested in the future direction of this project, please take a loo
 
 CoCreate-validation is guided and supported by the CoCreate Developer Experience Team.
 
-Please Email the Developer Experience Team [here](mailto:develop@cocreate.app) in case of any queries.
+Please Email the Developer Experience Team [here](mailto:develop@CoCreateJS.com) in case of any queries.
 
 CoCreate-validation is maintained and funded by CoCreate. The names and logos for CoCreate are trademarks of CoCreate, LLC.
 
@@ -72,9 +72,9 @@ CoCreate-validation is maintained and funded by CoCreate. The names and logos fo
 
 # How to Contribute
 
-We encourage contribution to our libraries (you might even score some nifty swag), please see our [CONTRIBUTING](https://github.com/CoCreate-app/CoCreate-validation/blob/master/CONTRIBUTING.md) guide for details.
+We encourage contribution to our libraries (you might even score some nifty swag), please see our [CONTRIBUTING](https://github.com/CoCreateJS/validation/blob/master/CONTRIBUTING.md) guide for details.
 
-We want this library to be community-driven, and CoCreate led. We need your help to realize this goal. To help make sure we are building the right things in the right order, we ask that you create [issues](https://github.com/CoCreate-app/CoCreate-validation/issues) and [pull requests](https://github.com/CoCreate-app/CoCreate-validation/pulls) or merely upvote or comment on existing issues or pull requests.
+We want this library to be community-driven, and CoCreate led. We need your help to realize this goal. To help make sure we are building the right things in the right order, we ask that you create [issues](https://github.com/CoCreateJS/validation/issues) and [pull requests](https://github.com/CoCreateJS/validation/pulls) or merely upvote or comment on existing issues or pull requests.
 
 We appreciate your continued support, thank you!
 
@@ -84,9 +84,9 @@ We appreciate your continued support, thank you!
 
 This software is dual-licensed under the GNU Affero General Public License version 3 (AGPLv3) and a commercial license.
 
--   **Open Source Use**: For open-source projects and non-commercial use, this software is available under the AGPLv3. The AGPLv3 allows you to freely use, modify, and distribute this software, provided that all modifications and derivative works are also licensed under the AGPLv3. For the full license text, see the [LICENSE file](https://github.com/CoCreate-app/CoCreate-validation/blob/master/LICENSE).
+-   **Open Source Use**: For open-source projects and non-commercial use, this software is available under the AGPLv3. The AGPLv3 allows you to freely use, modify, and distribute this software, provided that all modifications and derivative works are also licensed under the AGPLv3. For the full license text, see the [LICENSE file](https://github.com/CoCreateJS/validation/blob/master/LICENSE).
 
--   **Commercial Use**: For-profit companies and individuals intending to use this software for commercial purposes must obtain a commercial license. The commercial license is available when you sign up for an API key on our [website](https://cocreate.app). This license permits proprietary use and modification of the software without the copyleft requirements of the AGPLv3. It is ideal for integrating this software into proprietary commercial products and applications.
+-   **Commercial Use**: For-profit companies and individuals intending to use this software for commercial purposes must obtain a commercial license. The commercial license is available when you sign up for an API key on our [website](https://CoCreateJS.com). This license permits proprietary use and modification of the software without the copyleft requirements of the AGPLv3. It is ideal for integrating this software into proprietary commercial products and applications.
 
 If you have not purchased a commercial license and intend to use this software for commercial purposes, you are required to sign up for an API key on our website.
 
@@ -108,7 +108,9 @@ Disabled controls and controls barred from native validation are skipped.
 `novalidate` on the form or `formnovalidate` on the action element skips the native
 checks; explicitly configured CoCreate rules still run.
 
-Custom `matches` and `unique` validators are awaited. Use native `required`,
+Custom `matches` validators are awaited. A `valid="false"` value marks the
+element invalid; `valid="true"` passes this rule. Validation writes its
+combined result to `validation` and `aria-invalid`. Use native `required`,
 `type="email"`, `pattern`, and `minlength`/`maxlength` attributes for browser
 constraints; the custom `email`, `subdomain`, and `length` attributes have been
 removed. Non-native elements need their own custom validation.

package/demo/index.html

@@ -14,7 +14,7 @@
     </head>
 
     <body>
-        <!--<script src="https://cdn.cocreate.app/validation/latest/CoCreate-validation.min.js"></script>-->
-        <script src="https://CoCreate.app/dist/CoCreate.js"></script>
+        <!--<script src="https://cdn.CoCreateJS.com/validation/latest/CoCreate-validation.min.js"></script>-->
+        <script src="https://CoCreateJS.com/dist/CoCreate.js"></script>
     </body>
 </html>

package/docs/index.html

@@ -9,7 +9,7 @@
 			rel="icon"
 			type="image/png"
 			sizes="32x32"
-			href="https://cocreate.app/images/favicon.ico" />
+			href="https://CoCreateJS.com/images/favicon.ico" />
 		<meta
 			name="description"
 			content="A simple HTML5 and pure javascript component. Easy configuration using HTML5 attributes or Javscript api and highly styleable." />
@@ -68,7 +68,7 @@
 					share-width="500"
 					share-media="https://via.placeholder.com/300/09f/fff.png">
 					<a
-						href="https://github.com/CoCreate-app/CoCreate-validation"
+						href="https://github.com/CoCreateJS/CoCreate-validation"
 						target="_blank"
 						class="margin-right:15px"
 						><i src="/assets/svg/github.svg"></i
@@ -112,7 +112,7 @@
 					<pre
 						class="margin-top:15px"><code class="language-javascript">npm install cocreate-validation</code></pre>
 					<p class="padding:10px_0px">Or you can use cdn link:</p>
-					<pre><code class="language-javascript">https://cdn.cocreate.app/js/CoCreate-validation.min.js</code></pre>
+					<pre><code class="language-javascript">https://cdn.CoCreateJS.com/js/CoCreate-validation.min.js</code></pre>
 
 					<h2
 						class="border-bottom:1px_solid_lightgrey margin-top:20px padding:5px_0px">
@@ -258,6 +258,6 @@
 				</div>
 			</div>
 		</main>
-		<script src="https://CoCreate.app/dist/CoCreate.js"></script>
+		<script src="https://CoCreateJS.com/dist/CoCreate.js"></script>
 	</body>
 </html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocreate/validation",
-  "version": "1.22.0",
+  "version": "2.0.0",
   "description": "A simple validation component in vanilla javascript. Easily configured using HTML5 attributes and/or JavaScript API.",
   "keywords": [
     "validation",
@@ -22,17 +22,17 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.com/cocreatejs/CoCreate-validation.git"
+    "url": "git+https://github.com/CoCreateJS/validation.git"
   },
   "author": "CoCreate LLC",
   "license": "AGPL-3.0",
   "bugs": {
-    "url": "https://github.com/CoCreate-app/CoCreate-validation/issues"
+    "url": "https://github.com/CoCreateJS/validation/issues"
   },
-  "homepage": "https://cocreate.app/docs/validation",
+  "homepage": "https://CoCreateJS.com/docs/validation",
   "funding": {
     "type": "GitHub Sponsors ❤",
-    "url": "https://github.com/sponsors/CoCreate-app"
+    "url": "https://github.com/sponsors/CoCreateJS"
   },
   "main": "./src/index.js",
   "dependencies": {

package/src/index.js

@@ -10,14 +10,35 @@ import "@cocreate/element-prototype";
 import { render } from "@cocreate/render";
 import { clearError, errorTargets, renderErrors } from "./messages.js";
 import { matches } from "./validations/matches.js";
-import { unique } from "./validations/unique.js";
 import { value } from "./validations/value.js";
 
+/**
+ *
+ * @public
+ * @environment client
+ */
 const validations = new Map();
 validations.set("matches", matches);
-validations.set("unique", unique);
+validations.set("valid", validState);
 validations.set("validate", value);
 
+function validState(elements, report = renderErrors) {
+    const failedElements = elements.filter(element => element.getAttribute("valid") === "false");
+
+    if (failedElements.length) {
+        report({
+            data: failedElements.map(element => ({
+                type: "valid",
+                status: "error",
+                success: false,
+                message: element.validationMessage || "This value is not valid.",
+                elements: [element]
+            }))
+        });
+        return failedElements;
+    }
+}
+
 async function validate(action) {
     try {
         const selectors = [...validations.keys()].map(name => `[${name}]`).concat("[component][required]").join(", ");
@@ -90,7 +111,8 @@ async function validate(action) {
 }
 
 function markValidity(element, valid) {
-    element.setAttribute("validation", String(valid));
+    const state = String(valid);
+    element.setAttribute("validation", state);
     element.setAttribute("aria-invalid", String(!valid));
     if (valid) clearError(element);
 }
@@ -98,3 +120,83 @@ function markValidity(element, valid) {
 actions.init({ name: "validate", callback: validate });
 
 export default { validations };
+
+/**
+ *
+ * @name aria-errormessage
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ *
+ * @name aria-invalid
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ *
+ * @name match
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ *
+ * @name match-query
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ *
+ * @name required
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ *
+ * @name valid
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ *
+ * @name validation
+ * @kind member
+ * @attribute
+ * @environment client
+ */
+
+/**
+ * A simple validation component in vanilla javascript. Easily configured using HTML5 attributes and/or JavaScript API.
+ *
+ * @module validation
+ * @environment client
+ */
+
+/**
+ * Declarative selectors recognized by this module.
+ *
+ * @name declarative-selectors
+ * @kind member
+ * @selectors
+ * @environment client
+ * @example
+ * ```json
+ * [
+ *   "[template~=\"notification\"]",
+ *   "[match-query][match=\"false\"]",
+ *   "[valid=\"false\"]"
+ * ]
+ * ```
+ */

package/src/validations/unique.js

@@ -1,32 +0,0 @@
-import { errorTargets, renderErrors } from "../messages.js";
-
-export const unique = async (elements, report = renderErrors) => {
-    let failedElements = [];
-    for (let element of elements) {
-        let unique = element.getAttribute('unique');
-        if (unique === '')
-            unique = await CoCreate.unique.isUnique(element)
-        if (unique === 'false' || unique === false) {
-            failedElements.push(element);
-        }
-    }
-    if (failedElements.length) {
-        const unlinkedElements = failedElements.filter(
-            element => !errorTargets(element).length
-        );
-        if (unlinkedElements.length) {
-            report({
-                selector: '[template~="notification"]',
-                data: [{
-                    type: 'unique',
-                    status: 'error',
-                    success: false,
-                    message: 'One or more values are not unique',
-                    selector: '[unique="false"]',
-                    elements: unlinkedElements
-                }]
-            });
-        }
-        return failedElements;
-    }
-};