LCARdS

Appearance

Validation Service ​

Config schema validation for all LCARdS card types — window.lcards.core.validationService

Overview ​

The Validation Service provides runtime config validation using a schema registry. When a card receives a config object, validation catches structural errors and unknown fields early, before rendering starts.

Key Files ​

FileRole
core/validation-service/index.jsService entry point
core/validation-service/SchemaRegistry.jsStores schemas keyed by card type; register/lookup
core/validation-service/DataSourceValidator.jsValidates data_sources block
core/validation-service/OverlayValidator.jsValidates MSD overlay definitions
core/validation-service/TokenValidator.jsDetects invalid token syntax in string fields
core/validation-service/ValueValidator.jsType + range checking for scalar fields
core/validation-service/ErrorFormatter.jsFormats error objects into human-readable messages
core/validation-service/schemas/Per-card JSON schema definitions

Schema Registration ​

Card schemas are registered at startup via CoreConfigManager:

javascript
import { SchemaRegistry } from '../core/validation-service/SchemaRegistry.js';

SchemaRegistry.register('lcards-button', buttonSchema);
SchemaRegistry.register('lcards-slider', sliderSchema);

Public API ​

MethodReturnsDescription
validateConfig(cardType, config){ valid, errors, warnings }Validate a config object against the card's registered schema
getSchema(cardType)Object|nullRetrieve the raw JSON schema for a card type
getRegisteredTypes()string[]All card types with registered schemas
javascript
import { validateConfig } from '../core/validation-service/index.js';

// Returns { valid: boolean, errors: string[], warnings: string[] }
const result = validateConfig('lcards-button', this.config);

if (!result.valid) {
  lcardsLog.warn('[MyCard] Config validation failed:', result.errors);
}

Console Access ​

javascript
window.lcards.debug.singleton('validationService')
// → { type: 'ValidationService', initialized: true, registeredSchemas: 8, cacheSize: 14 }
javascript
const vs = window.lcards.core.validationService

vs.getRegisteredTypes()                // all card types with schemas
vs.getSchema('lcards-button')          // raw schema object
vs.validateConfig('lcards-slider', {}) // run validation directly

Error Display ​

Validation errors surface in two places:

  1. Browser console — structured log messages with field paths
  2. Card editor — the YAML tab shows inline error markers via CodeMirror integration

See Also ​