ansuko 1.3.2 → 1.3.3

package/README.ja.md

@@ -167,6 +167,17 @@ extended.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
 
 // 複数のポリゴンを結合
 const unified = extended.unionPolygon([polygon1, polygon2])
+
+// MapBoxユーティリティ
+extended.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+// => ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
+
+extended.mProps({
+  fillColor: "#ff0000",
+  sourceLayer: "buildings",
+  visibility: true
+})
+// => { "fill-color": "#ff0000", "source-layer": "buildings", "visibility": "visible" }
 ```
 
 #### Prototypeプラグイン
@@ -254,6 +265,8 @@ extended.toPointGeoJson([139.7, 35.6])
 - **`toMultiLineStringGeoJson`** - 複数の線をMultiLineStringに変換
 - **`unionPolygon`** - 複数のPolygon/MultiPolygonを単一のジオメトリに結合
 - **`parseToTerraDraw`** - GeoJSONをTerra Draw互換のフィーチャーに変換
+- **`mZoomInterpolate`** - ズームオブジェクトをMapBox補間式に変換
+- **`mProps`** - camelCaseプロパティをMapBox互換形式に変換（minzoom、visibilityなどの特殊ケースに対応）
 
 ### Prototype拡張（プラグイン: `ansuko/plugins/prototype`）
 

package/README.md

@@ -143,6 +143,8 @@ const value = _.equalsOr(a, b, defaultValue)  // null == undefined
 - **`toMultiLineStringGeoJson`** - Convert multiple lines to MultiLineString
 - **`unionPolygon`** - Union multiple Polygon/MultiPolygon into single geometry
 - **`parseToTerraDraw`** - Convert GeoJSON to Terra Draw compatible features
+- **`mZoomInterpolate`** - Convert zoom object to MapBox interpolation expression
+- **`mProps`** - Convert camelCase properties to MapBox-compatible format (handles special cases like minzoom, visibility)
 
 ### Prototype Extensions (plugin: `ansuko/plugins/prototype`)
 
@@ -244,6 +246,17 @@ extended.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
 
 // Union multiple polygons
 const unified = extended.unionPolygon([polygon1, polygon2])
+
+// MapBox utilities
+extended.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+// => ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
+
+extended.mProps({
+  fillColor: "#ff0000",
+  sourceLayer: "buildings",
+  visibility: true
+})
+// => { "fill-color": "#ff0000", "source-layer": "buildings", "visibility": "visible" }
 ```
 
 #### Prototype Plugin

package/README.zh.md

@@ -142,6 +142,8 @@ const value = _.equalsOr(a, b, defaultValue)  // null == undefined
 - **`toMultiLineStringGeoJson`** - 将多条线转换为 MultiLineString
 - **`unionPolygon`** - 将多个 Polygon/MultiPolygon 合并为单个几何
 - **`parseToTerraDraw`** - 将 GeoJSON 转换为 Terra Draw 兼容的要素
+- **`mZoomInterpolate`** - 将缩放对象转换为 MapBox 插值表达式
+- **`mProps`** - 将 camelCase 属性转换为 MapBox 兼容格式（处理 minzoom、visibility 等特殊情况）
 
 ### 原型扩展（插件：`ansuko/plugins/prototype`）
 
@@ -243,6 +245,17 @@ extended.toPointGeoJson({ lat: 35.6895, lng: 139.6917 })
 
 // 合并多个多边形
 const unified = extended.unionPolygon([polygon1, polygon2])
