LayerUpdate

object

• namestring

• sqlstring

  Only one read-only SELECT over named datasets is accepted. File readers, file-relation shorthand and engine path or definition discovery are refused before binding with sql_rejected, including nested SQL and computed targets. File-referencing PROJ coordinate definitions are also refused before native projection use, including computed or per-row values; EPSG identifiers and inline definitions without files remain supported. Unknown tables receive the same sql_error whether hidden or nonexistent, without catalogue suggestions. Engine errors do not expose filesystem paths or internal statements; input positions are retained when available. Existing saved SQL is retained unchanged; affected saved and published queries fail.

• styleStyle

• visibleboolean

• tooltiparray of stringor nullmax items 32

  Fields shown in the hover tooltip (up to 32, each an existing result column); null = automatic.

• popuparray of stringor nullmax items 32

  Fields shown in the click pop-up (up to 32, each an existing result column); null = automatic. Independent of tooltip — a tooltip often wants one field, a pop-up several.

• publishedFieldsarray of stringor nullmax items 32

  Explicit published-field list (up to 32, each an existing result column); null restores the derived minimal projection. The functional core — fields the published map needs to render, label, filter and cross-filter — publishes regardless of this list. A publication setting: only the map's owner changes it, and anyone else's write that would change it is refused whole with forbidden.

• inLegendboolean

• vizViz

• filtersarray of LayerFilter

• legendTitlestringor null

• legendLabelsarray of string or nullor null

• legendAttrsobjector null

  Per-channel legend attribute-name overrides (fill, stroke, radius, width → short string, or null to hide that channel's attribute line); null = all automatic.