frontacles 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -10,9 +10,17 @@ Nothing for now.
 
 Compare with [last published version](https://github.com/frontacles/frontacles/compare/0.2.0...main).
 
-## v1.4.0 (2025-02-28)
+## v0.2.1 (2025-02-28)
 
-Compare with [previous version](https://github.com/frontacles/frontacles/compare/dda10c3...0.2).
+Compare with [previous version](https://github.com/frontacles/frontacles/compare/0.2.0...0.2.1).
+
+### Improved
+
+- `Email` is now a couple of bytes lighter.
+
+## v0.2.0 (2025-02-28)
+
+Compare with [previous version](https://github.com/frontacles/frontacles/compare/dda10c3...0.2.0).
 
 ### New
 

package/README.md

@@ -7,7 +7,7 @@ Cool utilities for front-end development (and potentially for Node).
 
 ## Email
 
-A class to instantiate an `Email` object or validate emails.
+A class to instantiate an `Email` object or validate emails. It’s only [222 B compressed](https://bundlejs.com/?q=frontacles&treeshake=[{Email}]&config={%22compression%22%3A%22brotli%22}&bundle).
 
 Unlike most libraries using [RegEx for emails](https://github.com/colinhacks/zod/blob/e2b9a5f9ac67d13ada61cd8e4b1385eb850c7592/src/types.ts#L648-L663) (and prone to [bugs](https://github.com/colinhacks/zod/issues/3913)), Frontacles `Email` class relies on the same mechanism as your browser to validate email addresses, making it robust, and very likely RFC compliant.
 
@@ -17,11 +17,11 @@ import { Email } from 'frontacles/url/email'
 const email = new Email('someone@domain.tld')
 ```
 
-Get the username and the host separately.
+Get the username and the hostname separately.
 
 ```js
 email.username // 'someone'
-email.host // 'domain.tld'
+email.hostname // 'domain.tld'
 ```
 
 Turn the email object into a string by using it along another string, or use `toString`.
@@ -53,3 +53,27 @@ const alsoEmail = new Email(email) // ✅ a new Email object!
 
 Email.canParse(email) // ✅ true
 ```
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/frontacles/frontacles/blob/main/CHANGELOG.md) or the [releases](https://github.com/frontacles/frontacles/releases).
+
+## Browser and tooling support
+
+`frontacles` is provided [as module](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules#browser_compatibility) for [modern browsers usage](https://github.com/frontacles/frontacles/blob/main/browserslist) with standard JavaScript syntax:
+- it is up to you to transpile it for legacy browsers;
+- you can’t import it using `require('frontacles')`.
+
+[Read more about ESModules](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
+
+## Security
+
+See the [security policy](https://github.com/frontacles/frontacles/blob/main/SECURITY.md).
+
+## Contributing
+
+See the [contributing guidelines](https://github.com/frontacles/frontacles/blob/main/CONTRIBUTING.md).
+
+## License
+
+The _datetime-attribute_ package is open-sourced software licensed under the [DWTFYWTPL](https://github.com/frontacles/frontacles/blob/main/LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontacles",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Front-end utilities for artisans",
   "type": "module",
   "sideEffects": false,

package/src/url/email.js

@@ -18,8 +18,8 @@ export class Email extends URL {
    *
    * In `username@domain.tld`, it is `domain.tld`.
    */
-  get host() {
-    return super.host
+  get hostname() {
+    return super.hostname
   }
 
   /**
@@ -32,7 +32,7 @@ export class Email extends URL {
   }
 
   toJSON () {
-    return `${this.username}@${this.host}`
+    return this.toString()
   }
 
   /**
@@ -41,18 +41,16 @@ export class Email extends URL {
    * situation where type casting to string is involved (`console.log`…).
    */
   toString () {
-    return `${this.username}@${this.host}`
+    return `${this.username}@${this.hostname}`
   }
 
   /**
-   * Recompose the email address and compare it to the input. We also make sure
-   * there is no port since `someone@domain.tld:3000` is valid for the `URL`
-   * constructor but adds `:{port}` to `this.host` (`domain.tld:3000`).
+   * Recompose the email address and compare it to the input.
    *
    * @param {string} address
    */
   #validate (address) {
-    return `${this.username}@${this.host}` == address && !this.port
+    return this.toString() == address
   }
 
   /**

package/types/index.d.ts

@@ -16,7 +16,7 @@ export class Email extends URL {
 	 *
 	 * In `username@domain.tld`, it is `domain.tld`.
 	 */
-	get host(): string;
+	get hostname(): string;
 	/**
 	 * The username of the email.
 	 *