Overview de schema

Un FormSchema describe lo que el formulario pide y lo que el backend devuelve.

const schema = {
  fields: [
    { id: "prompt", kind: "text", label: "Prompt", required: true },
    { id: "threshold", kind: "number", label: "Threshold", min: 0, max: 1 },
  ],
  reports: [{ id: "prediction", kind: "classifier", label: "Prediction" }],
};

Tipo	Propósito
FormSchema	Objeto raíz con fields y reports.
FieldConfig	Un campo de entrada.
ReportConfig	Un informe de salida.
FieldCondition	Regla para hiddenWhen, disabledWhen o readOnlyWhen.

Usa ids explícitos en producción. Los ids generados sirven para demos, pero los ids estables simplifican estado UI, layout refs, foco, validación, tests y analítica. Las claves backend van en mappedTo. Las claves de review, persistencia y export van en displayKey; campos sin displayKey se omiten de displayValues. Los labels son copy visible, no claves de datos.

getField(id), getReport(id), layout refs, errores de validación y estados de reports siguen keyed por id porque son APIs runtime. Para contratos externos, usa getFieldByDisplayKey(key), getFieldByMappedTo(target, { backend }), displayValues y modelValues.