@gtkx/utils 0.21.0 → 1.0.0-rc.2

package/README.md

@@ -0,0 +1,173 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
+</p>
+
+<h1 align="center">GTKX</h1>
+
+<p align="center">
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
+</p>
+
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
+
+## Demo
+
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+
+```tsx
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
+import { useState } from "react";
+
+const Counter = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
+        valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
+      >
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
+```
+
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
+
+## Why GTKX
+
+### A declarative layer for the GNOME stack
+
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
+
+### The full GNOME API surface
+
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+
+### Why Node.js, and why generated bindings
+
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
+
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
+
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
+
+## Quick start
+
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+
+Scaffold a new app with the `create-gtkx` initializer:
+
+```sh
+npm create gtkx@rc
+```
+
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
+
+```sh
+cd my-app
+npm run dev
+```
+
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
+
+## Documentation
+
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
+
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
+
+## Requirements
+
+GTKX is Linux-only. You need:
+
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
+
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
+
+## License
+
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/dist/array/index-before-or-end.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Finds the index of the first item matching `before`, or `list.length` when `before` is `null` or
+ * nothing matches. Use it to resolve where a new item should be inserted so it lands before the
+ * referenced one, defaulting to the end.
+ *
+ * @template T - The list item type.
+ * @template B - The reference value type.
+ * @param list - The list to search.
+ * @param before - The item to insert before, or `null` to target the end.
+ * @param isMatch - Called with each item and the non-null `before`; return `true` on a match.
+ * @returns The matched index, or `list.length`.
+ */
+declare const indexBeforeOrEnd: <T, B>(list: T[], before: B | null, isMatch: (item: T, before: B) => boolean) => number;
+export { indexBeforeOrEnd };
+//# sourceMappingURL=index-before-or-end.d.ts.map

package/dist/array/index-before-or-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-before-or-end.d.ts","sourceRoot":"","sources":["../../src/array/index-before-or-end.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,EAC1B,MAAM,CAAC,EAAE,EACT,QAAQ,CAAC,GAAG,IAAI,EAChB,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,KACzC,MAQF,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/array/index-before-or-end.js

@@ -0,0 +1,21 @@
+/**
+ * Finds the index of the first item matching `before`, or `list.length` when `before` is `null` or
+ * nothing matches. Use it to resolve where a new item should be inserted so it lands before the
+ * referenced one, defaulting to the end.
+ *
+ * @template T - The list item type.
+ * @template B - The reference value type.
+ * @param list - The list to search.
+ * @param before - The item to insert before, or `null` to target the end.
+ * @param isMatch - Called with each item and the non-null `before`; return `true` on a match.
+ * @returns The matched index, or `list.length`.
+ */
+const indexBeforeOrEnd = (list, before, isMatch) => {
+    if (before === null) {
+        return list.length;
+    }
+    const index = list.findIndex((item) => isMatch(item, before));
+    return index === -1 ? list.length : index;
+};
+export { indexBeforeOrEnd };
+//# sourceMappingURL=index-before-or-end.js.map

package/dist/array/index-before-or-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-before-or-end.js","sourceRoot":"","sources":["../../src/array/index-before-or-end.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,gBAAgB,GAAG,CACrB,IAAS,EACT,MAAgB,EAChB,OAAwC,EAClC,EAAE;IACR,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAE9D,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9C,CAAC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["/**\n * Finds the index of the first item matching `before`, or `list.length` when `before` is `null` or\n * nothing matches. Use it to resolve where a new item should be inserted so it lands before the\n * referenced one, defaulting to the end.\n *\n * @template T - The list item type.\n * @template B - The reference value type.\n * @param list - The list to search.\n * @param before - The item to insert before, or `null` to target the end.\n * @param isMatch - Called with each item and the non-null `before`; return `true` on a match.\n * @returns The matched index, or `list.length`.\n */\nconst indexBeforeOrEnd = <T, B>(\n    list: T[],\n    before: B | null,\n    isMatch: (item: T, before: B) => boolean,\n): number => {\n    if (before === null) {\n        return list.length;\n    }\n\n    const index = list.findIndex((item) => isMatch(item, before));\n\n    return index === -1 ? list.length : index;\n};\n\nexport { indexBeforeOrEnd };\n"]}

