umt 2.5.0 → 2.6.0

package/module/es5/Object/pickDeep.d.ts

@@ -7,7 +7,7 @@ import type { PickDeepKey } from "$/object/pickDeepKey";
  * @template K - Type of property keys to select. Must be a subset of PickDeepKey<T>.
  * @param {T} object - The source object to extract properties from.
  * @param {...K[]} keys - Property keys to extract. Can use dot notation for nested properties.
- * @returns {PickDeep<T>} A new object containing only the specified properties.
+ * @returns {PickDeep<T, K>} A new object containing only the specified properties.
  *
  * @example
  * ```typescript
@@ -16,4 +16,4 @@ import type { PickDeepKey } from "$/object/pickDeepKey";
  * // picked will be { a: { b: { c: 1 } }, f: 4 }
  * ```
  */
-export declare const pickDeep: <T extends object, K extends PickDeepKey<T>>(object: T, ...keys: K[]) => PickDeep<T>;
+export declare const pickDeep: <T extends object, const K extends readonly PickDeepKey<T>[]>(object: T, ...keys: K) => PickDeep<T, K>;

package/module/es5/Object/pickDeep.js

@@ -24,7 +24,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * @template K - Type of property keys to select. Must be a subset of PickDeepKey<T>.
  * @param {T} object - The source object to extract properties from.
  * @param {...K[]} keys - Property keys to extract. Can use dot notation for nested properties.
