Schema — Kuito Documentation

Utilisation

Persist a preference

tsx

import { Text, Toggle, VStack, persisted, type Schema } from 'kuito';

const booleanSchema: Schema<boolean> = {
  '~standard': {
    version: 1,
    vendor: 'example',
    validate: (value) =>
      typeof value === 'boolean' ? { value } : { issues: [{ message: 'Expected boolean' }] },
  },
};

export function Preferences() {
  const wifiOnly = persisted(true, { key: 'downloads.wifiOnly', schema: booleanSchema });
  return (
    <VStack gap={12}>
      <Toggle label="Download on Wi-Fi only" checked={wifiOnly} />
      <Text>{wifiOnly.value ? 'Wi-Fi only' : 'Any connection'}</Text>
    </VStack>
  );
}

Déclaration du type

export interface Schema<T> {
  readonly '~standard': {
    readonly version: 1;
    readonly vendor: string;
    readonly validate: (value: unknown) => SchemaResult<T> | Promise<SchemaResult<T>>;
    readonly types?: { readonly input: unknown; readonly output: T } | undefined;
  };
}

Membres 1

Nom	Type	Requis	Description
`~standard`lecture seule	`{ readonly version: 1; readonly vendor: string; readonly validate: (value: unknown) => SchemaResult<T> \| Promise<SchemaResult<T>>; readonly types?: { readonly input: unknown; readonly output: T; } \| undefined;}`	Oui	—

~standard — champs imbriqués

~standard champs

Nom	Type	Requis	Description
`version`lecture seule	`1`	Oui	—
`vendor`lecture seule	`string`	Oui	—
`validate`lecture seule	`(value: unknown) => SchemaResult<T> \| Promise<SchemaResult<T>>`	Oui	—
`types`lecture seule	`{ readonly input: unknown; readonly output: T;}`	Non	—

validate — signatures de méthode

Signatures

(value: unknown): SchemaResult<T> | Promise<SchemaResult<T>>

Paramètres

Nom	Type	Requis	Description
`value`	`unknown`	Oui	—

Retourne

SchemaResult<T> | Promise<SchemaResult<T>>

types — champs imbriqués

types champs

Nom	Type	Requis	Description
`input`lecture seule	`unknown`	Oui	—
`output`lecture seule	`T`	Oui	—

Généré depuis les déclarations TypeScript publiques : signatures, props et valeurs par défaut viennent de la source vérifiée, les descriptions de sa JSDoc. Aucune valeur par défaut n'est inventée.