ansuko 2.0.0 → 2.0.3

package/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+For changes prior to v2.0.0, see the [git history](https://github.com/sera4am/ansuko/commits/main).
+
+## [Unreleased]
+
+## [2.0.3] - 2026-05-08
+
+## [2.0.2] - 2026-05-08
+
+## [2.0.1] - 2026-05-08
+
+### Added
+- Added `_.isValidEmail` for strict email format validation in core utilities.
+- Added documentation and examples for `_.isValidEmail` in README files.
+- Added GitHub Actions workflow (`test.yml`) to run the test suite on every push and pull request.
+- Added CI test status badge and npm version badge to all README files (EN/JA/ZH).
+
+## [2.0.1] - 2026-05-08
+
+### Added
+- `CHANGELOG.md` based on the [Keep a Changelog](https://keepachangelog.com/) format.
+- `scripts/promote-changelog.sh` and an `npm version` lifecycle hook that
+  promotes the `[Unreleased]` section to a versioned heading on every
+  release. CHANGELOG updates are bundled into the same commit as the
+  version bump automatically.
+- `CLAUDE.md` documenting the release flow, plugin architecture, and
+  conventions for future contributors (and for Claude Code sessions).
+
+## [2.0.0] - 2026-05-08
+
+### Removed (BREAKING)
+- `_.extend(plugin)` API. Plugins are now loaded via side-effect imports
+  (`import "ansuko/plugins/ja"`).
+
+### Changed (BREAKING)
+- Plugin loading: side-effect imports + TypeScript `declare module` merging.
+  IDE autocompletion now works directly on `_` for all plugin methods —
+  the previous `_.extend(plugin)` returned a new type but left the original
+  `_` reference's type unchanged, so plugin methods never appeared in
+  suggestions.
+- `AnsukoType` now extends `Omit<LoDashStatic, "isEmpty" | "toNumber" |
+  "castArray" | "extend">` instead of enumerating ~330 lodash methods by
+  hand. lodash generics are preserved and `@types/lodash` updates flow
+  through automatically.
+
+### Added
+- `_.__plugins: Set<string>` registry. Each plugin registers itself once
+  and skips re-registration when imported from multiple modules.
+
+### Migration
+
+```ts
+// v1
+import _ from "ansuko"
+import jaPlugin from "ansuko/plugins/ja"
+const ansuko = _.extend(jaPlugin)
+ansuko.kanaToFull("ｶﾞ")
+
+// v2
+import _ from "ansuko"
+import "ansuko/plugins/ja"
+_.kanaToFull("ｶﾞ")
+```
+
+If you previously chained `_.extend(a).extend(b)`, replace it with two
+side-effect imports.
+
+[Unreleased]: https://github.com/sera4am/ansuko/compare/v2.0.3...HEAD
+[2.0.3]: https://github.com/sera4am/ansuko/releases/tag/v2.0.3
+[2.0.2]: https://github.com/sera4am/ansuko/releases/tag/v2.0.2
+[2.0.1]: https://github.com/sera4am/ansuko/releases/tag/v2.0.1
+[2.0.1]: https://github.com/sera4am/ansuko/releases/tag/v2.0.1
+[2.0.0]: https://github.com/sera4am/ansuko/releases/tag/v2.0.0

package/README.ja.md

@@ -1,5 +1,7 @@
 # ansuko
 
+[![Tests](https://github.com/sera4am/ansuko/actions/workflows/test.yml/badge.svg)](https://github.com/sera4am/ansuko/actions/workflows/test.yml)
+[![npm version](https://img.shields.io/npm/v/ansuko)](https://www.npmjs.com/package/ansuko)
 
 lodashを拡張した、実用的で直感的な動作を提供するモダンなJavaScript/TypeScriptユーティリティライブラリ。
 
@@ -122,6 +124,10 @@ const value = await _.valueOr(
 // 安全なJSONパース
 const data = _.parseJSON('{ "a": 1, /* comment */ }')  // JSON5対応！
 
+// メールアドレス検証
+_.isValidEmail('user@example.com')   // true
+_.isValidEmail(' user@example.com ') // false
+
 // データベース更新用のオブジェクト変更追跡
 const diff = _.changes(
   original, 
@@ -249,6 +255,7 @@ v1 で `_.extend(a).extend(b)` のように chain していた場合は、2回
 - **`toBool`** - スマートな真偽値変換（"yes"/"no"/"true"/"false"/数値）、未検出時の動作を設定可能
 - **`boolIf`** - フォールバック付き安全な真偽値変換
 - **`isValidStr`** - 非空文字列検証
+- **`isValidEmail`** - メールアドレス形式の検証（前後に空白がある値は無効）
 
 ### JSON処理
 

package/README.md

@@ -1,5 +1,7 @@
 # ansuko
 
+[![Tests](https://github.com/sera4am/ansuko/actions/workflows/test.yml/badge.svg)](https://github.com/sera4am/ansuko/actions/workflows/test.yml)
+[![npm version](https://img.shields.io/npm/v/ansuko)](https://www.npmjs.com/package/ansuko)
 
 A modern JavaScript/TypeScript utility library that extends lodash with practical, intuitive behaviors.
 
@@ -111,6 +113,7 @@ const value = _.equalsOr(a, b, defaultValue)  // null == undefined
 - **`toBool`** - Smart boolean conversion ("yes"/"no"/"true"/"false"/numbers) with configurable undetected handling
 - **`boolIf`** - Safe boolean conversion with fallback
 - **`isValidStr`** - Non-empty string validation
+- **`isValidEmail`** - Email format validation (strict: values with surrounding spaces are invalid)
 
 ### JSON Processing
 
@@ -201,6 +204,10 @@ const value = await _.valueOr(
 // Safe JSON parsing
 const data = _.parseJSON('{ "a": 1, /* comment */ }')  // Works with JSON5!
 
+// Email validation
+_.isValidEmail('user@example.com')  // true
+_.isValidEmail(' user@example.com ') // false
+
 // Track object changes for database updates
 const diff = _.changes(
   original, 

package/README.zh.md

@@ -1,5 +1,8 @@
 # ansuko
 
+[![Tests](https://github.com/sera4am/ansuko/actions/workflows/test.yml/badge.svg)](https://github.com/sera4am/ansuko/actions/workflows/test.yml)
+[![npm version](https://img.shields.io/npm/v/ansuko)](https://www.npmjs.com/package/ansuko)
+
 在lodash基础上扩展、提供实用且直观易懂的现代JavaScript/TypeScript工具库。
 
 [English](./README.md) | [日本語](./README.ja.md) | [简体中文](./README.zh.md)
@@ -108,6 +111,7 @@ const value = _.equalsOr(a, b, defaultValue)  // null == undefined
 - **`toBool`** - 智能布尔值转换（支持 "yes"/"no"/"true"/"false"/数字），可配置未检测到时的行为检测处理
 - **`boolIf`** - 带有回退机制的安全布尔值转换
 - **`isValidStr`** - 非空字符串验证
+- **`isValidEmail`** - 邮箱格式校验（严格模式：前后包含空格视为无效）
 
 ### JSON 处理
 
@@ -196,6 +200,10 @@ const value = await _.valueOr(
 // 安全的 JSON 解析
 const data = _.parseJSON('{ "a": 1, /* 注释 */ }')  // 支持 JSON5！
 
+// 邮箱格式校验
+_.isValidEmail('user@example.com')   // true
+_.isValidEmail(' user@example.com ') // false
+
 // 跟踪对象更改以进行数据库更新
 const diff = _.changes(
   original, 

package/dist/index.d.ts

@@ -209,6 +209,19 @@ declare const swallowMap: <T, U>(array: T[] | undefined | null, fn: (item: T, in
  * @category Array Utilities
  */
 declare const arrayDepth: (ary: unknown) => number;
+/**
+ * Validates whether the input is a syntactically valid email address.
+ * - Returns false for null/undefined/empty values.
+ * - Values containing leading/trailing spaces are treated as invalid.
+ * - Case-insensitive for the domain/local-part check.
+ * @param email - Value to validate
+ * @returns true if the input is a valid email format
+ * @example isValidEmail('user@example.com') // true
+ * @example isValidEmail(' user@example.com ') // false
+ * @example isValidEmail('not-an-email') // false
+ * @category Type Guards
+ */
+declare const isValidEmail: (email: unknown) => boolean;
 export type ChangesOptions = {
     keyExcludes?: boolean;
 };
@@ -238,6 +251,7 @@ export interface AnsukoType extends Omit<LoDashStatic, AnsukoOverriddenKeys> {
     swallowMap: typeof swallowMap;
     arrayDepth: typeof arrayDepth;
     strWrap: typeof strWrap;
+    isValidEmail: typeof isValidEmail;
     isEmpty: typeof isEmpty;
     toNumber: typeof toNumber;
     castArray: typeof castArray;
@@ -254,4 +268,4 @@ export interface AnsukoType extends Omit<LoDashStatic, AnsukoOverriddenKeys> {
 }
 declare const _: AnsukoType;
 export default _;
-export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, strWrap, swallow, swallowMap, arrayDepth, };
+export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, strWrap, swallow, swallowMap, arrayDepth, isValidEmail, };

package/dist/index.js

@@ -564,6 +564,29 @@ const arrayDepth = (ary) => {
     }
     return 1 + Math.min(...ary.map(arrayDepth));
 };
+/**
+ * Validates whether the input is a syntactically valid email address.
+ * - Returns false for null/undefined/empty values.
+ * - Values containing leading/trailing spaces are treated as invalid.
+ * - Case-insensitive for the domain/local-part check.
+ * @param email - Value to validate
+ * @returns true if the input is a valid email format
+ * @example isValidEmail('user@example.com') // true
+ * @example isValidEmail(' user@example.com ') // false
+ * @example isValidEmail('not-an-email') // false
+ * @category Type Guards
+ */
+const isValidEmail = (email) => {
+    if (isEmpty(email)) {
+        return false;
+    }
+    const str = String(email).toLowerCase();
+    if (isEmpty(str)) {
+        return false;
+    }
+    const re = /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+    return re.test(str);
+};
 // 変数名を _ にすることで、VS Code の auto import 候補が `_` として表示される
 const _ = {
     ...lodash,
@@ -588,8 +611,9 @@ const _ = {
     swallow,
     swallowMap,
     arrayDepth,
+    isValidEmail,
     __plugins: new Set(),
 };
 export default _;
 // 個別エクスポートはそのまま
-export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, strWrap, swallow, swallowMap, arrayDepth, };
+export { isEmpty, toNumber, boolIf, isValidStr, valueOr, equalsOr, waited, parseJSON, jsonStringify, castArray, changes, strWrap, swallow, swallowMap, arrayDepth, isValidEmail, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansuko",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "description": "A modern JavaScript/TypeScript utility library that extends lodash with practical, intuitive behaviors. Fixes lodash quirks, adds Promise support, Japanese text processing, and GeoJSON utilities.",
   "keywords": [
     "lodash",
@@ -34,6 +34,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "exports": {
@@ -48,7 +49,8 @@
     "test": "npm run build && vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx"
+    "lint": "eslint src --ext .ts,.tsx",
+    "version": "bash ./scripts/promote-changelog.sh && git add CHANGELOG.md"
   },
   "dependencies": {
     "@turf/turf": "^7.3.1",