refactor(layers,core): genericize ILayer.getScale with IStyleScale default (stage-3 3.2)

3.2 收尾刀：把返回 `any` 的 `getScale` 收紧为泛型签名，默认
`IStyleScale`（该返回路径的实际语义结构：scale/field/type/option）。

- core `ILayer.getScale(name): any` → `getScale<T = IStyleScale>(name): T`
  （`ILayerService.ts`）。默认 IStyleScale 比严格 any 安全，调用方可
  opt-in 泛型；底层 `getLayerAttributeScale` 仍 any（scaler 未具名，
  归后续 scale service 专属刀），经 `as T` 透传不引入类型错误。
- layers `BaseLayer.getScale<T = IStyleScale>(name): T` → 委托
  `scaleLegendManager.getScale<T>(name)`；`LayerScaleLegend.getScale`
  同步、`getLayerAttributeScale(name) as T`。纯内部签名对齐。

运行时零行为变化，仅类型面收紧。验证：core+layers father build
（98/278 files，d.ts 生成通过）、eslint/prettier 0 error、jest
packages/layers packages/maps 0 failed（660 passed，1 skipped
citybuilding 基线不变）。PLAN 3.2 标 ☑ 完成。

Author: lzxue

.changeset/refactor-core-getscale-generic.md

@@ -0,0 +1,22 @@
+---
+'@antv/l7-core': minor
+---
+
+refactor(core): genericize ILayer.getScale with IStyleScale default (stage-3 3.2)
+
+P4 阶段 3 第二刀收尾（3.2，core 侧，minor）。
+
+`ILayer.getScale(name: string): any` →
+`getScale<T = IStyleScale>(name: string): T`（`ILayerService.ts`）。
+默认 `IStyleScale` 为该返回路径的实际语义结构
+（`scale`/`field`/`type`/`option`，见 `IStyleAttributeService`），
+比 `any` 严格且对未指定 `T` 的调用方保持类型安全；调用方可显式 opt-in
+泛型。底层 `styleAttributeService.getLayerAttributeScale(name)` 仍返
+`any`（scaler 结构未具名，归后续 scale service 专属刀），经 `as T`
+透传不引入类型错误。
+
+运行时零行为变化，仅类型面收紧。配套 layers 侧实现同步见
+`refactor-layers-getscale-generic` changeset。
+
+验证：core eslint 0 error、prettier 通过、core father build 98 files
+（d.ts 生成、类型检查通过）。

.changeset/refactor-layers-getscale-generic.md

@@ -0,0 +1,23 @@
+---
+'@antv/l7-layers': patch
+---
+
+refactor(layers): align getScale generic signature with ILayer (stage-3 3.2)
+
+P4 阶段 3 第二刀收尾（3.2，layers 侧，patch）。
+
+`BaseLayer.getScale` 与 `LayerScaleLegend.getScale` 同步加
+`<T = IStyleScale>` 泛型签名，对齐 `@antv/l7-core` 的 `ILayer.getScale`
+接口变更（见 `refactor-core-getscale-generic` changeset）：
+
+- `BaseLayer.getScale<T = IStyleScale>(name): T` →
+  `return this.scaleLegendManager.getScale<T>(name)`
+- `LayerScaleLegend.getScale<T = IStyleScale>(name): T` →
+  `return this.layer.styleAttributeService
+.getLayerAttributeScale(name) as T`
+
+纯内部签名对齐，运行时零行为变化。
+
+验证：layers eslint 0 error、prettier 通过、layers father build 278 files
+（d.ts 生成、类型检查通过）、jest packages/layers packages/maps
+0 failed（660 passed，1 skipped citybuilding 基线不变）。

docs/refactoring/layers/PLAN.md

@@ -93,7 +93,7 @@ citybuilding/ geometry/ — 12 个具体图层 extends BaseLayer（各自只 ove
 ### 阶段 3 — 配置模型与类型强化
 
 - 3.1 定义 `LayerConfigModel` 收敛三轨：`rawConfig`（入参快照）/ `needUpdateConfig`（diff 暂存）/ `getLayerConfig()`（`globalConfigService` 读回）→ 统一为 `LayerConfigModel.read()` 单一读路径 + `apply(patch)` 单一写路径，`prepareBuildModel` 消费 diff。`ILayer.getLayerConfig<T>()` 签名不变。
