📝 update README.md.ts

🔥 remove `octal` (it's deprecated in strict mode). ✨ add `build`.
loucyx · May 22, 2024 · a606e54 · a606e54
1 parent 7f2cb44
commit a606e54
Show file tree

Hide file tree

Showing 33 changed files with 105 additions and 63 deletions.
diff --git a/packages/@lou.codes/ansi/README.md b/packages/@lou.codes/ansi/README.md
@@ -72,4 +72,4 @@ Import `@lou.codes/ansi` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fansi%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fansi%2Fpackage.json
diff --git a/packages/@lou.codes/constants/README.md b/packages/@lou.codes/constants/README.md
@@ -67,5 +67,5 @@ Import `@lou.codes/constants` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F@lou.codes/constants%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F@lou.codes/constants%2Fpackage.json
 [lou.codes]: https://lou.codes
diff --git a/packages/@lou.codes/create-package/CHANGELOG.md b/packages/@lou.codes/create-package/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Change log
 
+## 1.0.31
+
+### Patch Changes
+
+-   📝 update README.md.ts
+
 ## 1.0.30
 
 ### Patch Changes

diff --git a/packages/@lou.codes/create-package/package.json b/packages/@lou.codes/create-package/package.json
@@ -1,7 +1,7 @@
 {
 	"name": "@lou.codes/create-package",
 	"description": "🚧 lou.codes package scaffolder script",
-	"version": "1.0.30",
+	"version": "1.0.31",
 	"author": {
 		"email": "contact@lou.codes",
 		"name": "Lou Cyx",

diff --git a/packages/@lou.codes/create-package/src/templates/README.md.ts b/packages/@lou.codes/create-package/src/templates/README.md.ts
@@ -84,7 +84,7 @@ Import \`${answers.name}\` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F${
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F${
 		answers.name
 	}%2Fpackage.json
 [lou.codes]: https://lou.codes

diff --git a/packages/@lou.codes/cron/CHANGELOG.md b/packages/@lou.codes/cron/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Change log
 
+## 2.2.1
+
+### Patch Changes
+
+-   ⬆️ upgrade `functional-expression` to `v2.0.0`.
+
 ## 2.2.0
 
 ### Minor Changes

diff --git a/packages/@lou.codes/cron/README.md b/packages/@lou.codes/cron/README.md
@@ -137,4 +137,4 @@ readable("5 5 5 5 5"); // "At 5:05 AM, the 5th day of May on Friday"
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fcron%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fcron%2Fpackage.json
diff --git a/packages/@lou.codes/cron/package.json b/packages/@lou.codes/cron/package.json
@@ -1,7 +1,7 @@
 {
 	"name": "@lou.codes/cron",
 	"description": "⏲️ Cron Quartz and Cron UNIX expression parser",
-	"version": "2.2.0",
+	"version": "2.2.1",
 	"author": {
 		"email": "contact@lou.codes",
 		"name": "Lou Cyx",

diff --git a/packages/@lou.codes/cron/src/isValidExpression.ts b/packages/@lou.codes/cron/src/isValidExpression.ts
@@ -1,4 +1,5 @@
 import { match } from "@lou.codes/predicates";
+import { build } from "functional-expression";
 import type { CronString } from "./CronString.js";
 import { cronRegExp } from "./cronRegExp.js";
 
@@ -8,6 +9,6 @@ import { cronRegExp } from "./cronRegExp.js";
  * @category Cron String
  * @see {CronString}
  */
-export const isValidExpression = match(`/${cronRegExp}/iu`) as (
+export const isValidExpression = match(build("iu")(cronRegExp)) as (
 	string: string,
 ) => string is CronString;
diff --git a/packages/@lou.codes/cron/src/nextDates.ts b/packages/@lou.codes/cron/src/nextDates.ts
@@ -1,6 +1,7 @@
 import { EMPTY_STRING } from "@lou.codes/constants/empty.js";
 import { createIterableIterator } from "@lou.codes/iterables";
 import { isString, isUndefined } from "@lou.codes/predicates";
+import { DIGIT, build, escape, quantity } from "functional-expression";
 import type { CronObject } from "./CronObject.js";
 import type { CronString } from "./CronString.js";
 import { dateInCron } from "./dateInCron.js";
@@ -32,7 +33,16 @@ export const nextDates =
 			if (!isUndefined(cronObject)) {
 				const validDate = dateInCron(cronObject);
 				const now = new Date(
-					date.toISOString().replace(/\d{2}\.\d{3}/u, "00.000"),
+					date
+						.toISOString()
+						.replace(
+							build()(
+								quantity(2)(DIGIT),
+								escape("."),
+								quantity(3)(DIGIT),
+							),
+							"00.000",
+						),
 				);
 
 				// eslint-disable-next-line functional/no-loop-statements

diff --git a/packages/@lou.codes/cron/src/normalizeAliases.ts b/packages/@lou.codes/cron/src/normalizeAliases.ts
@@ -1,6 +1,6 @@
 import { keys } from "@lou.codes/constants/Object.js";
 import type { KeyOf, ReadOnlyArray } from "@lou.codes/types";
-import { or } from "functional-expression";
+import { build, or } from "functional-expression";
 import type { FieldString } from "./FieldString.js";
 import { normalizeMap } from "./normalizeMap.js";
 
@@ -17,13 +17,12 @@ import { normalizeMap } from "./normalizeMap.js";
  */
 export const normalizeAliases = (expression: string) =>
 	expression.replaceAll(
-		new RegExp(
+		build("giu")(
 			or(
 				...(keys(normalizeMap) as ReadOnlyArray<
 					KeyOf<typeof normalizeMap>
 				>),
 			),
-			"giu",
 		),
 		alias =>
 			`${normalizeMap[alias.toLocaleLowerCase() as KeyOf<typeof normalizeMap>]}`,

diff --git a/packages/@lou.codes/cron/src/parse.ts b/packages/@lou.codes/cron/src/parse.ts
@@ -1,5 +1,6 @@
 import { entriesToObject, length, objectToEntries } from "@lou.codes/iterables";
 import type { KeyOf, Maybe, ReadOnlyRecord } from "@lou.codes/types";
+import { build } from "functional-expression";
 import type { CronObject } from "./CronObject.js";
 import type { CronString } from "./CronString.js";
 import { cronRegExp } from "./cronRegExp.js";
@@ -28,7 +29,7 @@ import { parseFieldTuplesMap } from "./parseFieldTuplesMap.js";
 export const parse = (expression: CronString) => {
 	const entries = parseFieldTuplesMap(
 		objectToEntries(
-			(new RegExp(cronRegExp, "iu").exec(normalizeAliases(expression))
+			(build("iu")(cronRegExp).exec(normalizeAliases(expression))
 				?.groups ?? {}) as ReadOnlyRecord<KeyOf<CronObject>, string>,
 		),
 	);

diff --git a/packages/@lou.codes/diff/README.md b/packages/@lou.codes/diff/README.md
@@ -72,5 +72,5 @@ Import `@lou.codes/diff` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fdiff%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fdiff%2Fpackage.json
 [lou.codes]: https://lou.codes
diff --git a/packages/@lou.codes/iterables/README.md b/packages/@lou.codes/iterables/README.md
@@ -82,4 +82,4 @@ Import `@lou.codes/iterables` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fiterables%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fiterables%2Fpackage.json
diff --git a/packages/@lou.codes/math/README.md b/packages/@lou.codes/math/README.md
@@ -74,6 +74,6 @@ Import `@lou.codes/math` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F@lou.codes/math%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F@lou.codes/math%2Fpackage.json
 [lou.codes]: https://lou.codes
 [floating-point]: https://0.30000000000000004.com/
diff --git a/packages/@lou.codes/notify/README.md b/packages/@lou.codes/notify/README.md
@@ -99,5 +99,5 @@ Import `@lou.codes/notify` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fnotify%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fnotify%2Fpackage.json
 [lou.codes]: https://lou.codes
diff --git a/packages/@lou.codes/parsers/README.md b/packages/@lou.codes/parsers/README.md
@@ -79,4 +79,4 @@ Import `@lou.codes/parsers` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fparsers%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fparsers%2Fpackage.json
diff --git a/packages/@lou.codes/predicates/README.md b/packages/@lou.codes/predicates/README.md
@@ -78,4 +78,4 @@ Import `@lou.codes/predicates` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fpredicates%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fpredicates%2Fpackage.json
diff --git a/packages/@lou.codes/prompts/README.md b/packages/@lou.codes/prompts/README.md
@@ -109,6 +109,6 @@ exampleQuestion({
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fprompts%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Fprompts%2Fpackage.json
 [typedoc]: https://typedoc.org/
 [vscode]: https://code.visualstudio.com/
diff --git a/packages/@lou.codes/test/README.md b/packages/@lou.codes/test/README.md
@@ -283,7 +283,7 @@ it was pointed out in the previous section.
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Ftest%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Ftest%2Fpackage.json
 [riteway]: https://github.com/ericelliott/riteway
 [tsx]: https://npm.im/tsx
 [uvu]: https://github.com/lukeed/uvu
diff --git a/packages/@lou.codes/types/README.md b/packages/@lou.codes/types/README.md
@@ -51,6 +51,6 @@ import type { Unary } from "npm:@lou.codes/types";
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Ftypes%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Ftypes%2Fpackage.json
 [typescript]: https://www.typescriptlang.org/
 [lou.codes]: https://lou.codes
diff --git a/packages/@lou.codes/utils/README.md b/packages/@lou.codes/utils/README.md
@@ -75,6 +75,6 @@ Import `@lou.codes/utils` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Futils%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2F%40lou.codes%2Futils%2Fpackage.json
 [typescript]: https://typescriptlang.org/
 [lou.codes]: https://lou.codes
diff --git a/packages/functional-expression/CHANGELOG.md b/packages/functional-expression/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Change log
 
+## 2.0.0
+
+### Major Changes
+
+-   🔥 remove `octal` (it's deprecated in strict mode).
+-   ✨ add `build`.
+
 ## 1.0.3
 
 ### Patch Changes

diff --git a/packages/functional-expression/README.md b/packages/functional-expression/README.md
@@ -23,19 +23,19 @@ yarn add functional-expression
 Import it and use it:
 
 ```typescript
-import { group, or } from "functional-expression";
+import { build, group, or } from "functional-expression";
 
-group(or("this", "that")); // "(?:this|that)"
+build("gu")(group(or("this", "that"))); // /(?:this|that)/gu
 ```
 
 ### 🦕 Deno
 
 Import `functional-expression` using the `npm:` prefix, and use it directly:
 
 ```typescript
-import { group, or } from "npm:functional-expression";
+import { build, group, or } from "npm:functional-expression";
 
-group(or("this", "that")); // "(?:this|that)"
+build("gu")(group(or("this", "that"))); // /(?:this|that)/gu
 ```
 
 ### 🌎 Browser
@@ -44,9 +44,9 @@ Import `functional-expression` using [esm.sh][esm.sh], and use it directly:
 
 ```html
 <script type="module">
-	import { group, or } from "https://esm.sh/functional-expression";
+	import { build, group, or } from "https://esm.sh/functional-expression";
 
-	group(or("this", "that")); // "(?:this|that)"
+	build("gu")(group(or("this", "that"))); // /(?:this|that)/gu
 </script>
 ```
 
@@ -72,5 +72,5 @@ Import `functional-expression` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2Ffunctional-expression%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2Ffunctional-expression%2Fpackage.json
 [lou.codes]: https://lou.codes
diff --git a/packages/functional-expression/package.json b/packages/functional-expression/package.json
@@ -1,7 +1,7 @@
 {
 	"name": "functional-expression",
 	"description": "🧙 Functional Regular expression builder",
-	"version": "1.0.3",
+	"version": "2.0.0",
 	"author": {
 		"email": "contact@lou.codes",
 		"name": "Lou Cyx",

diff --git a/packages/functional-expression/src/build.ts b/packages/functional-expression/src/build.ts
@@ -0,0 +1,22 @@
+import type { EMPTY_STRING } from "@lou.codes/constants/empty.js";
+import type {
+	ReadOnlyArray,
+	RegularExpressionFlags,
+	Strigifiable,
+	StringJoin,
+} from "@lou.codes/types";
+import { join } from "./join.js";
+
+/**
+ * Builds a `RegExp` with required `u` flag and strongly typed source (using
+ * {@link join}).
+ *
+ * @category Util
+ */
+export const build =
+	<Flags extends RegularExpressionFlags = "u">(flags: Flags | "u" = "u") =>
+	<const Tokens extends ReadOnlyArray<Strigifiable>>(...tokens: Tokens) =>
+		new RegExp(join(...tokens), flags) as RegExp & {
+			readonly flags: Flags;
+			readonly source: StringJoin<Tokens, typeof EMPTY_STRING>;
+		};
diff --git a/packages/functional-expression/src/index.ts b/packages/functional-expression/src/index.ts
@@ -1,6 +1,7 @@
 export type { HexadecimalDigit } from "./HexadecimalDigit.js";
 export type { UppercaseLetters } from "./UppercaseLetters.js";
 export { allow } from "./allow.js";
+export { build } from "./build.js";
 export { capture } from "./capture.js";
 export { captureNamed } from "./captureNamed.js";
 export { captureNext } from "./captureNext.js";
@@ -36,7 +37,6 @@ export { notCaptureNext } from "./notCaptureNext.js";
 export { notCapturePrevious } from "./notCapturePrevious.js";
 export { notSet } from "./notSet.js";
 export { notUnicodeCharacterClassEscape } from "./notUnicodeCharacterClassEscape.js";
-export { octal } from "./octal.js";
 export { optional } from "./optional.js";
 export { or } from "./or.js";
 export { quantity } from "./quantity.js";

diff --git a/packages/functional-expression/src/octal.ts b/packages/functional-expression/src/octal.ts
diff --git a/packages/functional-expression/tests/build.test.ts b/packages/functional-expression/tests/build.test.ts
@@ -0,0 +1,19 @@
+import type { Tests } from "@lou.codes/test";
+import { build } from "../src/build.js";
+import { group } from "../src/group.js";
+import { or } from "../src/or.js";
+
+const regExp = /(?:13|foo)/u;
+const createdRegExp = build()(group(or(13, "foo")));
+
+export const buildTests = [
+	{
+		given: "a 1 and a 3",
+		must: "build strings as 13",
+		received: () => ({
+			flags: createdRegExp.flags,
+			source: createdRegExp.source,
+		}),
+		wanted: () => ({ flags: regExp.flags, source: regExp.source }),
+	},
+] satisfies Tests<Partial<RegExp>>;
diff --git a/packages/functional-expression/tests/octal.test.ts b/packages/functional-expression/tests/octal.test.ts
diff --git a/packages/preact-pair/README.md b/packages/preact-pair/README.md
@@ -144,4 +144,4 @@ Import `preact-pair` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2Fpreact-pair%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2Fpreact-pair%2Fpackage.json
diff --git a/packages/react-pair/README.md b/packages/react-pair/README.md
@@ -146,4 +146,4 @@ Import `react-pair` using [esm.sh][esm.sh], and use it directly:
 [open-issues-badge]:
 	https://img.shields.io/github/issues/loucyx/lou.codes.svg?label=Issues&labelColor=666&color=0a8
 [size-badge]:
-	https://img.shields.io/badge/dynamic/json?label=Size+(min%2Bbrotli)&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2Freact-pair%2Fpackage.json
+	https://img.shields.io/badge/dynamic/json?label=Bundle+Size&labelColor=666&color=0a8&suffix=KiB&query=%24.size&url=https%3A%2F%2Fraw.githubusercontent.com%2Floucyx%2Flou.codes%2Fmain%2Fpackages%2Freact-pair%2Fpackage.json