## Overview

This release introduces several new features and improvements across various modules, including Array, FormData, Map, Element, URL, and Date. To ensure a smooth transition for future releases, some functions are marked for deprecation. Additionally, bugs related to URL query handling and date formatting have been fixed.

## String

### New Features

- Function `copy()` replaces `$copy()`;

### Will Deprecate (`2.*.*`)

- Function `$copy()`;

## Number

### New Features

- Function `$gone` returns a relative time description in Chinese or English based on the language setting;

## Array

### New Features

- Function `_(value: any | any[], index?: number)` enhanced:
  - Adds an optional `index` parameter to specify the insertion position;
  - Supports inserting an element or array at a specific index;
  - If `index` is not provided, the default behavior of adding elements to the end of the array remains;

### Resolved Issues

- Function `$_(index: number)` now correctly removes the element at the specified index and returns the updated array;

## Object

### New Features

- Function `forEach(value?: (key: string, val: any) => void)` replaces `$forEach(value?: (key: string, val: any) => void)`;

### Will Deprecate (`2.*.*`)

- Function `$forEach(value?: (key: string, val: any) => void)`;

## Map

### New Features

- Function `$json` replaces `$obj`;
- Function `$_(key?: any)` removes the element with the specified key and returns the updated `Map`;
- Function `$$(value: any)` checks if the `Map` contains the specified value;

### Will Deprecate (`2.*.*`)

- Function `$obj`;

## FormData

### New Features

- Function `$map` returns a `Map<string, any>`;
- Function `$json` returns an object `{ [key: string]: any }`;

## Date

### New Features

- Function `$S` returns centiseconds;
- Function `$SS` returns deciseconds;
- Function `$SSS` returns milliseconds;
- Function `$dddd` returns the full name of the day (e.g., 'Sunday');
- Function `$ddd` returns the abbreviated day name (e.g., 'Sun');
- Function `$format` now supports the formats 'S', 'SS', 'SSS', 'ddd', 'dddd';

### Resolved Issues

- Function `$dd` now correctly returns a two-letter abbreviation (e.g., 'Su');
- Function `$y` now returns a format consistent with `$yy`;

## URL

### Resolved Issues

- Function `$queryAll` now correctly processes query parameters;

## Element

### New Features