-- 3.2 给 `defaultSourceConfig/sourceOption/shapeOption/encodeStyleAttribute` 补严格类型（替 `any`）：引入 `ILayerSourceOption/IShapeOption/IEncodedStyleMap`，`get(name)`/`getScale(name)` 标泛型或返回联合类型。 **（☑ 部分完成；`defaultSourceConfig`/`sourceOption`/`shapeOption`/`get(name)` 历史已各自定型为 `IDefaultSourceConfig`/`ISourceOption`/`IShapeOption`/`number`，本刀补齐 `encodeStyleAttribute` → `IEncodedStyleMap`（core 新增 `IEncodedStyleValue`+`IEncodedStyleMap`）；剩 `getScale(name):any` 泛型化归后续 scale delegate 专属刀。）**
+- 3.2 给 `defaultSourceConfig/sourceOption/shapeOption/encodeStyleAttribute` 补严格类型（替 `any`）：引入 `ILayerSourceOption/IShapeOption/IEncodedStyleMap`，`get(name)`/`getScale(name)` 标泛型或返回联合类型。 **（☑ 完成；`defaultSourceConfig`/`sourceOption`/`shapeOption`/`get(name)` 历史已各自定型为 `IDefaultSourceConfig`/`ISourceOption`/`IShapeOption`/`number`；`encodeStyleAttribute` → `IEncodedStyleMap`（core 新增 `IEncodedStyleValue`+`IEncodedStyleMap`）；`getScale(name):any` → `getScale<T = IStyleScale>(name): T`（core `ILayer` 接口 + layers `BaseLayer`/`LayerScaleLegend` 同步；默认 `IStyleScale` 语义收紧、运行时零变化、`getLayerAttributeScale` 底层 `any` 归后续 scale service 专属刀）。）**
 - 3.3 `enableShaderEncodeStyles/enableDataEncodeStyles: string[]` → 收敛为 `encodeStyles: Map<string,'shader'|'data'>`（内部），公开数组 getter 保留过渡；补 spec 锁定编码开关行为。 **（☑ 已完成；BaseLayer 加 `encodeStyles:Map`+`EncodeStyleKind`(core)+`setEncodeStyles` helper+数组 getter；point/line/polygon 子类字段初始化器改 constructor 调 `setEncodeStyles`；`encodeStyle()` 读改 `Map.has`；新 `encode-styles.spec.ts` 7 cases 锁定；公开 `ILayer` 数组契约保留）**
 
 ### 阶段 4 — 渲染管线收敛

packages/core/src/services/layer/ILayerService.ts

@@ -39,6 +39,7 @@ import type {
   IStyleAttribute,
   IStyleAttributeService,
   IStyleAttributeUpdateOptions,
+  IStyleScale,
   ScaleTypeName,
   StyleAttrField,
   StyleAttributeField,
@@ -499,7 +500,7 @@ export interface ILayer {
   setLayerPickService(layerPickService: ILayerPickService): void;
   init(): Promise<void>;
   scale(field: string | number | IScaleOptions, cfg?: IScale): ILayer;
-  getScale(name: string): any;
+  getScale<T = IStyleScale>(name: string): T;
   size(field: StyleAttrField, value?: StyleAttributeOption): ILayer;
   color(field: StyleAttrField, value?: StyleAttributeOption): ILayer;
   rotate(field: StyleAttrField, value?: StyleAttributeOption): ILayer;

packages/layers/src/core/BaseLayer.ts

@@ -32,6 +32,7 @@ import type {
   ISourceOption,
   IStyleAttributeService,
   IStyleAttributeUpdateOptions,
+  IStyleScale,
   ITextureService,
   L7Container,
   LayerEventType,
@@ -980,8 +981,8 @@ export default class BaseLayer<ChildLayerStyleOptions = {}>
     return this.encodedData;
   }
 
-  public getScale(name: string): any {
-    return this.scaleLegendManager.getScale(name);
+  public getScale<T = IStyleScale>(name: string): T {
+    return this.scaleLegendManager.getScale<T>(name);
   }
 
   public getLegend(name: string): ILegend {

packages/layers/src/core/LayerScaleLegend.ts

@@ -4,6 +4,7 @@ import type {
   ILegendSegmentItem,
   IScale,
   IScaleOptions,
+  IStyleScale,
   LegendItems,
 } from '@antv/l7-core';
 import { lodashUtil } from '@antv/l7-utils';
@@ -54,8 +55,8 @@ export default class LayerScaleLegend {
     return this.scaleOptions;
   }
 
-  public getScale(name: string): any {
-    return this.layer.styleAttributeService.getLayerAttributeScale(name);
+  public getScale<T = IStyleScale>(name: string): T {
+    return this.layer.styleAttributeService.getLayerAttributeScale(name) as T;
   }
 
   public getLegend(name: string): ILegend {