+
+// MapBox 工具
+extended.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+// => ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
+
+extended.mProps({
+  fillColor: "#ff0000",
+  sourceLayer: "buildings",
+  visibility: true
+})
+// => { "fill-color": "#ff0000", "source-layer": "buildings", "visibility": "visible" }
 ```
 
 #### 原型插件

package/dist/plugins/geo.d.ts

@@ -21,6 +21,8 @@ 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;
+    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;

package/dist/plugins/geo.js

@@ -551,6 +551,108 @@ const ansukoGeoPlugin = (ansuko) => {
         }
         return features;
     };
+    /**
+     * Creates a MapBox zoom interpolation expression from a simple object mapping.
+     * Converts `{10: 1, 15: 5, 20: 10}` into MapBox's interpolation array format.
+     *
+     * @param zoomValues - Object mapping zoom levels to values
+     * @param type - Interpolation type: "linear", "exponential", or "cubic-bezier" (default: "linear")
+     * @returns MapBox interpolation expression array
+     * @example
+     * _.mZoomInterpolate({ 10: 1, 15: 5, 20: 10 })
+     * // Returns: ["interpolate", ["linear"], ["zoom"], 10, 1, 15, 5, 20, 10]
+     * @example
+     * _.mZoomInterpolate({ 12: 0.5, 18: 2 }, "exponential")
+     * @category Geo Utilities
+     */
+    const mZoomInterpolate = (zoomValues, type = "linear") => {
+        let vals = [];
+        Object.entries(zoomValues).sort((v1, v2) => {
+            return parseFloat(v1[0]) - parseFloat(v2[0]);
+        }).map(([zoom, val]) => {
+            vals.push(parseFloat(zoom));
+            vals.push(val);
+        });
+        return [
+            "interpolate",
+            [type],
+            ["zoom"],
+            ...vals,
+        ];
+    };
+    /**
+     * Converts camelCase properties to MapBox-compatible format.
+     * Handles special cases like minzoom, maxzoom, tileSize, cluster properties, and converts
+     * visibility boolean to "visible"/"none". Recursively processes nested objects and arrays.
+     *
+     * @param properties - Object with camelCase properties
+     * @param excludeKeys - Keys to exclude from conversion (keeps original key and value)
+     * @returns Converted properties object compatible with MapBox
+     * @example
+     * _.mProps({
+     *   fillColor: "#ff0000",
+     *   fillOpacity: 0.5,
+     *   sourceLayer: "buildings"
+     * })
+     * // Returns: { "fill-color": "#ff0000", "fill-opacity": 0.5, "source-layer": "buildings" }
+     * @example
+     * _.mProps({ visibility: true }) // Returns: { visibility: "visible" }
+     * @example
+     * _.mProps({ minZoom: 10, maxZoom: 20 }) // Returns: { minzoom: 10, maxzoom: 20 }
+     * @category Geo Utilities
+     */
+    const mProps = (properties, excludeKeys = []) => {
+        if (_.isEmpty(properties)) {
+            return properties;
+        }
+        if (Array.isArray(properties)) {
+            return properties.map(p => mProps(p, excludeKeys));
+        }
+        if (typeof properties === "object") {
+            return Object.fromEntries(Object.entries(properties).map(([key, value]) => {
+                let newKey = key;
+                const lKey = key.toLowerCase();
+                if (lKey === "minzoom") {
+                    newKey = "minzoom";
+                }
+                else if (lKey === "maxzoom") {
+                    newKey = "maxzoom";
+                }
+                else if (lKey === "tilesize") {
+                    newKey = "tileSize";
+                }
+                else if (lKey === "clusterradius") {
+                    newKey = "clusterRadius";
+                }
+                else if (lKey === "clustermaxzoom") {
+                    newKey = "clusterMaxZoom";
+                }
+                else if (lKey === "clusterminpoints") {
+                    newKey = "clusterMinPoints";
+                }
+                else if (lKey === "clusterproperties") {
+                    newKey = "clusterProperties";
+                }
+                else if (lKey === "linemetrics") {
+                    newKey = "lineMetrics";
+                }
+                else {
+                    newKey = _.kebabCase(newKey).toLowerCase();
+                }
+                if (key === "visibility" && _.isBoolean(value)) {
+                    return ["visibility", value ? "visible" : "none"];
+                }
+                if (excludeKeys.includes(key) || excludeKeys.includes(newKey)) {
+                    return [key, value];
+                }
+                if (Array.isArray(value) || typeof value === "object") {
+                    value = mProps(value, excludeKeys);
+                }
+                return [newKey, value];
+            }));
+        }
+        return properties;
+    };
     const a = ansuko;
     a.toLngLatArray = toLngLatArray;
     a.toGeoJson = toGeoJson;
@@ -562,6 +664,8 @@ const ansukoGeoPlugin = (ansuko) => {
     a.toMultiPolygonGeoJson = toMultiPolygonGeoJson;
     a.unionPolygon = unionPolygon;
     a.parseToTerraDraw = parseToTerraDraw;
+    a.mZoomInterpolate = mZoomInterpolate;
+    a.mProps = mProps;
     return ansuko;
 };
 export default ansukoGeoPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansuko",
-  "version": "1.3.2",
+  "version": "1.3.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",