- Function `_padding(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)` replaces `_p(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- Function `_paddingTop(value?: number | string)` replaces `_pt(value?: number | string)`;
- Function `_paddingLeft(value?: number | string)` replaces `_pl(value?: number | string)`;
- Function `_paddingBottom(value?: number | string)` replaces `_pb(value?: number | string)`;
- Function `_paddingRight(value?: number | string)` replaces `_pr(value?: number | string)`;

- Function `_margin(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)` replaces `_m(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- Function `_marginTop(value?: number | string)` replaces `_mt(value?: number | string)`;
- Function `_marginLeft(value?: number | string)` replaces `_ml(value?: number | string)`;
- Function `_marginBottom(value?: number | string)` replaces `_mb(value?: number | string)`;
- Function `_marginRight(value?: number | string)` replaces `_mr(value?: number | string)`;

- Function `$formData`
  - Returns `FormData` for `<form>` elements;
  - Returns `undefined` for non-`<form>` elements;
- Function `$map`
  - Processes `$formData` results;
  - Returns a `Map<string, any>` or `undefined`;
- Function `$json`
  - Processes `$formData` results;
  - Returns an object `{ [key: string]: any }` or `undefined`;

### Will Deprecate (`2.*.*`)

- Function `_p(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- Function `_pt(value?: number | string)`;
- Function `_pl(value?: number | string)`;
- Function `_pb(value?: number | string)`;
- Function `_pr(value?: number | string)`;
- Function `_m(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- Function `_mt(value?: number | string)`;
- Function `_ml(value?: number | string)`;
- Function `_mb(value?: number | string)`;
- Function `_mr(value?: number | string)`;

---

## 概述

此版本引入了多個模組的新功能和改進，包括 Array、FormData、Map、Element、URL 和 Date。為了確保未來版本的順利過渡，一些函數被標記為即將棄用。此外，還修復了 URL 查詢處理和日期格式化方面的錯誤。

## String

### 新功能

- 函數 `copy()` 取代 `$copy()`;

### 即將棄用 (`2.*.*`)

- 函數 `$copy()`;

## Number

### 新功能

- 函數 `$gone` 根據語言設定，返回相對時間的中文或英文描述;

## Array

### 新功能

- 函數 `_(value: any | any[], index?: number)` 增強功能：
  - 新增可選參數 `index`，用於指定插入位置;
  - 支援在指定索引處插入元素或數組;
  - 當不提供 `index` 時，保持在數組末尾添加元素的行為;

### 修正問題

- 函數 `$_(index: number)` 現在可以正確移除指定索引的元素並返回更新後的數組;

## Object

### 新功能

- 函數 `forEach(value?: (key: string, val: any) => void)` 取代 `$forEach(value?: (key: string, val: any) => void)`;

### 即將棄用 (`2.*.*`)

- 函數 `$forEach(value?: (key: string, val: any) => void)`;

## Map

### 新功能

- 函數 `$json` 取代 `$obj`;
- 函數 `$_(key?: any)` 刪除指定鍵並返回更新的 `Map`;
- 函數 `$$(value: any)` 檢查 `Map` 是否包含指定值;

### 即將棄用 (`2.*.*`)

- 函數 `$obj`;

## FormData

### 新功能

- 函數 `$map` 返��� `Map<string, any>`;
- 函數 `$json` 返回物件 `{ [key: string]: any }`;

## Date

### 新功能

- 函數 `$S` 返回百毫秒;
- 函數 `$SS` 返回十毫秒;
- 函數 `$SSS` 返回毫秒;
- 函數 `$dddd` 返回完整星期名稱 (如 'Sunday');
- 函數 `$ddd` 返回星期縮寫 (如 'Sun');
- 函數 `$format` 現支援 'S'、'SS'、'SSS'、'ddd'、'dddd' 格式;

### 修正問題

- 函數 `$dd` 現正確返回兩字母縮寫 (如 'Su');
- 函數 `$y` 現返回與 `$yy` 一致的格式;

## URL

### 修正問題

- 函數 `$queryAll` 現正確處理查詢參數;

## Element

### 新功能

- 函數 `_padding(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)` 取代 `_p(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- 函數 `_paddingTop(value?: number | string)` 取代 `_pt(value?: number | string)`;
- 函數 `_paddingLeft(value?: number | string)` 取代 `_pl(value?: number | string)`;
- 函數 `_paddingBottom(value?: number | string)` 取代 `_pb(value?: number | string)`;
- 函數 `_paddingRight(value?: number | string)` 取代 `_pr(value?: number | string)`;

- 函數 `_margin(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)` 取代 `_m(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- 函數 `_marginTop(value?: number | string)` 取代 `_mt(value?: number | string)`;
- 函數 `_marginLeft(value?: number | string)` 取代 `_ml(value?: number | string)`;
- 函數 `_marginBottom(value?: number | string)` 取代 `_mb(value?: number | string)`;
- 函數 `_marginRight(value?: number | string)` 取代 `_mr(value?: number | string)`;

- 函數 `$formData`
  - 對 `<form>` 元素返回 `FormData`;
  - 非 `<form>` 元素返回 `undefined`;
- 函數 `$map`
  - 處理 `$formData` 結果;
  - 返回 `Map<string, any>` 或 `undefined`;
- 函數 `$json`
  - 處理 `$formData` 結果;
  - 返回物件 `{ [key: string]: any }` 或 `undefined`;

### 即將棄用 (`2.*.*`)

- 函數 `_p(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- 函數 `_pt(value?: number | string)`;
- 函數 `_pl(value?: number | string)`;
- 函數 `_pb(value?: number | string)`;
- 函數 `_pr(value?: number | string)`;
- 函數 `_m(top?: number | string, right?: number | string, bottom?: number | string, left?: number | string)`;
- 函數 `_mt(value?: number | string)`;
- 函數 `_ml(value?: number | string)`;
- 函數 `_mb(value?: number | string)`;
- 函數 `_mr(value?: number | string)`;