Auto-build: codex (python) from f4768e2

.codex/skills/mxl-compile/reference/input-cells.md

@@ -0,0 +1,48 @@
+# Ячейки-поля ввода
+
+Ячейка может не показывать текст, а принимать значение от пользователя — так делают макеты для
+ввода данных. Достаточно задать тип значения:
+
+```json
+{ "col": 1, "valueType": "Number(15,3,nonneg)" }
+{ "col": 2, "valueType": "String(10)" }
+{ "col": 3, "valueType": "Boolean", "controlType": "checkbox" }
+{ "col": 4, "valueType": "CatalogRef.Валюты" }
+{ "col": 5, "valueType": "Boolean + String + Date + CatalogRef.Валюты" }
+{ "col": 6, "valueType": "AnyRef" }
+```
+
+Грамматика типа:
+
+| Запись | Значение |
+|---|---|
+| `Boolean` | булево |
+| `String`, `String(10)`, `String(10,fixed)` | строка; без длины — неограниченная, `fixed` — фиксированной длины |
+| `Number`, `Number(15,3)`, `Number(15,3,nonneg)` | число; без параметров — без ограничения разрядности, `nonneg` — неотрицательное |
+| `Date`, `DateTime`, `Time` | дата, дата со временем, время |
+| `CatalogRef.Валюты`, `DocumentRef.Реализация`, `EnumRef.Статусы`, `DefinedType.Сумма` | ссылочный тип |
+| `CatalogRef`, `DocumentRef`, `AnyRef` | категория целиком: любая ссылка этого вида |
+| `A + B` | составной тип; повтор одного примитива недопустим |
+
+Русские имена принимаются наравне с английскими: `Число(15,3)`, `Строка(10)`,
+`СправочникСсылка.Валюты`.
+
+`text` и `template` в такой ячейке недопустимы — платформа не показывает текст там, где вводится
+значение. `param` и `detail` допустимы: они описывают заполнение и расшифровку, а не содержимое.
+
+Пустой тип `"valueType": ""` — «ячейка содержит значение», но тип не ограничен.
+
+Значение поля ввода задаётся ключом `value`. Его тип — тип литерала JSON: строка, число,
+`true`/`false`; к объявленному типу ячейки значение не приводится. Пустая строка означает
+пустое значение объявленного типа. Дата пишется строкой `ГГГГ-ММ-ДДTчч:мм:сс` и читается
+как дата у ячейки, объявленной датой; у ссылочного и составного типа значение — строка.
+
+```json
+{ "col": 1, "valueType": "Number(15,3)", "value": 12.5 }
+{ "col": 2, "valueType": "String(10)", "value": "5" }
+{ "col": 3, "valueType": "Boolean", "value": true }
+{ "col": 4, "valueType": "DateTime", "value": "" }
+```
+
+`controlType` нужен редко: умолчание платформы — поле ввода, и оно подходит всем типам, включая
+`Boolean`. Флажок задаётся явно.