package/dist/array/index.d.ts

@@ -0,0 +1,6 @@
+export { indexBeforeOrEnd } from "./index-before-or-end.js";
+export { remove } from "./remove.js";
+export { sortStringsBy } from "./sort-strings-by.js";
+export { sortStrings } from "./sort-strings.js";
+export { uniqBy } from "./uniq-by.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/array/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/array/index.js

@@ -0,0 +1,6 @@
+export { indexBeforeOrEnd } from "./index-before-or-end.js";
+export { remove } from "./remove.js";
+export { sortStringsBy } from "./sort-strings-by.js";
+export { sortStrings } from "./sort-strings.js";
+export { uniqBy } from "./uniq-by.js";
+//# sourceMappingURL=index.js.map

package/dist/array/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { indexBeforeOrEnd } from \"./index-before-or-end.js\";\nexport { remove } from \"./remove.js\";\nexport { sortStringsBy } from \"./sort-strings-by.js\";\nexport { sortStrings } from \"./sort-strings.js\";\nexport { uniqBy } from \"./uniq-by.js\";\n"]}

package/dist/array/remove.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Removes the first strictly-equal (`===`) occurrence of `value` from `arr` in place.
+ *
+ * @template T - The type of the array elements.
+ * @param arr - The array to mutate.
+ * @param value - The value to remove.
+ *
+ * @example
+ * const items = ["a", "b", "c"];
+ * remove(items, "b"); // items is now ["a", "c"]
+ */
+declare function remove<T>(arr: T[], value: T): void;
+export { remove };
+//# sourceMappingURL=remove.d.ts.map

package/dist/array/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/array/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,iBAAS,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAM3C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/array/remove.js

@@ -0,0 +1,19 @@
+/**
+ * Removes the first strictly-equal (`===`) occurrence of `value` from `arr` in place.
+ *
+ * @template T - The type of the array elements.
+ * @param arr - The array to mutate.
+ * @param value - The value to remove.
+ *
+ * @example
+ * const items = ["a", "b", "c"];
+ * remove(items, "b"); // items is now ["a", "c"]
+ */
+function remove(arr, value) {
+    const index = arr.indexOf(value);
+    if (index !== -1) {
+        arr.splice(index, 1);
+    }
+}
+export { remove };
+//# sourceMappingURL=remove.js.map

package/dist/array/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/array/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,SAAS,MAAM,CAAI,GAAQ,EAAE,KAAQ;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;AACL,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["/**\n * Removes the first strictly-equal (`===`) occurrence of `value` from `arr` in place.\n *\n * @template T - The type of the array elements.\n * @param arr - The array to mutate.\n * @param value - The value to remove.\n *\n * @example\n * const items = [\"a\", \"b\", \"c\"];\n * remove(items, \"b\"); // items is now [\"a\", \"c\"]\n */\nfunction remove<T>(arr: T[], value: T): void {\n    const index = arr.indexOf(value);\n\n    if (index !== -1) {\n        arr.splice(index, 1);\n    }\n}\n\nexport { remove };\n"]}

package/dist/array/sort-strings-by.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns the items sorted by a string key using locale-aware comparison.
+ *
+ * @template T - The type of items being sorted.
+ * @param items - The items to sort.
+ * @param key - Maps an item to the string its order is decided by.
+ * @returns A new array of the items in ascending locale order of their keys.
+ *
+ * @example
+ * sortStringsBy([{ name: "b" }, { name: "a" }], (item) => item.name);
+ * // [{ name: "a" }, { name: "b" }]
+ */
+declare function sortStringsBy<T>(items: Iterable<T>, key: (item: T) => string): T[];
+export { sortStringsBy };
+//# sourceMappingURL=sort-strings-by.d.ts.map

package/dist/array/sort-strings-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings-by.d.ts","sourceRoot":"","sources":["../../src/array/sort-strings-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE,CAE3E;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/array/sort-strings-by.js