- * @returns {PickDeep<T>} A new object containing only the specified properties.
+ * @returns {PickDeep<T, K>} A new object containing only the specified properties.
  *
  * @example
  * ```typescript
@@ -34,7 +34,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * ```
  */
 var pickDeep = exports.pickDeep = function pickDeep(object) {
-  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  // biome-ignore lint/suspicious/noExplicitAny: ignore
   var result = {};
   for (var _len = arguments.length, keys = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
     keys[_key - 1] = arguments[_key];
@@ -42,9 +42,9 @@ var pickDeep = exports.pickDeep = function pickDeep(object) {
   for (var _i = 0, _keys = keys; _i < _keys.length; _i++) {
     var key = _keys[_i];
     var parts = key.split(".");
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    // biome-ignore lint/suspicious/noExplicitAny: ignore
     var current = _objectSpread({}, object);
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    // biome-ignore lint/suspicious/noExplicitAny: ignore
     var target = result;
     var _iterator = _createForOfIteratorHelper(parts.entries()),
       _step;

package/module/es5/Simple/Date/dayOfWeekSimple.js

@@ -28,7 +28,7 @@ function dayOfWeekSimple(properties) {
   if (typeof properties === "string") {
     if (properties.includes(":")) {
       var _ref = properties.split(":")
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: ignore
         .map(Number),
         _ref2 = _slicedToArray(_ref, 3),
         _year = _ref2[0],
@@ -42,7 +42,7 @@ function dayOfWeekSimple(properties) {
     }
     if (properties.includes("/")) {
       var _ref3 = properties.split("/")
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: ignore
         .map(Number),
         _ref4 = _slicedToArray(_ref3, 3),
         _year2 = _ref4[0],
@@ -55,7 +55,7 @@ function dayOfWeekSimple(properties) {
       }, timeDifference);
     }
     var _ref5 = properties.split("-")
-      // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+      // biome-ignore lint/suspicious/noExplicitAny: ignore
       .map(Number),
       _ref6 = _slicedToArray(_ref5, 3),
       year = _ref6[0],

package/module/es5/String/camelCase.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a string to camelCase
+ * @param str - The string to convert
+ * @returns The camelCase string
+ */
+export declare const camelCase: (string_: string) => string;

package/module/es5/String/camelCase.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.camelCase = void 0;
+/**
+ * Converts a string to camelCase
+ * @param str - The string to convert
+ * @returns The camelCase string
+ */
+var camelCase = exports.camelCase = function camelCase(string_) {
+  return string_.replaceAll(/[^a-zA-Z0-9]+(.)/g, function (_, _char) {
+    return _char.toUpperCase();
+  }).replaceAll(/[^a-zA-Z0-9]+$/g, "").replace(/^[A-Z]/, function (_char2) {
+    return _char2.toLowerCase();
+  });
+};

package/module/es5/String/escapeHtml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Escapes HTML special characters in a string
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+export declare const escapeHtml: (string_: string) => string;

package/module/es5/String/escapeHtml.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.escapeHtml = void 0;
+/**
+ * HTML entities map for escaping
+ */
+var htmlEscapeMap = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+
+/**
+ * Escapes HTML special characters in a string
+ * @param str - The string to escape
+ * @returns The escaped string
+ */
+var escapeHtml = exports.escapeHtml = function escapeHtml(string_) {
+  return string_.replaceAll(/[&<>"']/g, function (match) {
+    return htmlEscapeMap[match];
+  });
+};

package/module/es5/String/formatString/applyFormatter.d.ts

@@ -0,0 +1,25 @@
+import type { Formatter } from "$/string/formatString/formatter";
+/**
+ * Applies a formatter function to a value with optional arguments.
+ *
+ * Parses formatter syntax like "upper", "currency(ja-JP,JPY)", "pad(4,0)" and applies
+ * the corresponding formatter function with parsed arguments.
+ *
+ * @param value - The value to format
+ * @param formatterString - Formatter name with optional arguments (e.g., "upper", "currency(ja-JP,JPY)")
+ * @param formatters - Available formatter functions
+ * @returns Formatted string, or original string value if formatter not found/invalid
+ *
+ * @example
+ * // Simple formatter
+ * applyFormatter("hello", "upper", { upper: (v) => String(v).toUpperCase() }) // → "HELLO"
+ *
+ * @example
+ * // Formatter with arguments
+ * applyFormatter(42, "pad(4,0)", { pad: (v, len, char) => String(v).padStart(+len, char) }) // → "0042"
+ *
+ * @example
+ * // Invalid formatter returns original value
+ * applyFormatter("test", "invalid!@#", {}) // → "test"
+ */
+export declare function applyFormatter(value: unknown, formatterString: string, formatters: Record<string, Formatter>): string;

package/module/es5/String/formatString/applyFormatter.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyFormatter = applyFormatter;
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+/**
+ * Applies a formatter function to a value with optional arguments.
+ *
+ * Parses formatter syntax like "upper", "currency(ja-JP,JPY)", "pad(4,0)" and applies
+ * the corresponding formatter function with parsed arguments.
+ *
+ * @param value - The value to format
+ * @param formatterString - Formatter name with optional arguments (e.g., "upper", "currency(ja-JP,JPY)")
+ * @param formatters - Available formatter functions
+ * @returns Formatted string, or original string value if formatter not found/invalid
+ *
+ * @example
+ * // Simple formatter
+ * applyFormatter("hello", "upper", { upper: (v) => String(v).toUpperCase() }) // → "HELLO"
+ *
+ * @example
+ * // Formatter with arguments
+ * applyFormatter(42, "pad(4,0)", { pad: (v, len, char) => String(v).padStart(+len, char) }) // → "0042"
+ *
+ * @example
+ * // Invalid formatter returns original value
+ * applyFormatter("test", "invalid!@#", {}) // → "test"
+ */
+function applyFormatter(value, formatterString, formatters) {
+  var match = formatterString.match(/^(\w+)(?:\(([^)]*)\))?$/);
+  if (!match) {
+    return String(value);
+  }
+  var _match = _slicedToArray(match, 3),
+    formatterName = _match[1],
+    argumentsString = _match[2];
+  var formatter = formatters[formatterName];
+  if (!formatter) {
+    return String(value);
+  }
+  var arguments_ = argumentsString ? parseArguments(argumentsString) : [];
+  return formatter.apply(void 0, [value].concat(_toConsumableArray(arguments_)));
+}
+
+/**
+ * Parses comma-separated arguments while preserving quoted strings
+ * @param argumentsString - String containing comma-separated arguments
+ * @returns Array of parsed arguments
+ */
+function parseArguments(argumentsString) {
+  var arguments_ = [];
+  var current = "";
+  var inQuotes = false;
+  var quoteChar = "";
+  var _iterator = _createForOfIteratorHelper(argumentsString),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _char = _step.value;
+      if (!inQuotes && (_char === '"' || _char === "'")) {
+        inQuotes = true;
+        quoteChar = _char;
+        continue;
+      }
+      if (inQuotes && _char === quoteChar) {
+        inQuotes = false;
+        quoteChar = "";
+        continue;
+      }
+      if (!inQuotes && _char === ",") {
+        var _trimmed = current.trim();
+        arguments_.push(_trimmed === "" ? " " : _trimmed);
+        current = "";
+        continue;
+      }
+      current += _char;
+    }
+
+    // Handle last argument
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var trimmed = current.trim();
+  arguments_.push(trimmed === "" ? " " : trimmed);
+  return arguments_;
+}

package/module/es5/String/formatString/defaultFormatters.d.ts

@@ -0,0 +1,24 @@
+import type { Formatter } from "$/string/formatString/formatter";
+/**
+ * Built-in formatter functions for formatString.
+ *
+ * Each formatter takes a value and optional arguments, returning a formatted string.
+ * Formatters are used with syntax like {value:formatterName} or {value:formatterName(arg1,arg2)}.
+ *
+ * Available formatters:
+ * - upper: Convert to uppercase
+ * - lower: Convert to lowercase
+ * - currency: Format as currency with locale support
+ * - date: Format dates with locale and format options
+ * - time: Format time with locale support
+ * - number: Format numbers with precision control
+ * - plural: Choose singular/plural form based on count
+ * - pad: Pad string with characters to specified length
+ *
+ * @example
+ * // Usage in formatString
+ * formatString("{name:upper}", { name: "alice" }) // → "ALICE"
+ * formatString("{price:currency(ja-JP,JPY)}", { price: 1000 }) // → "￥1,000"
+ * formatString("{count:plural(item,items)}", { count: 1 }) // → "item"
+ */
+export declare const defaultFormatters: Record<string, Formatter>;

package/module/es5/String/formatString/defaultFormatters.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.defaultFormatters = void 0;
+function _readOnlyError(r) { throw new TypeError('"' + r + '" is read-only'); }
+/**
+ * Built-in formatter functions for formatString.
+ *
+ * Each formatter takes a value and optional arguments, returning a formatted string.
+ * Formatters are used with syntax like {value:formatterName} or {value:formatterName(arg1,arg2)}.
+ *
+ * Available formatters:
+ * - upper: Convert to uppercase
+ * - lower: Convert to lowercase
+ * - currency: Format as currency with locale support
+ * - date: Format dates with locale and format options
+ * - time: Format time with locale support
+ * - number: Format numbers with precision control
+ * - plural: Choose singular/plural form based on count
+ * - pad: Pad string with characters to specified length
+ *
+ * @example
+ * // Usage in formatString
+ * formatString("{name:upper}", { name: "alice" }) // → "ALICE"
+ * formatString("{price:currency(ja-JP,JPY)}", { price: 1000 }) // → "￥1,000"
+ * formatString("{count:plural(item,items)}", { count: 1 }) // → "item"
+ */
+var defaultFormatters = exports.defaultFormatters = {
+  upper: function upper(value) {
+    return String(value).toUpperCase();
+  },
+  lower: function lower(value) {
+    return String(value).toLowerCase();
+  },
+  currency: function currency(value) {
+    var locale = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "en-US";
+    var _currency = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "USD";
+    return new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency: _currency
+    }).format(Number(value));
+  },
+  date: function date(value) {
+    var locale = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "en-US";
+    var format = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "short";
+    var date = value instanceof Date ? value : new Date(String(value));
+    if (format === "iso") {
+      return date.toISOString();
+    }
+    if (format === "time") {
+      return date.toLocaleTimeString(locale);
+    }
+    return date.toLocaleDateString(locale);
+  },
+  time: function time(value) {
+    var locale = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "en-US";
+    var date = value instanceof Date ? value : new Date(String(value));
+    return date.toLocaleTimeString(locale);
+  },
+  number: function number(value) {
+    var locale = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "en-US";
+    var minimumFractionDigits = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "0";
+    var maximumFractionDigits = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : "20";
+    return new Intl.NumberFormat(locale, {
+      minimumFractionDigits: Number(minimumFractionDigits),
+      maximumFractionDigits: Number(maximumFractionDigits)
+    }).format(Number(value));
+  },
+  plural: function plural(value, singular, _plural) {
+    return Number(value) === 1 ? singular : _plural;
+  },
+  pad: function pad(value) {
+    var length = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "2";
+    var _char = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "0";
+    return String(value).padStart(Number(length), _char);
+  }
+};

package/module/es5/String/formatString/detectMode.d.ts

@@ -0,0 +1,26 @@
+import type { FormatData } from "$/string/formatString/formatData";
+import type { FormatOptions } from "$/string/formatString/formatOptions";
+import type { FormatValue } from "$/string/formatString/formatValue";
+/**
+ * Detects whether formatString should use indexed or named mode based on arguments.
+ *
+ * Named mode: First argument is a non-array object
+ * Indexed mode: Arguments are treated as array values
+ *
+ * @param dataOrFirstValue - First argument (object for named mode, value for indexed mode)
+ * @param optionsOrSecondValue - Second argument (options for named mode, value for indexed mode)
+ * @param restValues - Remaining arguments for indexed mode
+ * @returns Object containing data and options for formatting
+ *
+ * @example
+ * // Named mode detection
+ * detectMode({ name: "Alice" }) // → { data: { name: "Alice" }, options: {} }
+ *
+ * @example
+ * // Indexed mode detection
+ * detectMode("first", "second") // → { data: ["first", "second"], options: {} }
+ */
+export declare function detectMode(dataOrFirstValue: FormatData | FormatValue | undefined, optionsOrSecondValue: FormatOptions | FormatValue | undefined, restValues: FormatValue[]): {
+    data: unknown;
+    options: FormatOptions;
+};

package/module/es5/String/formatString/detectMode.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.detectMode = detectMode;
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+/**
+ * Detects whether formatString should use indexed or named mode based on arguments.
+ *
+ * Named mode: First argument is a non-array object
+ * Indexed mode: Arguments are treated as array values
+ *
+ * @param dataOrFirstValue - First argument (object for named mode, value for indexed mode)
+ * @param optionsOrSecondValue - Second argument (options for named mode, value for indexed mode)
+ * @param restValues - Remaining arguments for indexed mode
+ * @returns Object containing data and options for formatting
+ *
+ * @example
+ * // Named mode detection
+ * detectMode({ name: "Alice" }) // → { data: { name: "Alice" }, options: {} }
+ *
+ * @example
+ * // Indexed mode detection
+ * detectMode("first", "second") // → { data: ["first", "second"], options: {} }
+ */
+function detectMode(dataOrFirstValue, optionsOrSecondValue, restValues) {
+  var isFirstArgumentObject = dataOrFirstValue !== undefined && _typeof(dataOrFirstValue) === "object" && dataOrFirstValue !== null && !Array.isArray(dataOrFirstValue) && !(dataOrFirstValue instanceof Date);
+  var isSecondArgumentOptions = optionsOrSecondValue !== undefined && _typeof(optionsOrSecondValue) === "object" && optionsOrSecondValue !== null && !Array.isArray(optionsOrSecondValue) && !(optionsOrSecondValue instanceof Date) && "formatters" in optionsOrSecondValue;
+  if (isFirstArgumentObject && optionsOrSecondValue === undefined && restValues.length === 0) {
+    return {
+      data: dataOrFirstValue,
+      options: {}
+    };
+  }
+  if (isFirstArgumentObject && isSecondArgumentOptions && restValues.length === 0) {
+    return {
+      data: dataOrFirstValue,
+      options: optionsOrSecondValue
+    };
+  }
+  var allValues = [];
+  if (dataOrFirstValue !== undefined) {
+    allValues.push(dataOrFirstValue);
+  }
+  if (optionsOrSecondValue !== undefined) {
+    allValues.push(optionsOrSecondValue);
+  }
+  allValues.push.apply(allValues, _toConsumableArray(restValues));
+  return {
+    data: allValues,
+    options: {}
+  };
+}

package/module/es5/String/formatString/getValue.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Retrieves a value from an object using a dot-notation path with array index support.
+ *
+ * Supports nested properties and array access with positive/negative indices.
+ *
+ * @param object - The object to retrieve the value from
+ * @param path - Dot-notation path (e.g., "user.name", "items[0]", "data[0].items[-1].name")
+ * @returns The value at the specified path, or undefined if not found
+ *
+ * @example
+ * // Simple property access
+ * getValue({ name: "Alice" }, "name") // → "Alice"
+ *
+ * @example
+ * // Nested property access
+ * getValue({ user: { name: "Bob" } }, "user.name") // → "Bob"
+ *
+ * @example
+ * // Array access
+ * getValue({ items: ["A", "B", "C"] }, "items[0]") // → "A"
+ * getValue({ items: ["A", "B", "C"] }, "items[-1]") // → "C"
+ *
+ * @example
+ * // Complex nested access
+ * getValue({ users: [{ name: "Alice" }] }, "users[0].name") // → "Alice"
+ */
+export declare function getValue(object: unknown, path: string): unknown;

package/module/es5/String/formatString/getValue.js

@@ -0,0 +1,85 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getValue = getValue;
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * Retrieves a value from an object using a dot-notation path with array index support.
+ *
+ * Supports nested properties and array access with positive/negative indices.
+ *
+ * @param object - The object to retrieve the value from
+ * @param path - Dot-notation path (e.g., "user.name", "items[0]", "data[0].items[-1].name")
+ * @returns The value at the specified path, or undefined if not found
+ *
+ * @example
+ * // Simple property access
+ * getValue({ name: "Alice" }, "name") // → "Alice"
+ *
+ * @example
+ * // Nested property access
+ * getValue({ user: { name: "Bob" } }, "user.name") // → "Bob"
+ *
+ * @example
+ * // Array access
+ * getValue({ items: ["A", "B", "C"] }, "items[0]") // → "A"
+ * getValue({ items: ["A", "B", "C"] }, "items[-1]") // → "C"
+ *
+ * @example
+ * // Complex nested access
+ * getValue({ users: [{ name: "Alice" }] }, "users[0].name") // → "Alice"
+ */
+function getValue(object, path) {
+  var segments = [];
+  var parts = path.split(".");
+  var _iterator = _createForOfIteratorHelper(parts),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var part = _step.value;
+      var arrayMatch = part.match(/^(.+?)\[(-?\d+)\]$/);
+      if (arrayMatch) {
+        var _arrayMatch = _slicedToArray(arrayMatch, 3),
+          key = _arrayMatch[1],
+          indexString = _arrayMatch[2];
+        segments.push({
+          key: key,
+          index: Number(indexString)
+        });
+      } else {
+        segments.push({
+          key: part
+        });
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var current = object;
+  for (var _i = 0, _segments = segments; _i < _segments.length; _i++) {
+    var segment = _segments[_i];
+    if (_typeof(current) !== "object" || current == null) {
+      return;
+    }
+    current = current[segment.key];
+    if (segment.index !== undefined) {
+      if (!Array.isArray(current)) {
+        return;
+      }
+      var index = segment.index;
+      current = index < 0 ? current[current.length + index] : current[index];
+    }
+  }
+  return current;
+}