@fgv/ts-utils 5.0.2-0 → 5.1.0-0

package/dist/packlets/base/utils.js

@@ -64,6 +64,53 @@ export function omit(from, exclude) {
     }
     return rtrn;
 }
+/**
+ * Type-safe(ish) key extractor for typed records.
+ * @param obj - The record from which keys are to be extracted.
+ * @returns The keys of the record as an array.
+ * @public
+ */
+export function keysForRecord(obj) {
+    return Object.keys(obj);
+}
+/**
+ * Type-safe(ish) value extractor for typed records.
+ * @param obj - The record from which values are to be extracted.
+ * @returns The values of the record as an array.
+ * @public
+ */
+export function valuesForRecord(obj) {
+    return Object.values(obj);
+}
+/**
+ * Type-safe(ish) entries extractor for typed records.
+ * @param obj - The record from which entries are to be extracted.
+ * @returns The entries of the record as an array of `[key, value]` tuples.
+ * @public
+ */
+export function entriesForRecord(obj) {
+    return Object.entries(obj);
+}
+/**
+ * Type-safe(ish) record constructor from an iterable of `[key, value]` tuples.
+ * @param entries - The iterable of `[key, value]` tuples from which to construct the record.
+ * @returns A record constructed from the supplied entries.
+ * @public
+ */
+export function recordFromEntries(entries) {
+    return Object.fromEntries(entries);
+}
+/**
+ * Ensures the input is an array. If already an array, returns it as-is.
+ * If a single item, wraps it in an array.
+ * Preserves readonly status of input arrays.
+ * @param items - A single item or an array of items.
+ * @returns The input array unchanged, or a new array containing the single item.
+ * @public
+ */
+export function ensureArray(items) {
+    return (Array.isArray(items) ? items : [items]);
+}
 /**
  * Gets the value of a property specified by key from an arbitrary object,
  * or a default value if the property does not exist.