@@ -0,0 +1,17 @@
+/**
+ * Returns the items sorted by a string key using locale-aware comparison.
+ *
+ * @template T - The type of items being sorted.
+ * @param items - The items to sort.
+ * @param key - Maps an item to the string its order is decided by.
+ * @returns A new array of the items in ascending locale order of their keys.
+ *
+ * @example
+ * sortStringsBy([{ name: "b" }, { name: "a" }], (item) => item.name);
+ * // [{ name: "a" }, { name: "b" }]
+ */
+function sortStringsBy(items, key) {
+    return [...items].toSorted((a, b) => key(a).localeCompare(key(b)));
+}
+export { sortStringsBy };
+//# sourceMappingURL=sort-strings-by.js.map

package/dist/array/sort-strings-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings-by.js","sourceRoot":"","sources":["../../src/array/sort-strings-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,SAAS,aAAa,CAAI,KAAkB,EAAE,GAAwB;IAClE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["/**\n * Returns the items sorted by a string key using locale-aware comparison.\n *\n * @template T - The type of items being sorted.\n * @param items - The items to sort.\n * @param key - Maps an item to the string its order is decided by.\n * @returns A new array of the items in ascending locale order of their keys.\n *\n * @example\n * sortStringsBy([{ name: \"b\" }, { name: \"a\" }], (item) => item.name);\n * // [{ name: \"a\" }, { name: \"b\" }]\n */\nfunction sortStringsBy<T>(items: Iterable<T>, key: (item: T) => string): T[] {\n    return [...items].toSorted((a, b) => key(a).localeCompare(key(b)));\n}\n\nexport { sortStringsBy };\n"]}

package/dist/array/sort-strings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the values sorted as strings using locale-aware comparison.
+ *
+ * @param values - The strings to sort.
+ * @returns A new array of the values in ascending locale order.
+ *
+ * @example
+ * sortStrings(["b", "a", "c"]); // ["a", "b", "c"]
+ */
+declare function sortStrings(values: Iterable<string>): string[];
+export { sortStrings };
+//# sourceMappingURL=sort-strings.d.ts.map

package/dist/array/sort-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings.d.ts","sourceRoot":"","sources":["../../src/array/sort-strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAEvD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/array/sort-strings.js

@@ -0,0 +1,14 @@
+/**
+ * Returns the values sorted as strings using locale-aware comparison.
+ *
+ * @param values - The strings to sort.
+ * @returns A new array of the values in ascending locale order.
+ *
+ * @example
+ * sortStrings(["b", "a", "c"]); // ["a", "b", "c"]
+ */
+function sortStrings(values) {
+    return [...values].toSorted((a, b) => a.localeCompare(b));
+}
+export { sortStrings };
+//# sourceMappingURL=sort-strings.js.map

package/dist/array/sort-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings.js","sourceRoot":"","sources":["../../src/array/sort-strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,MAAwB;IACzC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC","sourcesContent":["/**\n * Returns the values sorted as strings using locale-aware comparison.\n *\n * @param values - The strings to sort.\n * @returns A new array of the values in ascending locale order.\n *\n * @example\n * sortStrings([\"b\", \"a\", \"c\"]); // [\"a\", \"b\", \"c\"]\n */\nfunction sortStrings(values: Iterable<string>): string[] {\n    return [...values].toSorted((a, b) => a.localeCompare(b));\n}\n\nexport { sortStrings };\n"]}

package/dist/array/uniq-by.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Returns a new array of the unique elements of `arr`, keyed by the value the `mapper` returns.
+ *
+ * When two elements map to the same key the first occurrence is kept and later ones discarded,
+ * preserving first-seen order.
+ *
+ * @template T - The type of elements in the array.
+ * @param arr - The array to deduplicate.
+ * @param mapper - Maps an element to the key its uniqueness is decided by.
+ * @returns A new array containing only the first element seen for each distinct key.
+ *
+ * @example
+ * uniqBy([2.1, 1.2, 2.3], Math.floor); // [2.1, 1.2]
+ * uniqBy([{ id: "a" }, { id: "a" }, { id: "b" }], (item) => item.id); // [{ id: "a" }, { id: "b" }]
+ */
+declare function uniqBy<T>(arr: T[], mapper: (item: T, index: number, array: T[]) => unknown): T[];
+export { uniqBy };
+//# sourceMappingURL=uniq-by.d.ts.map

