Schema — Kuito Documentação

Utilização

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>
  );
}

Declaração do tipo

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;
  };
}

Membros 1

Nome	Tipo	Obrigatório	Descrição
`~standard`só de leitura	`{ readonly version: 1; readonly vendor: string; readonly validate: (value: unknown) => SchemaResult<T> \| Promise<SchemaResult<T>>; readonly types?: { readonly input: unknown; readonly output: T; } \| undefined;}`	Sim	—

~standard — campos aninhados

~standard campos

Nome	Tipo	Obrigatório	Descrição
`version`só de leitura	`1`	Sim	—
`vendor`só de leitura	`string`	Sim	—
`validate`só de leitura	`(value: unknown) => SchemaResult<T> \| Promise<SchemaResult<T>>`	Sim	—
`types`só de leitura	`{ readonly input: unknown; readonly output: T;}`	Não	—

validate — assinaturas de método

Assinaturas

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

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`value`	`unknown`	Sim	—

Devolve

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

types — campos aninhados

types campos

Nome	Tipo	Obrigatório	Descrição
`input`só de leitura	`unknown`	Sim	—
`output`só de leitura	`T`	Sim	—

Gerado a partir das declarações TypeScript públicas: assinaturas, props e predefinições vêm da fonte verificada, as descrições da sua JSDoc. Nenhuma predefinição é inventada.