@regardio/js 1.0.2 → 1.1.0

package/README.md

@@ -1,26 +1,25 @@
 # @regardio/js
 
-> **TypeScript utilities for Regardio applications**
+> TypeScript utilities for Regardio applications.
 
-A collection of lightweight, tree-shakeable utility functions for common tasks
-like text manipulation, HTTP handling, internationalization, time formatting, and validation.
+A collection of small, tree-shakeable utilities for the everyday work of text, HTTP, internationalisation, time, and validation — the pieces you end up re-implementing in every project.
 
-## ⚠️ Pre-release Notice
+## Pre-release notice
 
-**This package is currently in pre-release (v0.x).** While we use these utilities in production across our own projects, the API may still change between minor versions. We recommend:
+This package is currently at v0.x. The utilities run in production across Regardio's own projects, but the API may still move between minor versions. A few habits that help:
 
-- Pinning to exact versions in your `package.json`
-- Reviewing changelogs before upgrading
-- Expecting potential breaking changes until v1.0
+- Pin to exact versions in `package.json`
+- Read the changelog before upgrading
+- Expect the occasional breaking change until v1.0
 
-## Why This Package?
+## What it's for
 
-We created `@regardio/js` to:
+`@regardio/js` exists so a handful of steady utilities don't have to be reinvented:
 
-- **Share battle-tested utilities** — These functions power real Regardio projects and have been refined through actual use
-- **Reduce boilerplate** — Common patterns like text formatting, cookie handling, language detection, and time formatting in one place
-- **Stay framework-agnostic** — Works with any JavaScript/TypeScript project (React, Node, Deno, etc.)
-- **Enable tree-shaking** — Import only what you need; unused utilities won't bloat your bundle
+- **Shared, well-used helpers** — these functions carry real Regardio projects and have been refined through actual use
+- **Less boilerplate** — text formatting, cookie handling, language detection, and time formatting collected in one place
+- **Framework-agnostic** — works with any JavaScript/TypeScript project (React, Node, Deno, and so on)
+- **Tree-shakeable** — import what's needed, leave the rest out of the bundle
 
 ## Installation
 
@@ -30,9 +29,9 @@ pnpm add @regardio/js
 
 ## Modules
 
-### @regardio/js/text
+### `@regardio/js/text`
 
-String manipulation and formatting utilities.
+String manipulation and formatting.
 
 ```ts
 import {
@@ -49,9 +48,9 @@ formatBytes(1500000); // "1.5 MB"
 parseAuthorString('John <john@example.com>'); // { name: 'John', email: 'john@example.com' }
 ```
 
-### @regardio/js/time
+### `@regardio/js/time`
 
-Date, time, and async utilities.
+Date, time, and async helpers.
 
 ```ts
 import {
@@ -68,17 +67,17 @@ await delay(1000); // Wait 1 second
 await measure('fetchData', () => fetch('/api')); // Logs timing
 ```
 
-### @regardio/js/http
+### `@regardio/js/http`
 
 HTTP, cookie, and routing utilities.
 
 ```ts
 import {
-  // Client-side cookies (async - Cookie Store API + fallback)
+  // Client-side cookies (async — Cookie Store API + fallback)
   getCookie,
   setCookie,
   deleteCookie,
-  // Client-side cookies (sync - document.cookie only)
+  // Client-side cookies (sync — document.cookie only)
   getCookieSync,
   setCookieSync,
   deleteCookieSync,
@@ -121,7 +120,7 @@ const domain = createDomain(request); // "https://example.com"
 isRouteActive('/account', '/account/settings', false); // true
 ```
 
-### @regardio/js/intl
+### `@regardio/js/intl`
 
 Server-side language detection for i18n.
 
@@ -136,9 +135,9 @@ const detector = new LanguageDetector({
 const locale = await detector.detect(request);
 ```
 
-### @regardio/js/assert
+### `@regardio/js/assert`
 
-Runtime assertion and validation utilities.
+Runtime assertions and validation.
 
 ```ts
 import { invariant, invariantResponse, verifyAccept } from '@regardio/js/assert';
@@ -148,7 +147,7 @@ invariantResponse(user, 'User not found', { status: 404 }); // Throws Response
 verifyAccept('image/png', 'image/*'); // true
 ```
 
-### @regardio/js/encoding
+### `@regardio/js/encoding`
 
 Binary encoding utilities.
 
@@ -158,7 +157,7 @@ import { urlBase64ToUint8Array } from '@regardio/js/encoding';
 const bytes = urlBase64ToUint8Array(vapidPublicKey);
 ```
 
-## Module Overview
+## Module overview
 
 | Module | Description |
 |--------|-------------|
@@ -171,17 +170,16 @@ const bytes = urlBase64ToUint8Array(vapidPublicKey);
 
 ## Contributing
 
-This package is primarily maintained for Regardio's internal use, but we welcome:
+The package is maintained primarily for Regardio's own work, but contributions from elsewhere are welcome:
 
 - Bug reports and fixes
 - Documentation improvements
-- Feature suggestions (though we may not implement all requests)
+- Feature suggestions (not every one will become an implementation)
 
 ## License
 
-**MIT License** — Free to use in commercial and open source projects.
+**MIT** — free to use in commercial and open-source projects.
 
 ---
 
-*Part of the [Regardio Ensemble](https://regard.io/ensemble) toolkit for
-shared well-being.*
+*Part of the [Regardio Ensemble](https://regard.io/ensemble) toolkit for shared well-being.*

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://www.schemastore.org/package.json",
   "name": "@regardio/js",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "private": false,
   "description": "Regardio JavaScript utilities",
   "keywords": [
@@ -66,9 +66,9 @@
     "@types/node": "25.6.0",
     "@vitest/coverage-v8": "4.1.5",
     "@vitest/ui": "4.1.5",
-    "tsdown": "0.21.9",
+    "tsdown": "0.21.10",
     "vitest": "4.1.5",
-    "@regardio/dev": "2.0.2"
+    "@regardio/dev": "2.1.0"
   },
   "scripts": {
     "build": "tsdown",