package/dist/array/uniq-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq-by.d.ts","sourceRoot":"","sources":["../../src/array/uniq-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,iBAAS,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,GAAG,CAAC,EAAE,CAezF;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/array/uniq-by.js

@@ -0,0 +1,29 @@
+/**
+ * Returns a new array of the unique elements of `arr`, keyed by the value the `mapper` returns.
+ *
+ * When two elements map to the same key the first occurrence is kept and later ones discarded,
+ * preserving first-seen order.
+ *
+ * @template T - The type of elements in the array.
+ * @param arr - The array to deduplicate.
+ * @param mapper - Maps an element to the key its uniqueness is decided by.
+ * @returns A new array containing only the first element seen for each distinct key.
+ *
+ * @example
+ * uniqBy([2.1, 1.2, 2.3], Math.floor); // [2.1, 1.2]
+ * uniqBy([{ id: "a" }, { id: "a" }, { id: "b" }], (item) => item.id); // [{ id: "a" }, { id: "b" }]
+ */
+function uniqBy(arr, mapper) {
+    const seen = new Map();
+    let index = 0;
+    for (const item of arr) {
+        const key = mapper(item, index, arr);
+        if (!seen.has(key)) {
+            seen.set(key, item);
+        }
+        index++;
+    }
+    return seen.values().toArray();
+}
+export { uniqBy };
+//# sourceMappingURL=uniq-by.js.map

package/dist/array/uniq-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq-by.js","sourceRoot":"","sources":["../../src/array/uniq-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,SAAS,MAAM,CAAI,GAAQ,EAAE,MAAuD;IAChF,MAAM,IAAI,GAAoB,IAAI,GAAG,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAErC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["/**\n * Returns a new array of the unique elements of `arr`, keyed by the value the `mapper` returns.\n *\n * When two elements map to the same key the first occurrence is kept and later ones discarded,\n * preserving first-seen order.\n *\n * @template T - The type of elements in the array.\n * @param arr - The array to deduplicate.\n * @param mapper - Maps an element to the key its uniqueness is decided by.\n * @returns A new array containing only the first element seen for each distinct key.\n *\n * @example\n * uniqBy([2.1, 1.2, 2.3], Math.floor); // [2.1, 1.2]\n * uniqBy([{ id: \"a\" }, { id: \"a\" }, { id: \"b\" }], (item) => item.id); // [{ id: \"a\" }, { id: \"b\" }]\n */\nfunction uniqBy<T>(arr: T[], mapper: (item: T, index: number, array: T[]) => unknown): T[] {\n    const seen: Map<unknown, T> = new Map();\n    let index = 0;\n\n    for (const item of arr) {\n        const key = mapper(item, index, arr);\n\n        if (!seen.has(key)) {\n            seen.set(key, item);\n        }\n\n        index++;\n    }\n\n    return seen.values().toArray();\n}\n\nexport { uniqBy };\n"]}

package/dist/class/any-class.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A constructor value of any (possibly abstract) class producing instances of `T`.
+ */
+type AnyClass<T extends object = object> = (abstract new (...args: never[]) => T) & {
+    prototype: T;
+};
+export { type AnyClass };
+//# sourceMappingURL=any-class.d.ts.map

package/dist/class/any-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-class.d.ts","sourceRoot":"","sources":["../../src/class/any-class.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,MAChD,GAAG,IAAI,EAAE,KAAK,EAAE,KACf,CAAC,CAAC,GAAG;IACN,SAAS,EAAE,CAAC,CAAC;CAChB,CAAC;AAEF,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC"}

package/dist/class/any-class.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=any-class.js.map

