feat(nakui-ui): validación estricta de params del morphism vía FieldKind

Reemplaza la heurística `infer_param_value` por parseo estricto basado
en el `FieldKind` declarado en el `FieldSpec` correspondiente. Un Boolean
con value "abc" ahora rebota en la UI con mensaje claro en lugar de
fallar opacamente dentro del morphism Rhai.

Cambios:
- Nuevo helper `resolve_param_value(field_name, raw, spec)`:
  - Required + empty → error con label legible.
  - Optional + empty → Value::Null.
  - Spec presente → parse_field_value(spec.kind, raw) estricto.
  - Spec ausente (módulo mal-formado) → fallback a infer_param_value.
- `commit_morphism` simplificado: el loop de params ahora delega al
  helper, que es testable sin GPUI.
- 6 tests nuevos cubriendo: número estricto, boolean rechaza "abc",
  required vacío, optional vacío → null, fallback a infer sin spec.

22 tests verdes (+6 nuevos). E2E del morphism real
`morphism_pipeline_executes_real_sales_vender` sigue verde — la
validación estricta no afecta el path correcto, sólo agrega rebotes
tempranos a values mal-tipados.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Sergio
2026-05-09 20:59:11 +00:00
parent fc72726666
commit 46185951d0
3 changed files with 178 additions and 9 deletions
+60
View File
@@ -6,6 +6,66 @@ ratio/diff ver `git show <sha>`.
## 2026-05-09
### feat(nakui-ui): validación estricta de params del morphism vía FieldKind del FieldSpec
Cierra el último trade-off documentado: `infer_param_value` adivinaba
el tipo de cada param por la shape del string (i64 → f64 → bool →
string). Ahora cuando hay `FieldSpec` declarado, usamos
`parse_field_value(spec.kind, raw)` — un Boolean field con value
"abc" rebota con mensaje claro en la UI antes de llegar al morphism
Rhai (donde el error sería opaco como "Function not found: * ((), ())").
Cambios:
- **Nuevo helper `resolve_param_value(field_name, raw, spec)`**:
- Si hay `FieldSpec`: validación de `required` (rebota empty con
"param 'X' es obligatorio y está vacío") + parseo estricto via
`parse_field_value(spec.kind, raw)`. Errores incluyen el `label`
del spec para que el toast sea interpretable.
- Si NO hay spec (param declarado en `Action::Morphism.params`
que no existe en `form.fields` — módulo mal-formado): fallback
a `infer_param_value` como red de seguridad.
- Empty + opcional → `Value::Null`.
- **`commit_morphism` simplificado**: el loop de params ahora es
3 líneas (lookup spec + llamada a `resolve_param_value` +
inserción al map). La lógica vive en el helper standalone,
testable sin GPUI.
Tests: 6 nuevos en `tests` mod, todos contra `resolve_param_value`:
- `resolve_param_strict_number_parses_i64` — happy path.
- `resolve_param_strict_boolean_rejects_non_boolean` — un Boolean
con "abc" rebota con mensaje que incluye el label.
- `resolve_param_strict_number_rejects_garbage` — Number con "abc"
rebota.
- `resolve_param_required_empty_rejected` — required vacío rebota
con "obligatorio".
- `resolve_param_optional_empty_returns_null` — optional vacío
→ null.
- `resolve_param_no_spec_falls_back_to_infer` — el fallback
preserva el comportamiento anterior para back-compat.
22 tests verdes en nakui-ui (+6). E2E del morphism real
(`morphism_pipeline_executes_real_sales_vender`) sigue verde — la
validación estricta no rompe el path correcto, sólo agrega rebotes
tempranos a values mal-tipados.
Beneficio operativo:
- Mensaje de error en la UI ahora identifica el field problemático
por su label legible ("param 'Cantidad': 'abc' no es número")
en lugar del error opaco del morphism Rhai.
- Errores se ven antes de tocar el log o el store — ningún cambio
parcial.
- El módulo Nakui ya no tiene que defender contra inputs garbage
desde la UI: la metainterfaz se vuelve la primera línea de
validación tipada.
Pendientes futuros (orden de prioridad):
- **Confirmación de delete** — modal antes de borrar.
- **Snapshot/compaction** del log para repos grandes.
- **Edit delta-only** — sólo campos modificados, no todos.
- **EntityRef validation post-submit**: hoy `parse_field_value`
para EntityRef devuelve string raw; el commit_morphism luego
valida como Uuid sólo cuando es input del morphism. Para
EntityRef como param, podríamos validar UUID al submit.
### feat(nakui-ui): FieldKind::EntityRef — selector clickable de records existentes
Cierra el principal trade-off documentado del commit anterior:
"Inputs UUID a mano (no dropdown)". Los formularios pueden declarar
Generated
+2
View File
@@ -6155,6 +6155,8 @@ dependencies = [
"serde_json",
"tempfile",
"uuid",
"yahweh-theme",
"yahweh-widget-text-input",
]
[[package]]
+116 -9
View File
@@ -468,18 +468,29 @@ impl MetaUi {
} else {
params_fields.to_vec()
};
// Buscamos los FieldSpec del Form view activo para conocer
// el `kind` declarado de cada param. Usamos `parse_field_value`
// estricto en lugar de la heurística `infer_param_value` —
// así un "abc" en un campo Boolean rebota en la UI con un
// mensaje claro ANTES de llegar al morphism Rhai.
let active_form_fields: Option<Vec<FieldSpec>> = self.active.as_ref().and_then(|(_, vk)| {
module.views.get(vk).and_then(|v| match v {
View::Form(f) => Some(f.fields.clone()),
_ => None,
})
});
for field_name in field_iter {
let raw = self
.form_inputs
.get(&field_name)
.map(|inp| inp.read(&*cx).text().to_string())
.unwrap_or_default();
// Inferencia ligera: número si parsea, bool en
// true/false, string en cualquier otro caso. Coherente
// con el modelo "el morphism Rhai espera tipos", pero
// simple — para casos finos, el caller puede declarar
// `kind: Number` en el FieldSpec, y el form lo respeta.
let value = infer_param_value(&raw);
let spec = active_form_fields
.as_ref()
.and_then(|fs| fs.iter().find(|f| f.name == field_name));
let value = resolve_param_value(&field_name, &raw, spec)?;
params_obj.insert(field_name, value);
}
@@ -684,10 +695,40 @@ fn render_value(v: Option<&Value>) -> String {
}
}
/// Resuelve un param de morphism a su `Value` según el `FieldSpec`
/// del form. **Strict path**: si hay spec, valida `required` y parsea
/// con el `kind` declarado (ej. Boolean rebota con "abc" antes de
/// llegar al morphism). **Fallback path**: si no hay spec (param
/// declarado en `Action::Morphism.params` que no aparece en
/// `form.fields`), usa la heurística `infer_param_value` para no
/// quedar atado a un schema mal-formado.
///
/// Errores tienen el label legible del spec, así el toast de la UI
/// es interpretable.
fn resolve_param_value(
field_name: &str,
raw: &str,
spec: Option<&FieldSpec>,
) -> Result<Value, String> {
let Some(s) = spec else {
return Ok(infer_param_value(raw));
};
let label = if s.label.is_empty() { field_name } else { &s.label };
if s.required && raw.trim().is_empty() {
return Err(format!("param '{label}' es obligatorio y está vacío"));
}
if raw.is_empty() && !s.required {
return Ok(Value::Null);
}
parse_field_value(s.kind, raw).map_err(|e| format!("param '{label}': {e}"))
}
/// Inferencia de tipo para values pasados como `params` a un
/// morphism. Usada cuando el form no declara `FieldKind` explícito
/// (Action::Morphism toma `params: Vec<String>` con sólo los nombres,
/// no los kinds).
/// morphism. Usada como fallback en `resolve_param_value` cuando el
/// param declarado en `Action::Morphism.params` no aparece en los
/// `form.fields` (módulo mal-formado).
///
/// Heurística simple: int → i64, float → f64, "true"/"false" → bool,
/// resto → string.
@@ -1365,6 +1406,72 @@ mod tests {
assert_eq!(infer_param_value("hola"), json!("hola"));
}
fn spec(name: &str, kind: FieldKind, required: bool) -> FieldSpec {
FieldSpec {
name: name.into(),
label: name.into(),
kind,
default: None,
required,
help: None,
ref_entity: None,
}
}
#[test]
fn resolve_param_strict_number_parses_i64() {
let s = spec("qty", FieldKind::Number, true);
let v = resolve_param_value("qty", "42", Some(&s)).unwrap();
assert_eq!(v, json!(42));
}
#[test]
fn resolve_param_strict_boolean_rejects_non_boolean() {
let s = spec("active", FieldKind::Boolean, true);
let err = resolve_param_value("active", "abc", Some(&s)).unwrap_err();
assert!(err.contains("active"), "msg debe mencionar el label: {err}");
assert!(
err.to_lowercase().contains("bool") || err.contains("'abc'"),
"msg debe explicar el tipo o value: {err}"
);
}
#[test]
fn resolve_param_strict_number_rejects_garbage() {
let s = spec("qty", FieldKind::Number, true);
let err = resolve_param_value("qty", "abc", Some(&s)).unwrap_err();
assert!(err.contains("qty"), "msg debe mencionar el label: {err}");
}
#[test]
fn resolve_param_required_empty_rejected() {
let s = spec("name", FieldKind::Text, true);
let err = resolve_param_value("name", " ", Some(&s)).unwrap_err();
assert!(
err.contains("obligatorio"),
"msg debe decir obligatorio: {err}"
);
}
#[test]
fn resolve_param_optional_empty_returns_null() {
let s = spec("notes", FieldKind::Text, false);
let v = resolve_param_value("notes", "", Some(&s)).unwrap();
assert_eq!(v, json!(null));
}
#[test]
fn resolve_param_no_spec_falls_back_to_infer() {
// Sin FieldSpec (módulo mal-formado): infer_param_value
// se usa como red de seguridad.
let v = resolve_param_value("foo", "42", None).unwrap();
assert_eq!(v, json!(42));
let v = resolve_param_value("foo", "true", None).unwrap();
assert_eq!(v, json!(true));
let v = resolve_param_value("foo", "x", None).unwrap();
assert_eq!(v, json!("x"));
}
#[test]
fn parse_field_entity_ref_returns_string() {
// EntityRef se almacena como string del UUID. parse_field_value