persist-valtio

Estrelas4

Forks0

Atualizado23 de julho de 2026 às 07:05

Persist a valtio proxy object with @stainless-code/persist (persistProxy). Use when wiring valtio state to localStorage/sessionStorage/IndexedDB via snapshot/subscribe.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

stainless-code

stainless-code/persist

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

SKILL.md

readonly

name	persist-valtio
description	Persist a valtio proxy object with @stainless-code/persist (persistProxy). Use when wiring valtio state to localStorage/sessionStorage/IndexedDB via snapshot/subscribe.
license	MIT
metadata	{"type":"composition","library":"@stainless-code/persist","library_version":"0.4.1","framework":"valtio"}
sources	["stainless-code/persist:src/adapters/sources/valtio.ts","stainless-code/persist:docs/architecture.md"]

Persisting valtio

@stainless-code/persist/sources/valtio maps a proxy object through snapshot / Object.assign / subscribe (valtio/vanilla) onto persistSource.

When to use this skill

You have a proxy({…}) object state and want it to survive reload.
State is an object (not a primitive proxy target).

Install

bun add @stainless-code/persist valtio

valtio is an optional peer of /sources/valtio.

Minimal wiring

import { proxy } from "valtio";
import { createJSONStorage } from "@stainless-code/persist";
import { persistProxy } from "@stainless-code/persist/sources/valtio";

const prefs = proxy({ theme: "light" as const });
const persist = persistProxy(prefs, {
  name: "app:prefs:v1",
  storage: createJSONStorage(() => localStorage),
});

Hydrate semantics

Writes apply with Object.assign(proxy, next) — keys absent from next are not deleted. Design partialize / migrate so hydrate payloads carry the shape you need, or reset keys yourself.

Common mistakes

Persisting a non-object. TState extends object.
Expecting deep replace / key deletion on hydrate via assign alone.
Forgetting destroy() for non-singleton proxies.

API surface

persistProxy(proxyObject, options) → PersistApi
Options / PersistApi: same as persistSource

See also: persist-mobx — same object + assign pattern with runInAction.

Mais deste repositório

mesmo repositório

alpine-persist

stainless-code/persist

Gate Alpine.js UI on Persist hydration (Alpine.plugin + useHydrated / $hydrated). Use when wiring HydrationSignal into Alpine data components.

2026-07-234

angular-persist

stainless-code/persist

Gate Angular UI on Persist hydration with useHydrated (readonly Signal). Call inside an injection context; use when avoiding flash of default state on async backends.

2026-07-234

lit-persist

stainless-code/persist

Gate Lit element UI on Persist hydration with HydrationController. Use when wiring HydrationSignal into a ReactiveControllerHost; not a hook.

2026-07-234

persist-async-storage

stainless-code/persist

Persist with React Native AsyncStorage via @stainless-code/persist/backends/async-storage. Use for RN string-wire JSON state; always gate with useHydrated.

2026-07-234

persist-compressed

stainless-code/persist

Compress a string-wire StateStorage with @stainless-code/persist/backends/compressed (gzip/deflate). Backend wrapper — compose with createStorage; stack compress-then-encrypt.

2026-07-234

persist-crosstab

stainless-code/persist

Cross-tab sync for backends without storage events via @stainless-code/persist/transport/crosstab (createBroadcastCrossTab). Wrap storage + pass crossTabEventTarget; call close() on teardown.

2026-07-234

name	persist-valtio
description	Persist a valtio proxy object with @stainless-code/persist (persistProxy). Use when wiring valtio state to localStorage/sessionStorage/IndexedDB via snapshot/subscribe.
license	MIT
metadata	{"type":"composition","library":"@stainless-code/persist","library_version":"0.4.1","framework":"valtio"}
sources	["stainless-code/persist:src/adapters/sources/valtio.ts","stainless-code/persist:docs/architecture.md"]

Persisting valtio

@stainless-code/persist/sources/valtio maps a proxy object through snapshot / Object.assign / subscribe (valtio/vanilla) onto persistSource.

When to use this skill

You have a proxy({…}) object state and want it to survive reload.
State is an object (not a primitive proxy target).

Install

bun add @stainless-code/persist valtio

valtio is an optional peer of /sources/valtio.

Minimal wiring

import { proxy } from "valtio";
import { createJSONStorage } from "@stainless-code/persist";
import { persistProxy } from "@stainless-code/persist/sources/valtio";

const prefs = proxy({ theme: "light" as const });
const persist = persistProxy(prefs, {
  name: "app:prefs:v1",
  storage: createJSONStorage(() => localStorage),
});

Hydrate semantics

Writes apply with Object.assign(proxy, next) — keys absent from next are not deleted. Design partialize / migrate so hydrate payloads carry the shape you need, or reset keys yourself.

Common mistakes

Persisting a non-object. TState extends object.
Expecting deep replace / key deletion on hydrate via assign alone.
Forgetting destroy() for non-singleton proxies.

API surface

persistProxy(proxyObject, options) → PersistApi
Options / PersistApi: same as persistSource

See also: persist-mobx — same object + assign pattern with runInAction.