package/dist/class/any-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-class.js","sourceRoot":"","sources":["../../src/class/any-class.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,CAAC","sourcesContent":["/**\n * A constructor value of any (possibly abstract) class producing instances of `T`.\n */\ntype AnyClass<T extends object = object> = (abstract new (\n    ...args: never[]\n) => T) & {\n    prototype: T;\n};\n\nexport { type AnyClass };\n"]}

package/dist/class/get-parent-class.d.ts

@@ -0,0 +1,10 @@
+import type { AnyClass } from "./any-class.js";
+/**
+ * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.
+ *
+ * @param cls - The class whose prototype parent to inspect.
+ * @returns The parent class, or `null` when there is none.
+ */
+declare function getParentClass(cls: AnyClass): AnyClass | null;
+export { getParentClass };
+//# sourceMappingURL=get-parent-class.d.ts.map

package/dist/class/get-parent-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parent-class.d.ts","sourceRoot":"","sources":["../../src/class/get-parent-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAItD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/class/get-parent-class.js

@@ -0,0 +1,12 @@
+/**
+ * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.
+ *
+ * @param cls - The class whose prototype parent to inspect.
+ * @returns The parent class, or `null` when there is none.
+ */
+function getParentClass(cls) {
+    const parent = Object.getPrototypeOf(cls);
+    return typeof parent === "function" && parent !== Function.prototype ? parent : null;
+}
+export { getParentClass };
+//# sourceMappingURL=get-parent-class.js.map

package/dist/class/get-parent-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parent-class.js","sourceRoot":"","sources":["../../src/class/get-parent-class.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,SAAS,cAAc,CAAC,GAAa;IACjC,MAAM,MAAM,GAAY,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAEnD,OAAO,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAE,MAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type { AnyClass } from \"./any-class.js\";\n\n/**\n * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.\n *\n * @param cls - The class whose prototype parent to inspect.\n * @returns The parent class, or `null` when there is none.\n */\nfunction getParentClass(cls: AnyClass): AnyClass | null {\n    const parent: unknown = Object.getPrototypeOf(cls);\n\n    return typeof parent === \"function\" && parent !== Function.prototype ? (parent as AnyClass) : null;\n}\n\nexport { getParentClass };\n"]}

package/dist/class/index.d.ts

@@ -0,0 +1,4 @@
+export type { AnyClass } from "./any-class.js";
+export { getParentClass } from "./get-parent-class.js";
+export { walkClassChain } from "./walk-class-chain.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/class/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/class/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/class/index.js

@@ -0,0 +1,3 @@
+export { getParentClass } from "./get-parent-class.js";
+export { walkClassChain } from "./walk-class-chain.js";
+//# sourceMappingURL=index.js.map

package/dist/class/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/class/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export type { AnyClass } from \"./any-class.js\";\nexport { getParentClass } from \"./get-parent-class.js\";\nexport { walkClassChain } from \"./walk-class-chain.js\";\n"]}

package/dist/class/walk-class-chain.d.ts

@@ -0,0 +1,13 @@
+import type { AnyClass } from "./any-class.js";
+/**
+ * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and returning
+ * the first result that is not `undefined`.
+ *
+ * @template T - The type produced by the visitor.
+ * @param cls - The class to start from, or `null` to visit nothing.
+ * @param visit - Called with each class in the chain; a defined return value stops the walk.
+ * @returns The first defined result from `visit`, or `undefined` when none was produced.
+ */
+declare function walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined;
+export { walkClassChain };
+//# sourceMappingURL=walk-class-chain.d.ts.map

package/dist/class/walk-class-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-class-chain.d.ts","sourceRoot":"","sources":["../../src/class/walk-class-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;;;;;;GAQG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAc5G;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/class/walk-class-chain.js

@@ -0,0 +1,23 @@
+import { getParentClass } from "./get-parent-class.js";
+/**
+ * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and returning
+ * the first result that is not `undefined`.
+ *
+ * @template T - The type produced by the visitor.
+ * @param cls - The class to start from, or `null` to visit nothing.
+ * @param visit - Called with each class in the chain; a defined return value stops the walk.
+ * @returns The first defined result from `visit`, or `undefined` when none was produced.
+ */
+function walkClassChain(cls, visit) {
+    let current = cls;
+    while (current !== null) {
+        const result = visit(current);
+        if (result !== undefined) {
+            return result;
+        }
+        current = getParentClass(current);
+    }
+    return undefined;
+}
+export { walkClassChain };
+//# sourceMappingURL=walk-class-chain.js.map

