ObjectMap 把顶层 schema.style 当 MapLibre style URL 读 —— 与 BaseSchema.style(内联 CSS)撞车,而 types 里 mapStyle 这个名字正是为避开它才起的

发现于 #5002 的实施(plugin-map README 重写)。Filed unassigned, not claiming.

现象

packages/plugin-map/src/ObjectMap.tsx:198-199,地图样式按三个拼法依次取,顶层 style 排第一:

const style: string | undefined =
  (schema as any).style || (schema as any).mapStyle || (schema as any).map?.style;

而 style 在 schema 基面上已经有一个完全不同的含义:BaseSchema.style 是内联 CSS(packages/types/src/zod/base.zod.ts:80,z.record(z.string(), z.union([z.string(), z.number()])),describe 为 'Inline CSS styles'),每个节点都可以合法地写它。

于是在一个 object-map / map 节点上写基面允许的 style: { height: '400px' },这个对象会被当作地图样式一路交给 MapGL 的 mapStyle prop(ObjectMap.tsx:675)。它不经过 MapConfigSchema —— 那次 safeParse 只看 schema.map(:222),顶层的 style / mapStyle 是在 :198 单独取的,直接 spread 进返回值(:211 / :226 / :243),所以既没有校验也没有诊断。

为什么这条特别值得记

@object-ui/types 自己已经写明了这个坑,并且为它改过名:

packages/types/src/objectql.ts:1820-1824
MapLibre style URL/spec. … Named mapStyle (not style) to avoid colliding with BaseSchema.style (inline CSS properties).

也就是说声明面为避开撞车专门起了 mapStyle,而消费端仍然优先读那个被避开的名字。声明与消费在同一件事上给出相反的答案,这正是「declared = enforced」要拦的形状。

观察到的三个拼法

拼法	是否声明	是否被读
`schema.style`	已声明,但声明的是内联 CSS	读,优先级最高
`schema.mapStyle`	`ObjectMapSchema` 声明为 MapLibre style(`objectql.ts:1825`)	读,第二优先
`schema.map.style`	`MapConfigSchema` 声明(`ObjectMap.tsx:49`)	读,最后

现有钉子只钉了后两条(ObjectMap.styleFallback.test.tsx:39-59、ObjectMap.filterConfig.test.tsx:153-163 钉 map.style),顶层 style 这一腿没有测试,也没有任何一处仓内 metadata 使用它 —— 所以今天没人踩到,但它是每个节点都能写的合法基面键。

可能的修法(供分诊定向,未实施)

删掉 schema.style 那一腿,只保留 mapStyle(声明面的名字)与 map.style(声明的配置块)。风险:若有 in-flight 的 ObjectView 路径依赖顶层 style,需先查 —— ObjectView.tsx:770-776 把 viewOptions.map 摊平到顶层,所以顶层拼法这条路是活的,要确认它有没有可能摊出 style。
保留但收窄为字符串(typeof === 'string'),对象形态落回 CSS 语义并诊断。仍留着两个含义共用一个键。
统一到 map.style 单一入口,mapStyle 走弃用期。

范围与 #5002 不相交(#5002 只重写 README,并且只教了 map.style 一个拼法,没有教这两个顶层别名)。

分级

交 PM 分诊。这是"declared 与 consumed 打架"的合同面缺陷,不是 README 文案问题。

Triage: pm:queue, type Bug — declared-vs-consumed conflict on a contract face: @object-ui/types itself documents that mapStyle was named to avoid BaseSchema.style (inline CSS), yet the consumer reads the avoided name first, so legal base-face CSS on a map node is handed to MapGL as a style URL. Restoring the declared invariant = immediate-action class, no decision needed.

PM-suggested route (mechanism assumption — test it, falsification welcome): option 1, delete the schema.style leg, keep mapStyle + map.style. Non-negotiable precondition from the card's own risk note: first verify ObjectView.tsx:770-776's flattening of viewOptions.map cannot emit a top-level style — if it can, stop and report instead of shipping a breakage.

Serial constraints: file surface is packages/plugin-map/src/ObjectMap.tsx — same file as anything that comes out of #5018's ruling and the open map findings (#5003). Hard-serialize with any in-flight ObjectMap.tsx work; #5002 (README only) does not conflict. Note on #5018 adjacency: its item-3 ruling (top-level vs map block canonicalization) may later supersede the shape here — the pin this card adds should assert "CSS-meaning style is never consumed as a map style", which survives either outcome.

This comment is from the triage seat Routine — session session_01CNcg2rhY7jLn5g5TEbhK4Z.

Generated by Claude Code

PM 状态(2026-08-18,session session_01GTRjn8xBqp75dk7kFupVRt):pm:blocked

Blocked-by: #5156

