fix(export): clamp labelColumnSpan against columnSpan at emission

APEX rejects labelColumnSpan >= columnSpan only at render time
(WWV_FLOW_GRID_LAYOUT.LABEL_COLUMN_SPAN_TOO_BIG), never in apex
validate/import. _reconcile_label already caps this after _place_row
settles an item's real grid span, but _item_chunk trusted
Placed.label_span unconditionally when writing labelColumnSpan.
Re-clamp it there too, so the invariant holds regardless of which
upstream layout path set it.

Bump to 0.1.13.

Author: gevianajr

CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to FormsLang are 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).
 
+## [0.1.13] — 2026-09-04
+
+### Fixed
+
+- **A page item could still export with `labelColumnSpan >= columnSpan`**,
+  which APEX rejects only at render time (`WWV_FLOW_GRID_LAYOUT
+  .LABEL_COLUMN_SPAN_TOO_BIG`) -- never caught by `apex validate` or
+  `apex import`. `_reconcile_label` in `apexlayout.py` already caps this
+  after `_place_row` settles an item's real grid span, but the exporter
+  trusted `Placed.label_span` unconditionally at the point it wrote
+  `labelColumnSpan`. `_item_chunk` in `apexlang.py` now re-clamps the
+  span against the item's actual `columnSpan` right where it emits it,
+  closing the invariant regardless of which upstream layout path set it.
+
 ## [0.1.12] — 2026-09-04
 
 ### Fixed

desktop/package.json

@@ -1,7 +1,7 @@
 {
   "name": "formslang-desktop",
   "private": true,
-  "version": "0.1.12",
+  "version": "0.1.13",
   "scripts": {
     "tauri": "tauri",
     "icon:render": "node scripts/render-icon.mjs",

desktop/src-tauri/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "formslang-desktop"
-version = "0.1.12"
+version = "0.1.13"
 description = "FormsLang desktop shell (B2DEV TECH)"
 edition = "2021"
 license = "Apache-2.0"

desktop/src-tauri/Cargo.toml

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "FormsLang",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "identifier": "tech.b2dev.formslang",
   "build": {
     "frontendDist": "../ui-shell"

desktop/src-tauri/tauri.conf.json

@@ -404,12 +404,19 @@ def _item_chunk(
     )
     width = layout.chars(item.width) if kind == "textField" else None
     width_line = f"\n            width: {width}" if width else ""
-    template = _label_template(item, kind, side=placed.side, label_span=placed.label_span)
+    # Belt-and-suspenders re-clamp of _reconcile_label's invariant: APEX
+    # rejects labelColumnSpan >= columnSpan at render time only (neither
+    # ``apex validate`` nor ``apex import`` catch it), so whatever upstream
+    # layout path produced this Placed, never emit a span that violates it.
+    label_span = placed.label_span
+    if label_span and not placed.grid.flow:
+        label_span = max(0, min(label_span, placed.grid.span - 1))
+    template = _label_template(item, kind, side=placed.side, label_span=label_span)
     # A label left of the field takes the share of the cell the prompt took
     # on the canvas, so the field keeps its proportion to the prompt.
     span_line = (
-        f"\n            labelColumnSpan: {placed.label_span}"
-        if template in {"optional", "required"} and placed.label_span
+        f"\n            labelColumnSpan: {label_span}"
+        if template in {"optional", "required"} and label_span
         else ""
     )
     lov_block = ""

formslang/apexlang.py

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "formslang"
-version = "0.1.12"
+version = "0.1.13"
 description = "Oracle Forms analysis and AI-assisted conversion to Oracle APEX"
 readme = "README.md"
 requires-python = ">=3.10"