package/dist/class/walk-class-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-class-chain.js","sourceRoot":"","sources":["../../src/class/walk-class-chain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;GAQG;AACH,SAAS,cAAc,CAAI,GAAoB,EAAE,KAA4C;IACzF,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type { AnyClass } from \"./any-class.js\";\nimport { getParentClass } from \"./get-parent-class.js\";\n\n/**\n * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and returning\n * the first result that is not `undefined`.\n *\n * @template T - The type produced by the visitor.\n * @param cls - The class to start from, or `null` to visit nothing.\n * @param visit - Called with each class in the chain; a defined return value stops the walk.\n * @returns The first defined result from `visit`, or `undefined` when none was produced.\n */\nfunction walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined {\n    let current = cls;\n\n    while (current !== null) {\n        const result = visit(current);\n\n        if (result !== undefined) {\n            return result;\n        }\n\n        current = getParentClass(current);\n    }\n\n    return undefined;\n}\n\nexport { walkClassChain };\n"]}

package/dist/error/error-like.d.ts

@@ -0,0 +1,6 @@
+declare function isErrorLike(value: unknown): value is {
+    message: string;
+};
+declare function readStream(value: unknown): string;
+export { isErrorLike, readStream };
+//# sourceMappingURL=error-like.d.ts.map

package/dist/error/error-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-like.d.ts","sourceRoot":"","sources":["../../src/error/error-like.ts"],"names":[],"mappings":"AAEA,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAEjE;AAED,iBAAS,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU1C;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}

package/dist/error/error-like.js

@@ -0,0 +1,15 @@
+import { isRecord } from "../predicate/is-record.js";
+function isErrorLike(value) {
+    return isRecord(value) && "message" in value && typeof value.message === "string";
+}
+function readStream(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {
+        return value.toString();
+    }
+    return "";
+}
+export { isErrorLike, readStream };
+//# sourceMappingURL=error-like.js.map

package/dist/error/error-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-like.js","sourceRoot":"","sources":["../../src/error/error-like.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,SAAS,WAAW,CAAC,KAAc;IAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import { isRecord } from \"../predicate/is-record.js\";\n\nfunction isErrorLike(value: unknown): value is { message: string } {\n    return isRecord(value) && \"message\" in value && typeof value.message === \"string\";\n}\n\nfunction readStream(value: unknown): string {\n    if (typeof value === \"string\") {\n        return value;\n    }\n\n    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {\n        return value.toString();\n    }\n\n    return \"\";\n}\n\nexport { isErrorLike, readStream };\n"]}

package/dist/error/error-message.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extracts a human-readable message from an unknown thrown value, falling back to its string form.
+ *
+ * @param error - The caught value to describe.
+ * @returns The value's message when it has one, otherwise its string form.
+ *
+ * @example
+ * errorMessage(new Error("boom")); // "boom"
+ * errorMessage(42); // "42"
+ */
+declare function errorMessage(error: unknown): string;
+export { errorMessage };
+//# sourceMappingURL=error-message.d.ts.map

package/dist/error/error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../../src/error/error-message.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,iBAAS,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/error/error-message.js

@@ -0,0 +1,16 @@
+import { isErrorLike } from "./error-like.js";
+/**
+ * Extracts a human-readable message from an unknown thrown value, falling back to its string form.
+ *
+ * @param error - The caught value to describe.
+ * @returns The value's message when it has one, otherwise its string form.
+ *
+ * @example
+ * errorMessage(new Error("boom")); // "boom"
+ * errorMessage(42); // "42"
+ */
+function errorMessage(error) {
+    return Error.isError(error) || isErrorLike(error) ? error.message : String(error);
+}
+export { errorMessage };
+//# sourceMappingURL=error-message.js.map