ansuko 1.3.15 → 2.0.1

package/CHANGELOG.md

@@ -0,0 +1,64 @@
+# 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.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.1...HEAD
+[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

@@ -92,14 +92,14 @@ ansukoは最小限のコア + プラグインアーキテクチャを採用し
 import _ from 'ansuko'  // ~20KB
 
 // 必要に応じて日本語サポートを追加
-import jaPlugin from 'ansuko/plugins/ja'
-const extended = _.extend(jaPlugin)  // +5KB
+import 'ansuko/plugins/ja'  // +5KB（side-effect import）
 
 // マッピングアプリ用にGIS機能を追加
-import geoPlugin from 'ansuko/plugins/geo'
-const full = extended.extend(geoPlugin)  // +100KB
+import 'ansuko/plugins/geo'  // +100KB
 ```
 
+> **v2 ノート**: プラグインは side-effect import で読み込む形式に変わりました。`import 'ansuko/plugins/<name>'` するだけで、`_` の実体と TypeScript の型 (declare module merging 経由) が同時に拡張されます。v1 で使われていた `_.extend(plugin)` API は v2 で削除されました — 後述の [v1 からの移行](#v1-からの移行) を参照。
+
 ## クイックスタート
 
 ### 基本的な使い方
@@ -140,39 +140,35 @@ const items = _.swallowMap([1, 2, 3], item => processItem(item), true)  // エ
 
 ```typescript
 import _ from 'ansuko'
-import jaPlugin from 'ansuko/plugins/ja'
+import 'ansuko/plugins/ja'
 
-const extended = _.extend(jaPlugin)
-
-extended.kanaToFull('ｶﾞｷﾞ')              // 'ガギ'
-extended.kanaToHira('アイウ')             // 'あいう'
-extended.toHalfWidth('ＡＢＣー１２３', '-') // 'ABC-123'
-extended.haifun('test‐data', '-')       // 'test-data'
+_.kanaToFull('ｶﾞｷﾞ')              // 'ガギ'
+_.kanaToHira('アイウ')             // 'あいう'
+_.toHalfWidth('ＡＢＣー１２３', '-') // 'ABC-123'
+_.haifun('test‐data', '-')       // 'test-data'
 ```
 
 #### Geoプラグイン
 
 ```typescript
 import _ from 'ansuko'
-import geoPlugin from 'ansuko/plugins/geo'
-
-const extended = _.extend(geoPlugin)
+import 'ansuko/plugins/geo'
 
 // 様々な形式をGeoJSONに変換
-extended.toPointGeoJson([139.7671, 35.6812])
+_.toPointGeoJson([139.7671, 35.6812])
 // => { type: 'Point', coordinates: [139.7671, 35.6812] }
 
-extended.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
+_.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
 // => { type: 'Point', coordinates: [139.6917, 35.6895] }
 
 // 複数のポリゴンを結合
-const unified = extended.unionPolygon([polygon1, polygon2])
+const unified = _.unionPolygon([polygon1, polygon2])
 
 // MapBoxユーティリティ
-extended.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+_.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
 // => ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
 
-extended.mProps({
+_.mProps({
   fillColor: "#ff0000",
   sourceLayer: "buildings",
   visibility: true
@@ -183,32 +179,52 @@ extended.mProps({
 #### Prototypeプラグイン
 
 ```typescript
-import _ from 'ansuko'
-import prototypePlugin from 'ansuko/plugins/prototype'
-
-_.extend(prototypePlugin)
+import 'ansuko/plugins/prototype'
 
 // Array.prototypeが拡張される
 [1, 2, 3].notMap(n => n > 1)      // [true, false, false]
 [1, 2, 3].notFilter(n => n % 2)   // [2]（偶数）
 ```
 
-### プラグインのチェーン
+### 複数プラグインの併用
 
 ```typescript
 import _ from 'ansuko'
-import jaPlugin from 'ansuko/plugins/ja'
-import geoPlugin from 'ansuko/plugins/geo'
+import 'ansuko/plugins/ja'
+import 'ansuko/plugins/geo'
+
+// 日本語とGeoユーティリティの両方が `_` で使える
+_.kanaToHira('アイウ')
+_.toPointGeoJson([139.7, 35.6])
+```
 
-const extended = _
-  .extend(jaPlugin)
-  .extend(geoPlugin)
+各プラグインは複数ファイルから import されても登録は1回のみです（重複登録ガードを内蔵）。
 
-// 日本語とGeoユーティリティの両方が使える！
-extended.kanaToHira('アイウ')
-extended.toPointGeoJson([139.7, 35.6])
+## v1 からの移行
+
+v2 では `_.extend(plugin)` を廃止し、side-effect import に統一しました。移行は機械的です:
+
+```typescript
+// 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('ｶﾞ')
 ```
 
+変更の理由:
+
+- **TypeScript のサジェストが本当に効くようになりました。** v1 の `_.extend()` は新しい型を返していましたが、元の `_` 自体の型は変わらないため IDE 上で `_.` を打ってもプラグインの関数が候補に出てきませんでした。v2 は `declare module` merging で `_` 自体を型レベルで拡張します。
+- **Tree-shaking が正直になります。** プラグインを import しなければバンドルに含まれません。
+- **lodash 型を330行手書きしていた問題を解消。** `AnsukoType` は `Omit<LoDashStatic, ...>` を継承するようになり、lodash 本来のジェネリクスもそのまま使えます。
+
+v1 で `_.extend(a).extend(b)` のように chain していた場合は、2回の side-effect import に置き換えてください。
+
 ## 主な機能
 
 ### 拡張されたlodash関数

package/README.md

@@ -171,14 +171,14 @@ This means you only pay for what you use!
 import _ from 'ansuko'  // ~20KB
 
 // Add Japanese support when needed
-import jaPlugin from 'ansuko/plugins/ja'
-_.extend(jaPlugin)  // +5KB
+import 'ansuko/plugins/ja'  // +5KB (side-effect import)
 
 // Add GIS features for mapping apps
-import geoPlugin from 'ansuko/plugins/geo'
-_.extend(geoPlugin)  // +100KB
+import 'ansuko/plugins/geo'  // +100KB
 ```
 
+> **v2 Note**: Plugins are now loaded as side-effect imports. Just `import 'ansuko/plugins/<name>'` once and `_` is automatically augmented in both runtime and type system (via TypeScript's `declare module` merging). The legacy `_.extend(plugin)` API has been removed in v2 — see [Migration from v1](#migration-from-v1) below.
+
 ## Quick Start
 
 ### Basic Usage
@@ -219,9 +219,7 @@ const items = _.swallowMap([1, 2, 3], item => processItem(item), true)  // filte
 
 ```typescript
 import _ from 'ansuko'
-import jaPlugin from 'ansuko/plugins/ja'
-
-_.extend(jaPlugin)
+import 'ansuko/plugins/ja'
 
 _.kanaToFull('ｶﾞｷﾞ')              // 'ガギ'
 _.kanaToHira('アイウ')             // 'あいう'
@@ -233,25 +231,23 @@ _.haifun('test‐data', '-')       // 'test-data'
 
 ```typescript
 import _ from 'ansuko'
-import geoPlugin from 'ansuko/plugins/geo'
-
-const extended = _.extend(geoPlugin)
+import 'ansuko/plugins/geo'
 
 // Convert various formats to GeoJSON
-extended.toPointGeoJson([139.7671, 35.6812])
+_.toPointGeoJson([139.7671, 35.6812])
 // => { type: 'Point', coordinates: [139.7671, 35.6812] }
 
-extended.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
+_.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
 // => { type: 'Point', coordinates: [139.6917, 35.6895] }
 
 // Union multiple polygons
-const unified = extended.unionPolygon([polygon1, polygon2])
+const unified = _.unionPolygon([polygon1, polygon2])
 
 // MapBox utilities
-extended.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+_.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
 // => ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
 
-extended.mProps({
+_.mProps({
   fillColor: "#ff0000",
   sourceLayer: "buildings",
   visibility: true
@@ -262,32 +258,52 @@ extended.mProps({
 #### Prototype Plugin
 
 ```typescript
-import _ from 'ansuko'
-import prototypePlugin from 'ansuko/plugins/prototype'
-
-_.extend(prototypePlugin)
+import 'ansuko/plugins/prototype'
 
 // Now Array.prototype is extended
 [1, 2, 3].notMap(n => n > 1)      // [true, false, false]
 [1, 2, 3].notFilter(n => n % 2)   // [2] (even numbers)
 ```
 
-### Chaining Plugins
+### Combining Plugins
 
 ```typescript
 import _ from 'ansuko'
-import jaPlugin from 'ansuko/plugins/ja'
-import geoPlugin from 'ansuko/plugins/geo'
+import 'ansuko/plugins/ja'
+import 'ansuko/plugins/geo'
+
+// Now you have both Japanese and Geo utilities on `_`
+_.kanaToHira('アイウ')
+_.toPointGeoJson([139.7, 35.6])
+```
 
-const extended = _
-  .extend(jaPlugin)
-  .extend(geoPlugin)
+Each plugin registers itself exactly once, even if imported from multiple files (a duplicate-registration guard is built in).
 
-// Now you have both Japanese and Geo utilities!
-extended.kanaToHira('アイウ')
-extended.toPointGeoJson([139.7, 35.6])
+## Migration from v1
+
+v2 removes `_.extend(plugin)` in favor of side-effect imports. The migration is mechanical:
+
+```typescript
+// 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('ｶﾞ')
 ```
 
+Why this change:
+
+- **TypeScript autocompletion now actually works.** v1's `_.extend()` returned a new type, but the original `_` reference's type stayed the same — so IDE suggestions never appeared on `_`. v2 uses TypeScript `declare module` merging so `_` itself is augmented at the type level.
+- **Tree-shaking is honest.** Don't import a plugin = its code is not bundled.
+- **No more 330-line manual lodash type list.** `AnsukoType` now extends `Omit<LoDashStatic, ...>`, so lodash's own types are reused (with proper generics).
+
+If you previously did chained `_.extend(a).extend(b)`, replace it with two side-effect imports.
+
 ## Documentation
 
 For detailed information, see:

package/README.zh.md

@@ -166,14 +166,14 @@ ansuko使用最小核心 + 插件架构来保持你的包大小小：
 import _ from 'ansuko'  // ~20KB
 
 // 按需加入日文支持
-import jaPlugin from 'ansuko/plugins/ja'
-const extended = _.extend(jaPlugin)  // +5KB
+import 'ansuko/plugins/ja'  // +5KB（副作用引入）
 
 // 地图类应用再挂载 GIS
-import geoPlugin from 'ansuko/plugins/geo'
-const full = extended.extend(geoPlugin)  // +100KB
+import 'ansuko/plugins/geo'  // +100KB
 ```
 
+> **v2 提示**：插件改为副作用引入。只需 `import 'ansuko/plugins/<name>'` 一次，`_` 在运行时和 TypeScript 类型层面（通过 `declare module` 合并）都会被自动扩展。v1 的 `_.extend(plugin)` API 已在 v2 中移除 —— 详见下方的[从 v1 迁移](#从-v1-迁移)。
+
 ## 快速开始
 
 ### 基本用法
@@ -214,9 +214,7 @@ const items = _.swallowMap([1, 2, 3], item => processItem(item), true)  // 过
 
 ```typescript
 import _ from 'ansuko'
-import jaPlugin from 'ansuko/plugins/ja'
-
-_.extend(jaPlugin)
+import 'ansuko/plugins/ja'
 
 _.kanaToFull('ｶﾞｷﾞ')              // 'ガギ'
 _.kanaToHira('アイウ')             // 'あいう'
@@ -228,25 +226,23 @@ _.haifun('test‐data', '-')       // 'test-data'
 
 ```typescript
 import _ from 'ansuko'
-import geoPlugin from 'ansuko/plugins/geo'
-
-const extended = _.extend(geoPlugin)
+import 'ansuko/plugins/geo'
 
 // 将各种格式转换为 GeoJSON
-extended.toPointGeoJson([139.7671, 35.6812])
+_.toPointGeoJson([139.7671, 35.6812])
 // => { type: 'Point', coordinates: [139.7671, 35.6812] }
 
-extended.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
+_.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
 // => { type: 'Point', coordinates: [139.6917, 35.6895] }
 
 // 合并多个多边形
-const unified = extended.unionPolygon([polygon1, polygon2])
+const unified = _.unionPolygon([polygon1, polygon2])
 
 // MapBox 工具
-extended.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+_.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
 // => ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
 
-extended.mProps({
+_.mProps({
   fillColor: "#ff0000",
   sourceLayer: "buildings",
   visibility: true
@@ -257,32 +253,52 @@ extended.mProps({
 #### 原型插件
 
 ```typescript
-import _ from 'ansuko'
-import prototypePlugin from 'ansuko/plugins/prototype'
-
-_.extend(prototypePlugin)
+import 'ansuko/plugins/prototype'
 
 // 现在 Array.prototype 已扩展
 [1, 2, 3].notMap(n => n > 1)      // [true, false, false]
 [1, 2, 3].notFilter(n => n % 2)   // [2]（偶数）
 ```
 
-### 链式插件
+### 同时使用多个插件
 
 ```typescript
 import _ from 'ansuko'
-import jaPlugin from 'ansuko/plugins/ja'
-import geoPlugin from 'ansuko/plugins/geo'
+import 'ansuko/plugins/ja'
+import 'ansuko/plugins/geo'
+
+// 现在 `_` 上同时拥有日文和地理工具
+_.kanaToHira('アイウ')
+_.toPointGeoJson([139.7, 35.6])
+```
 
-const extended = _
-  .extend(jaPlugin)
-  .extend(geoPlugin)
+每个插件即使被多个文件 import，也只会注册一次（内置了重复注册防护）。
 
-// 现在你同时拥有日文和地理工具！
-extended.kanaToHira('アイウ')
-extended.toPointGeoJson([139.7, 35.6])
+## 从 v1 迁移
+
+v2 移除了 `_.extend(plugin)`，改为副作用引入。迁移非常机械：
+
+```typescript
+// 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('ｶﾞ')
 ```
 
+变更原因：
+
+- **TypeScript 自动补全终于真正起作用了。** v1 的 `_.extend()` 会返回新类型，但原 `_` 引用的类型不变 —— 因此在 IDE 里 `_.` 永远不会出现插件的方法提示。v2 通过 TypeScript `declare module` 合并直接扩展 `_` 自身的类型。
+- **Tree-shaking 真实可靠。** 不 import 的插件不会被打包。
+- **告别 330 行手写 lodash 类型列表。** `AnsukoType` 现在继承 `Omit<LoDashStatic, ...>`，lodash 自身的泛型类型也得以保留。
+
+如果你之前使用 `_.extend(a).extend(b)` 的链式写法，请改为两次副作用引入。
+
 ## 文档
 
 更多详细信息，请参阅：

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import lodash from "lodash";
+import lodash, { type LoDashStatic } from "lodash";
 /**
  * Checks if the value is a non-empty string. null/undefined/empty string -> false.
  * @param str - Value to check
@@ -209,21 +209,20 @@ declare const swallowMap: <T, U>(array: T[] | undefined | null, fn: (item: T, in
  * @category Array Utilities
  */
 declare const arrayDepth: (ary: unknown) => number;
-/**
- * Extends ansuko with a plugin and returns the augmented instance.
- * @param plugin - Plugin function
- * @returns Extended instance
- * @example const extended = lodash.extend(jaPlugin)
- * @category Core Functions
- */
-declare const extend: <T extends AnsukoType, E>(this: T, plugin: (a: T) => T & E) => T & E;
 export type ChangesOptions = {
     keyExcludes?: boolean;
 };
 type ChangesAfterCallback<T> = (value: T) => any | Promise<any>;
 type ChangesAfterFinallyCallback<T> = (value: T, res: any) => any | Promise<any>;
-export interface AnsukoType {
-    extend: typeof extend;
+type AnsukoOverriddenKeys = 'isEmpty' | 'toNumber' | 'castArray' | 'extend';
+/**
+ * ansuko 本体の型。lodash の全関数 (上書き対象を除く) をそのまま継承し、
+ * ansuko 独自関数を追加した形になる。
+ *
+ * プラグインを読み込むと、各プラグインの d.ts に書かれた declaration merging により
+ * このインターフェースが自動的に拡張される。
+ */
+export interface AnsukoType extends Omit<LoDashStatic, AnsukoOverriddenKeys> {
     isValidStr: typeof isValidStr;
     valueOr: typeof valueOr;
     emptyOr: typeof emptyOr;
@@ -245,307 +244,13 @@ export interface AnsukoType {
     isEmptyOrg: typeof lodash.isEmpty;
     toNumberOrg: typeof lodash.toNumber;
     castArrayOrg: typeof lodash.castArray;
-    add: typeof lodash.add;
-    after: typeof lodash.after;
-    ary: typeof lodash.ary;
-    assign: typeof lodash.assign;
-    assignIn: typeof lodash.assignIn;
-    assignInWith: typeof lodash.assignInWith;
-    assignWith: typeof lodash.assignWith;
-    at: typeof lodash.at;
-    attempt: typeof lodash.attempt;
-    before: typeof lodash.before;
-    bind: typeof lodash.bind;
-    bindAll: typeof lodash.bindAll;
-    bindKey: typeof lodash.bindKey;
-    camelCase: typeof lodash.camelCase;
-    capitalize: typeof lodash.capitalize;
-    ceil: typeof lodash.ceil;
-    chain: typeof lodash.chain;
-    chunk: typeof lodash.chunk;
-    clamp: typeof lodash.clamp;
-    clone: typeof lodash.clone;
-    cloneDeep: typeof lodash.cloneDeep;
-    cloneDeepWith: typeof lodash.cloneDeepWith;
-    cloneWith: typeof lodash.cloneWith;
-    compact: typeof lodash.compact;
-    concat: typeof lodash.concat;
-    cond: typeof lodash.cond;
-    conforms: typeof lodash.conforms;
-    conformsTo: typeof lodash.conformsTo;
-    constant: typeof lodash.constant;
-    countBy: typeof lodash.countBy;
-    create: typeof lodash.create;
-    curry: typeof lodash.curry;
-    curryRight: typeof lodash.curryRight;
-    debounce: typeof lodash.debounce;
-    deburr: typeof lodash.deburr;
-    defaultTo: typeof lodash.defaultTo;
-    defaults: typeof lodash.defaults;
-    defaultsDeep: typeof lodash.defaultsDeep;
-    defer: typeof lodash.defer;
-    delay: typeof lodash.delay;
-    difference: typeof lodash.difference;
-    differenceBy: typeof lodash.differenceBy;
-    differenceWith: typeof lodash.differenceWith;
-    divide: typeof lodash.divide;
-    drop: typeof lodash.drop;
-    dropRight: typeof lodash.dropRight;
-    dropRightWhile: typeof lodash.dropRightWhile;
-    dropWhile: typeof lodash.dropWhile;
-    each: typeof lodash.each;
-    eachRight: typeof lodash.eachRight;
-    endsWith: typeof lodash.endsWith;
-    entries: typeof lodash.entries;
-    entriesIn: typeof lodash.entriesIn;
-    eq: typeof lodash.eq;
-    escape: typeof lodash.escape;
-    escapeRegExp: typeof lodash.escapeRegExp;
-    every: typeof lodash.every;
-    extendWith: typeof lodash.extendWith;
-    fill: typeof lodash.fill;
-    filter: typeof lodash.filter;
-    find: typeof lodash.find;
-    findIndex: typeof lodash.findIndex;
-    findKey: typeof lodash.findKey;
-    findLast: typeof lodash.findLast;
-    findLastIndex: typeof lodash.findLastIndex;
-    findLastKey: typeof lodash.findLastKey;
-    first: typeof lodash.first;
-    flatMap: typeof lodash.flatMap;
-    flatMapDeep: typeof lodash.flatMapDeep;
-    flatMapDepth: typeof lodash.flatMapDepth;
-    flatten: typeof lodash.flatten;
-    flattenDeep: typeof lodash.flattenDeep;
-    flattenDepth: typeof lodash.flattenDepth;
-    flip: typeof lodash.flip;
-    floor: typeof lodash.floor;
-    flow: typeof lodash.flow;
-    flowRight: typeof lodash.flowRight;
-    forEach: typeof lodash.forEach;
-    forEachRight: typeof lodash.forEachRight;
-    forIn: typeof lodash.forIn;
-    forInRight: typeof lodash.forInRight;
-    forOwn: typeof lodash.forOwn;
-    forOwnRight: typeof lodash.forOwnRight;
-    fromPairs: typeof lodash.fromPairs;
-    functions: typeof lodash.functions;
-    functionsIn: typeof lodash.functionsIn;
-    get: typeof lodash.get;
-    groupBy: typeof lodash.groupBy;
-    gt: typeof lodash.gt;
-    gte: typeof lodash.gte;
-    has: typeof lodash.has;
-    hasIn: typeof lodash.hasIn;
-    head: typeof lodash.head;
-    identity: typeof lodash.identity;
-    inRange: typeof lodash.inRange;
-    includes: typeof lodash.includes;
-    indexOf: typeof lodash.indexOf;
-    initial: typeof lodash.initial;
-    intersection: typeof lodash.intersection;
-    intersectionBy: typeof lodash.intersectionBy;
-    intersectionWith: typeof lodash.intersectionWith;
-    invert: typeof lodash.invert;
-    invertBy: typeof lodash.invertBy;
-    invoke: typeof lodash.invoke;
-    invokeMap: typeof lodash.invokeMap;
-    isArguments: typeof lodash.isArguments;
-    isArray: typeof lodash.isArray;
-    isArrayBuffer: typeof lodash.isArrayBuffer;
-    isArrayLike: typeof lodash.isArrayLike;
-    isArrayLikeObject: typeof lodash.isArrayLikeObject;
-    isBoolean: typeof lodash.isBoolean;
-    isBuffer: typeof lodash.isBuffer;
-    isDate: typeof lodash.isDate;
-    isElement: typeof lodash.isElement;
-    isEqual: typeof lodash.isEqual;
-    isEqualWith: typeof lodash.isEqualWith;
-    isError: typeof lodash.isError;
-    isFinite: typeof lodash.isFinite;
-    isFunction: typeof lodash.isFunction;
-    isInteger: typeof lodash.isInteger;
-    isLength: typeof lodash.isLength;
-    isMap: typeof lodash.isMap;
-    isMatch: typeof lodash.isMatch;
-    isMatchWith: typeof lodash.isMatchWith;
-    isNaN: typeof lodash.isNaN;
-    isNative: typeof lodash.isNative;
-    isNil: typeof lodash.isNil;
-    isNull: typeof lodash.isNull;
-    isNumber: typeof lodash.isNumber;
-    isObject: typeof lodash.isObject;
-    isObjectLike: typeof lodash.isObjectLike;
-    isPlainObject: typeof lodash.isPlainObject;
-    isRegExp: typeof lodash.isRegExp;
-    isSafeInteger: typeof lodash.isSafeInteger;
-    isSet: typeof lodash.isSet;
-    isString: typeof lodash.isString;
-    isSymbol: typeof lodash.isSymbol;
-    isTypedArray: typeof lodash.isTypedArray;
-    isUndefined: typeof lodash.isUndefined;
-    isWeakMap: typeof lodash.isWeakMap;
-    isWeakSet: typeof lodash.isWeakSet;
-    iteratee: typeof lodash.iteratee;
-    join: typeof lodash.join;
-    kebabCase: typeof lodash.kebabCase;
-    keyBy: typeof lodash.keyBy;
-    keys: typeof lodash.keys;
-    keysIn: typeof lodash.keysIn;
-    last: typeof lodash.last;
-    lastIndexOf: typeof lodash.lastIndexOf;
-    lowerCase: typeof lodash.lowerCase;
-    lowerFirst: typeof lodash.lowerFirst;
-    lt: typeof lodash.lt;
-    lte: typeof lodash.lte;
-    map: typeof lodash.map;
-    mapKeys: typeof lodash.mapKeys;
-    mapValues: typeof lodash.mapValues;
-    matches: typeof lodash.matches;
-    matchesProperty: typeof lodash.matchesProperty;
-    max: typeof lodash.max;
-    maxBy: typeof lodash.maxBy;
-    mean: typeof lodash.mean;
-    meanBy: typeof lodash.meanBy;
-    memoize: typeof lodash.memoize;
-    merge: typeof lodash.merge;
-    mergeWith: typeof lodash.mergeWith;
-    method: typeof lodash.method;
-    methodOf: typeof lodash.methodOf;
-    min: typeof lodash.min;
-    minBy: typeof lodash.minBy;
-    mixin: typeof lodash.mixin;
-    multiply: typeof lodash.multiply;
-    negate: typeof lodash.negate;
-    noConflict: typeof lodash.noConflict;
-    noop: typeof lodash.noop;
-    now: typeof lodash.now;
-    nth: typeof lodash.nth;
-    nthArg: typeof lodash.nthArg;
-    omit: typeof lodash.omit;
-    omitBy: typeof lodash.omitBy;
-    once: typeof lodash.once;
-    orderBy: typeof lodash.orderBy;
-    over: typeof lodash.over;
-    overArgs: typeof lodash.overArgs;
-    overEvery: typeof lodash.overEvery;
-    overSome: typeof lodash.overSome;
-    pad: typeof lodash.pad;
-    padEnd: typeof lodash.padEnd;
-    padStart: typeof lodash.padStart;
-    parseInt: typeof lodash.parseInt;
-    partial: typeof lodash.partial;
-    partialRight: typeof lodash.partialRight;
-    partition: typeof lodash.partition;
-    pick: typeof lodash.pick;
-    pickBy: typeof lodash.pickBy;
-    property: typeof lodash.property;
-    propertyOf: typeof lodash.propertyOf;
-    pull: typeof lodash.pull;
-    pullAll: typeof lodash.pullAll;
-    pullAllBy: typeof lodash.pullAllBy;
-    pullAllWith: typeof lodash.pullAllWith;
-    pullAt: typeof lodash.pullAt;
-    random: typeof lodash.random;
-    range: typeof lodash.range;
-    rangeRight: typeof lodash.rangeRight;
-    rearg: typeof lodash.rearg;
-    reduce: typeof lodash.reduce;
-    reduceRight: typeof lodash.reduceRight;
-    reject: typeof lodash.reject;
-    remove: typeof lodash.remove;
-    repeat: typeof lodash.repeat;
-    replace: typeof lodash.replace;
-    rest: typeof lodash.rest;
-    result: typeof lodash.result;
-    reverse: typeof lodash.reverse;
-    round: typeof lodash.round;
-    runInContext: typeof lodash.runInContext;
-    sample: typeof lodash.sample;
-    sampleSize: typeof lodash.sampleSize;
-    set: typeof lodash.set;
-    setWith: typeof lodash.setWith;
-    shuffle: typeof lodash.shuffle;
-    size: typeof lodash.size;
-    slice: typeof lodash.slice;
-    snakeCase: typeof lodash.snakeCase;
-    some: typeof lodash.some;
-    sortBy: typeof lodash.sortBy;
-    sortedIndex: typeof lodash.sortedIndex;
-    sortedIndexBy: typeof lodash.sortedIndexBy;
-    sortedIndexOf: typeof lodash.sortedIndexOf;
-    sortedLastIndex: typeof lodash.sortedLastIndex;
-    sortedLastIndexBy: typeof lodash.sortedLastIndexBy;
-    sortedLastIndexOf: typeof lodash.sortedLastIndexOf;
-    sortedUniq: typeof lodash.sortedUniq;
-    sortedUniqBy: typeof lodash.sortedUniqBy;
-    split: typeof lodash.split;
-    spread: typeof lodash.spread;
-    startCase: typeof lodash.startCase;
-    startsWith: typeof lodash.startsWith;
-    stubArray: typeof lodash.stubArray;
-    stubFalse: typeof lodash.stubFalse;
-    stubObject: typeof lodash.stubObject;
-    stubString: typeof lodash.stubString;
-    stubTrue: typeof lodash.stubTrue;
-    subtract: typeof lodash.subtract;
-    sum: typeof lodash.sum;
-    sumBy: typeof lodash.sumBy;
-    tail: typeof lodash.tail;
-    take: typeof lodash.take;
-    takeRight: typeof lodash.takeRight;
-    takeRightWhile: typeof lodash.takeRightWhile;
-    takeWhile: typeof lodash.takeWhile;
-    tap: typeof lodash.tap;
-    template: typeof lodash.template;
-    throttle: typeof lodash.throttle;
-    thru: typeof lodash.thru;
-    times: typeof lodash.times;
-    toArray: typeof lodash.toArray;
-    toFinite: typeof lodash.toFinite;
-    toInteger: typeof lodash.toInteger;
-    toLength: typeof lodash.toLength;
-    toLower: typeof lodash.toLower;
-    toPairs: typeof lodash.toPairs;
-    toPairsIn: typeof lodash.toPairsIn;
-    toPath: typeof lodash.toPath;
-    toPlainObject: typeof lodash.toPlainObject;
-    toSafeInteger: typeof lodash.toSafeInteger;
-    toString: typeof lodash.toString;
-    toUpper: typeof lodash.toUpper;
-    transform: typeof lodash.transform;
-    trim: typeof lodash.trim;
-    trimEnd: typeof lodash.trimEnd;
-    trimStart: typeof lodash.trimStart;
-    truncate: typeof lodash.truncate;
-    unary: typeof lodash.unary;
-    unescape: typeof lodash.unescape;
-    union: typeof lodash.union;
-    unionBy: typeof lodash.unionBy;
-    unionWith: typeof lodash.unionWith;
-    uniq: typeof lodash.uniq;
-    uniqBy: typeof lodash.uniqBy;
-    uniqWith: typeof lodash.uniqWith;
-    uniqueId: typeof lodash.uniqueId;
-    unset: typeof lodash.unset;
-    unzip: typeof lodash.unzip;
-    unzipWith: typeof lodash.unzipWith;
-    update: typeof lodash.update;
-    updateWith: typeof lodash.updateWith;
-    upperCase: typeof lodash.upperCase;
-    upperFirst: typeof lodash.upperFirst;
-    values: typeof lodash.values;
-    valuesIn: typeof lodash.valuesIn;
-    without: typeof lodash.without;
-    words: typeof lodash.words;
-    wrap: typeof lodash.wrap;
-    xor: typeof lodash.xor;
-    xorBy: typeof lodash.xorBy;
-    xorWith: typeof lodash.xorWith;
-    zip: typeof lodash.zip;
-    zipObject: typeof lodash.zipObject;
-    zipObjectDeep: typeof lodash.zipObjectDeep;
-    zipWith: typeof lodash.zipWith;
+    /**
+     * 登録済みプラグイン名のレジストリ。
+     * プラグインの side-effect import 時に重複登録を防ぐために使用される。
+     * 通常コードから直接触らないこと。
+     * @internal
+     */
+    __plugins: Set<string>;
 }
 declare const _: AnsukoType;
 export default _;

package/dist/index.js

@@ -564,24 +564,9 @@ const arrayDepth = (ary) => {
     }
     return 1 + Math.min(...ary.map(arrayDepth));
 };
-/**
- * Extends ansuko with a plugin and returns the augmented instance.
- * @param plugin - Plugin function
- * @returns Extended instance
- * @example const extended = lodash.extend(jaPlugin)
- * @category Core Functions
- */
-const extend = function (plugin) {
-    if (typeof plugin === 'function') {
-        return plugin(this); // プラグインの戻り値をそのまま返す
-    }
-    return this;
-};
-// Ansuko型へのキャストを外し、より安全な unknown as LoDashStatic に変更
 // 変数名を _ にすることで、VS Code の auto import 候補が `_` として表示される
 const _ = {
     ...lodash,
-    extend,
     isEmptyOrg: lodash.isEmpty,
     toNumberOrg: lodash.toNumber,
     castArrayOrg: lodash.castArray,
@@ -603,6 +588,7 @@ const _ = {
     swallow,
     swallowMap,
     arrayDepth,
+    __plugins: new Set(),
 };
 export default _;
 // 個別エクスポートはそのまま

package/dist/plugins/geo.d.ts

@@ -1,5 +1,4 @@
-import GeoJSON from "geojson";
-import { type AnsukoType } from "../index.js";
+import GeoJSON, { Geometry } from "geojson";
 /**
  * Geometry type selector for conversions. Use `auto` to try higher dimensions first.
  */
@@ -12,8 +11,15 @@ export declare enum GeomType {
     multiLineString = 5,
     auto = "auto"
 }
+/**
+ * geo プラグインが ansuko に追加するメソッド群。
+ *
+ * このインターフェースは下記の `declare module` ブロックで `AnsukoType` に merge され、
+ * `import "ansuko/plugins/geo"` するだけで `_` の型が自動的に拡張される。
+ */
 export interface AnsukoGeoPluginExtension {
     toLngLatArray: (coord: any, digit?: number) => [lng: number, lat: number] | null;
+    toGeoJson: (geo: any, type?: GeomType, digit?: number) => Geometry | null;
     toPointGeoJson: (geo: any, digit?: number) => GeoJSON.Point | null;
     toPolygonGeoJson: (geo: any, digit?: number) => GeoJSON.Polygon | null;
     toLineStringGeoJson: (geo: any, digit?: number) => GeoJSON.LineString | null;
@@ -21,8 +27,12 @@ export interface AnsukoGeoPluginExtension {
     toMultiPolygonGeoJson: (geo: any, digit?: number) => GeoJSON.MultiPolygon | null;
     toMultiLineStringGeoJson: (geo: any, digit?: number) => GeoJSON.MultiLineString | null;
     unionPolygon: (geo: any, digit?: number) => GeoJSON.Polygon | GeoJSON.MultiPolygon | null;
+    parseToTerraDraw: (geo: any) => GeoJSON.Feature[];
     mZoomInterpolate: (zoomValues: Record<number, number>, type?: string) => any;
     mProps: (properties: Record<string, any>, excludeKeys?: string[]) => Record<string, any>;
 }
-declare const ansukoGeoPlugin: <T extends AnsukoType>(ansuko: T) => T & AnsukoGeoPluginExtension;
-export default ansukoGeoPlugin;
+declare module "../index.js" {
+    interface AnsukoType extends AnsukoGeoPluginExtension {
+    }
+}
+export {};

package/dist/plugins/geo.js

@@ -1,4 +1,5 @@
 import * as turf from "@turf/turf";
+import _ from "../index.js";
 /**
  * Geometry type selector for conversions. Use `auto` to try higher dimensions first.
  */
@@ -12,8 +13,9 @@ export var GeomType;
     GeomType[GeomType["multiLineString"] = 5] = "multiLineString";
     GeomType["auto"] = "auto";
 })(GeomType || (GeomType = {}));
-const ansukoGeoPlugin = (ansuko) => {
-    const _ = ansuko;
+const PLUGIN_NAME = "geo";
+if (!_.__plugins.has(PLUGIN_NAME)) {
+    _.__plugins.add(PLUGIN_NAME);
     /**
      * Converts a coordinate-like value to a [lng, lat] tuple, optionally rounding digits.
      * Swaps order if lat/lng appear to be inverted. Returns null when invalid.
@@ -653,7 +655,7 @@ const ansukoGeoPlugin = (ansuko) => {
         }
         return properties;
     };
-    const a = ansuko;
+    const a = _;
     a.toLngLatArray = toLngLatArray;
     a.toGeoJson = toGeoJson;
     a.toPointGeoJson = toPointGeoJson;
@@ -666,6 +668,4 @@ const ansukoGeoPlugin = (ansuko) => {
     a.parseToTerraDraw = parseToTerraDraw;
     a.mZoomInterpolate = mZoomInterpolate;
     a.mProps = mProps;
-    return ansuko;
-};
-export default ansukoGeoPlugin;
+}

package/dist/plugins/ja.d.ts

@@ -1,13 +1,21 @@
-import { type AnsukoType } from "../index.js";
-import { toHalfWidth, haifun } from "../util.js";
+import { toHalfWidth as utilToHalfWidth, haifun } from "../util.js";
+/**
+ * ja プラグインが ansuko に追加するメソッド群。
+ *
+ * このインターフェースは下記の `declare module` ブロックで `AnsukoType` に merge され、
+ * `import "ansuko/plugins/ja"` するだけで `_` の型が自動的に拡張される。
+ */
 export interface AnsukoJaExtension {
     kanaToFull: (str: unknown) => string | null;
     kanaToHalf: (str: unknown) => string | null;
     kanaToHira: (str: unknown) => string | null;
     hiraToKana: (str: unknown) => string | null;
-    toHalfWidth: typeof toHalfWidth;
+    toHalfWidth: typeof utilToHalfWidth;
     toFullWidth: (value: unknown, withHaifun?: string) => string | null;
     haifun: typeof haifun;
 }
-declare const ansukoJaPlugin: <T extends AnsukoType>(ansuko: T) => T & AnsukoJaExtension;
-export default ansukoJaPlugin;
+declare module "../index.js" {
+    interface AnsukoType extends AnsukoJaExtension {
+    }
+}
+export {};

package/dist/plugins/ja.js

@@ -1,6 +1,8 @@
+import _ from "../index.js";
 import { haifun } from "../util.js";
-const ansukoJaPlugin = (ansuko) => {
-    const _ = ansuko;
+const PLUGIN_NAME = "ja";
+if (!_.__plugins.has(PLUGIN_NAME)) {
+    _.__plugins.add(PLUGIN_NAME);
     const kanaMap = {
         'ｶﾞ': 'ガ', 'ｷﾞ': 'ギ', 'ｸﾞ': 'グ', 'ｹﾞ': 'ゲ', 'ｺﾞ': 'ゴ',
         'ｻﾞ': 'ザ', 'ｼﾞ': 'ジ', 'ｽﾞ': 'ズ', 'ｾﾞ': 'ゼ', 'ｿﾞ': 'ゾ',
@@ -64,7 +66,7 @@ const ansukoJaPlugin = (ansuko) => {
         if (!_.isValidStr(str)) {
             return null;
         }
-        return kanaToFull(str)?.replace(/[\u30a1-\u30f6]/g, s => String.fromCharCode(s.charCodeAt(0) - 0x60)) ?? null;
+        return kanaToFull(str)?.replace(/[ァ-ヶ]/g, s => String.fromCharCode(s.charCodeAt(0) - 0x60)) ?? null;
     };
     /**
      * Converts hiragana to katakana.
@@ -77,7 +79,7 @@ const ansukoJaPlugin = (ansuko) => {
         if (!_.isValidStr(str)) {
             return null;
         }
-        return str.replace(/[\u3041-\u3096]/g, s => String.fromCharCode(s.charCodeAt(0) + 0x60)) ?? null;
+        return str.replace(/[ぁ-ゖ]/g, s => String.fromCharCode(s.charCodeAt(0) + 0x60)) ?? null;
     };
     /**
      * Converts half-width characters to full-width; optionally normalizes hyphens.
@@ -99,7 +101,7 @@ const ansukoJaPlugin = (ansuko) => {
             const code = char.charCodeAt(0);
             // スペース
             if (code === 0x0020) {
-                return '\u3000'; // 全角スペース
+                return '　'; // 全角スペース
             }
             // 全角は0x0021～0x007E、半角は0xFF01～0xFF5E
             if (code >= 0x0021 && code <= 0x007E) {
@@ -126,7 +128,7 @@ const ansukoJaPlugin = (ansuko) => {
             const code = char.charCodeAt(0);
             // スペース
             if (code === 0x3000) {
-                return '\u0020'; // 半角スペース
+                return ' '; // 半角スペース
             }
             // 全角は0xFF01～0xFF5E、半角は0x0021～0x007E
             if (code >= 0xFF01 && code <= 0xFF5E) {
@@ -136,7 +138,7 @@ const ansukoJaPlugin = (ansuko) => {
         }).join('');
         return withHaifun ? haifun(str, withHaifun) : str;
     };
-    const a = ansuko;
+    const a = _;
     a.kanaToFull = kanaToFull;
     a.kanaToHalf = kanaToHalf;
     a.kanaToHira = kanaToHira;
@@ -144,6 +146,4 @@ const ansukoJaPlugin = (ansuko) => {
     a.toHalfWidth = toHalfWidth;
     a.toFullWidth = toFullWidth;
     a.haifun = haifun;
-    return ansuko;
-};
-export default ansukoJaPlugin;
+}

package/dist/plugins/prototype.d.ts

@@ -18,5 +18,4 @@ declare global {
         notFilter(predicate: (item: T) => boolean): T[];
     }
 }
-declare const ansukoPrototypePlugin: (ansuko: any) => void;
-export default ansukoPrototypePlugin;
+export {};

package/dist/plugins/prototype.js

@@ -1,9 +1,11 @@
-const ansukoPrototypePlugin = (ansuko) => {
+import _ from "../index.js";
+const PLUGIN_NAME = "prototype";
+if (!_.__plugins.has(PLUGIN_NAME)) {
+    _.__plugins.add(PLUGIN_NAME);
     Array.prototype.notMap = function (predicate) {
-        return this.map(ansuko.negate(predicate));
+        return this.map(_.negate(predicate));
     };
     Array.prototype.notFilter = function (predicate) {
-        return this.filter(ansuko.negate(predicate));
+        return this.filter(_.negate(predicate));
     };
-};
-export default ansukoPrototypePlugin;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansuko",
-  "version": "1.3.15",
+  "version": "2.0.1",
   "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",