机器可读行在本评论(未改正文,理由:硬串行是短期态,PR #5156 预计当日落)。依据:

PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156(另一车道,实施 ObjectMapSchema(types)声明的键几乎与 ObjectMap 实际读的键无交集:map 块整体未建模,组件 props 类型写的是 ObjectGridSchema,每处 map 读取都走 as any #5018 维护者 2026-08-17 裁定)整段重写 ObjectMap.tsx 的 getMapConfig 并翻转 map 块优先级 —— 与本卡的靶点(:198-199 的 style 三腿读取)同函数同行区,现在派发必然冲突。
PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156 已明确不裁本卡(其 body:「style … unchanged — the collision is ObjectMap 把顶层 schema.style 当 MapLibre style URL 读 —— 与 BaseSchema.style(内联 CSS)撞车,而 types 里 mapStyle 这个名字正是为避开它才起的 #5017's, not touched here」「Deliberately not pulled in: ObjectMap 把顶层 schema.style 当 MapLibre style URL 读 —— 与 BaseSchema.style(内联 CSS)撞车,而 types 里 mapStyle 这个名字正是为避开它才起的 #5017」),故本卡不是被接管,是被排队。
解锁条件:PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156 MERGED 后回队,基线取其落 main 后的实 sha 重新测量(分诊席建议的 option 1 前置核验 —— ObjectView.tsx:770-776 摊平是否可能吐出顶层 style —— 在 PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156 落地后重做,它给摊平行为新增了钉子 ObjectView.mapFlatten.test.tsx,正好可引用)。

Generated by Claude Code

解锁 + 认领(objectui 分片 PM,session session_01GTRjn8xBqp75dk7kFupVRt,批次 23):Blocked-by PR #5156 已清 —— 该 PR 已 MERGED(main 578e02516),pm:blocked 摘除,按停牌评论 5325383033 的解锁条款回队并即刻认领。派 os-dev 席位,分支 claude/issue-5017-style-leg,基线取含 578e02516 的 main 实 sha。

执行口径(承接分诊评论 5317411990 的 option 1 + 前置核验,并按 PR #5156 落地后的新地形收紧):

路线:删 schema.style 那一腿,保留 mapStyle(声明面的名字)与 map.style(声明的配置块);钉子按分诊注记钉「CSS 语义的 style 永不被当 map style 消费」—— 该形状在 ObjectMapSchema(types)声明的键几乎与 ObjectMap 实际读的键无交集:map 块整体未建模,组件 props 类型写的是 ObjectGridSchema,每处 map 读取都走 as any #5018 裁定落地后依然成立。
不可协商的前置核验(升级版):PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156 落地后 ObjectMapConfig 声明含 style?: string,而 ObjectView/ListView 的摊平是 ...(options.map || {}) 内容平铺 —— 若视图侧可授权面(spec ListMapConfigSchema 七键、view options 类型面、任一 passthrough 通道)允许 map.style 进入摊平,顶层 style 就是活的生产路径,删腿=静默断供。逐面测量(参照 PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156 新钉 ObjectView.mapFlatten.test.tsx);任一面证实可达 ⇒ 停下报 needs_decision 带证据,零删除。
热文件状态:PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156 已落,ObjectMap.tsx 无在飞占用;本认领占该文件,plugin-map 的 Features 清单与 ObjectMap.tsx 头注释仍宣称 api data provider 可用(实为未实现分支) #5163(串行条款里的注释半)与本卡若同文件相遇,plugin-map 的 Features 清单与 ObjectMap.tsx 头注释仍宣称 api data provider 可用(实为未实现分支) #5163 排后。

Generated by Claude Code

PM 交接(条件释放)(session session_01GTRjn8xBqp75dk7kFupVRt,2026-08-18):维护者指示本 PM 会话下班收工。本卡执行席位刚派发(分支 claude/issue-5017-style-leg 尚未 push、未开 PR)。处置条款:

若稍后出现该分支的 draft PR:任一 PM 可按认领评论 5325569468 的执行口径直接做标准验收三件套。特别注意其中的不可协商前置核验(摊平可达性三面测量,verdict c ⇒ needs_decision 而非动刀)—— 验收时核对报告/PR body 里该测量确实做了。
若无 draft PR 出现:本认领即告释放,本卡回到可认领态;基线必须含 578e02516(PR fix(types,plugin-map): declare what ObjectMap reads; the map block outranks the flat spelling #5156)。
执行口径与 PM 代裁以认领评论为准,不随会话结束失效。

Generated by Claude Code

docs(plugin-map): README 按现码重写,不再教包里不存在的那套 API (objectstack-ai#5002) (o…

fix(plugin-map): 顶层 `style` 是内联 CSS,不再被当作 MapLibre style 读 (objectsta…

Navigation Menu

Repository navigation

ObjectMap 把顶层 `schema.style` 当 MapLibre style URL 读 —— 与 `BaseSchema.style`(内联 CSS)撞车,而 types 里 `mapStyle` 这个名字正是为避开它才起的 #5017

现象

为什么这条特别值得记

观察到的三个拼法

可能的修法(供分诊定向,未实施)

分级

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

ObjectMap 把顶层 schema.style 当 MapLibre style URL 读 —— 与 BaseSchema.style(内联 CSS)撞车,而 types 里 mapStyle 这个名字正是为避开它才起的 #5017

Description

现象

为什么这条特别值得记

观察到的三个拼法

可能的修法(供分诊定向,未实施)

分级

Activity

os-zhuang commented on Aug 17, 2026

yinlianghui commented on Aug 18, 2026

yinlianghui commented on Aug 18, 2026

yinlianghui commented on Aug 18, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

ObjectMap 把顶层 `schema.style` 当 MapLibre style URL 读 —— 与 `BaseSchema.style`(内联 CSS)撞车,而 types 里 `mapStyle` 这个名字正是为避开它才起的 #5017