kromia-sdk

Lista las recetas (plantillas de carta/sección) del modelo Kromia: id, kind (list/detail/expand), nombre y descripción. Punto de partida para diseñar una vista.

Lista los componentes prefabricados (bloques) que se pueden colocar en un layout.

Lista los tipos de campo del modelo (text, number, image, enum, rating…).

Lista los slot-kinds (qué clase de contenido acepta un slot): id, label y descripción.

Lista los efectos visuales que se aplican a una carta según el VALOR de una tag (iridescent_foil, crown_badge, glow_border…): id, nombre, capa y cuántos parámetros tiene. Índice ligero: pide la ficha completa con describe(category:"visual-effect", id) antes de configurar ninguno. Los efectos son el …

Lista las plantillas de layout disponibles para una receta (id, nombre, descripción). Elegir + ajustar una plantilla existente da mejor resultado que diseñar el árbol desde cero.

Devuelve la definición COMPLETA (incluida su doc: cuándo usar, slots, ejemplos) de un elemento del modelo: receta, componente, tipo de campo, slot-kind, behavior o efecto visual. Para `visual-effect` devuelve TODOS sus parámetros con tipo, opciones cerradas, min/max y default, más sus presets de fáb…

Valida una ViewComposition (recipe + layout + slots) contra el modelo Kromia. Devuelve {valid, issues:[{path,message,level}]}. Úsalo en bucle: propón una composición → corrige los issues (usa el `path`) → repite hasta valid=true. `fieldDefs` (opcional) = los campos de la sección, para validar refere…

Valida un TagStyle[] (valor de una tag → efecto visual + su config) contra el catálogo real. Es el MISMO bucle corrector que validate_composition pero para el otro eje del diseño: devuelve {valid, issues:[{index,path,level,message}]}; corrige por el `path` y repite. Comprueba que el efecto existe, q…

Valida las CARTAS y los datos de sección contra el esquema: tipo, reglas del behavior, obligatorios, valores de enum y referencias entre secciones. Es la otra mitad del contrato — las demás tools validan cómo se VE el álbum, esta valida lo que CONTIENE. Úsala antes de entregar un lote de cartas: una…

Valida de qué campo sale la RAREZA y con qué reparto. La rareza es lo que convierte una lista de cartas en un coleccionable: gobierna qué cartas llevan efecto y cómo se componen los sobres, así que conviene fijarla al diseñar el esquema y no después. Comprueba que el campo existe y es elegible (pide…

Genera una ViewComposition SENSATA a partir de los campos de la sección (heurística del SDK: mapea imagen/título/subtítulo/badge/stats a los slots correctos). `kind`: list o detail. Es el mejor punto de partida — luego ajústala con apply_template o a mano y re-valida. Devuelve {composition, validati…

Aplica una plantilla de layout (de las que devuelve list_templates para esa receta) a una composición existente, y valida. Enfoque ROBUSTO: elegir + ajustar una plantilla en vez de diseñar el árbol desde cero. Devuelve {composition, validation}.

Devuelve el árbol de layout que produce una plantilla para una receta, para INSPECCIONARLO antes de aplicarla. `slots` = ids de slots presentes (si se omite, se asumen todos).

Aplica una ViewComposition a la SECCIÓN de un ALBUM-schema de Kromia (las secciones viven en el album-schema, no en el card-schema). SEGURO: (1) valida localmente antes de nada; (2) DRY-RUN por defecto — muestra qué se aplicaría SIN escribir; solo escribe con `confirm:true`. Escribir requiere env `K…