@keepkit/core 0.10.0 → 0.11.0

package/dist/core.js

@@ -13,7 +13,7 @@ import {
   queryKeepItems,
   reconcileKeepItems,
   revalidateKeepItems
-} from "./chunk-XF5VI6O5.js";
+} from "./chunk-MDTL5L64.js";
 import {
   KeepSchemaValidationError,
   parseKeepMeta,
@@ -36,11 +36,16 @@ import {
   KeepStorageQuotaError,
   LocalStorageAdapter,
   LocalStorageSyncQueueAdapter,
+  ScopedStorageAdapter,
+  ScopedSyncQueueAdapter,
   SyncStorageAdapter,
   createBrowserStorageAdapter,
+  createScopedStorageAdapter,
   createStorageAdapter,
+  getKeepScopeKey,
+  isSameKeepScope,
   normalizeKeepTags
-} from "./chunk-EXE4E3GA.js";
+} from "./chunk-36YIELZE.js";
 
 // src/integrations.ts
 function createKeepInvalidationPlugin(options) {
@@ -52,9 +57,97 @@ function createKeepInvalidationPlugin(options) {
     }
   };
 }
+
+// src/presets.ts
+function createKeepKitPreset(options = {}) {
+  const mode = options.mode ?? "local";
+  const local = options.storage ? options.scope ? createScopedStorageAdapter(options.storage, options.scope) : options.storage : createBrowserStorageAdapter({ key: options.key, scope: options.scope });
+  if (mode === "sync" && !options.remote) {
+    throw new Error('createKeepKitPreset({ mode: "sync" }) requires a remote driver.');
+  }
+  let storage = local;
+  if (mode === "sync") {
+    const remote = options.remote;
+    if (!remote) throw new Error('createKeepKitPreset({ mode: "sync" }) requires a remote driver.');
+    storage = new SyncStorageAdapter({
+      local,
+      remote,
+      userId: options.scope?.userId,
+      tenantId: options.scope?.tenantId
+    });
+  }
+  return {
+    mode,
+    scope: options.scope,
+    storage,
+    exportBackup: () => exportItems(storage)
+  };
+}
+var createKeepKitSetup = createKeepKitPreset;
+
+// src/url.ts
+var DEFAULT_KEEP_URL_PARAMS = {
+  search: "q",
+  tags: "tag",
+  sort: "sort",
+  page: "page"
+};
+function encodeKeepListQuery(query = {}, options = {}) {
+  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };
+  const result = new URLSearchParams();
+  const search = query.search?.query?.trim();
+  if (search) result.set(params.search, search);
+  for (const tag of query.tags ?? []) {
+    const normalized = tag.trim();
+    if (normalized) result.append(params.tags, normalized);
+  }
+  if (query.sort?.by) result.set(params.sort, `${query.sort.by}:${query.sort.direction ?? "desc"}`);
+  const page = query.pagination?.page;
+  if (page !== void 0 && Number.isFinite(page) && page > 1) result.set(params.page, String(Math.floor(page)));
+  return result;
+}
+function decodeKeepListQuery(input, options = {}) {
+  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };
+  const searchParams = input instanceof URLSearchParams ? input : new URL(input, "http://keepkit.invalid").searchParams;
+  const search = searchParams.get(params.search)?.trim();
+  const tags = [
+    ...new Set(
+      searchParams.getAll(params.tags).map((tag) => tag.trim()).filter(Boolean)
+    )
+  ];
+  const sortValue = searchParams.get(params.sort)?.split(":");
+  const sort = sortValue?.[0] === "savedAt" || sortValue?.[0] === "updatedAt" ? {
+    by: sortValue[0],
+    direction: sortValue[1] === "asc" ? "asc" : "desc"
+  } : void 0;
+  const rawPage = Number(searchParams.get(params.page));
+  const page = Number.isInteger(rawPage) && rawPage > 0 ? rawPage : void 0;
+  return {
+    ...search ? { search: { query: search } } : {},
+    ...tags.length > 0 ? { tags } : {},
+    ...sort ? { sort } : {},
+    ...page ? { pagination: { page } } : {}
+  };
+}
+function serializeKeepListQuery(query = {}, options = {}) {
+  const value = encodeKeepListQuery(query, options).toString();
+  return value ? `?${value}` : "";
+}
+function mergeKeepListQueryFromUrl(query, input, options = {}) {
+  const decoded = decodeKeepListQuery(input, options);
+  return {
+    ...query,
+    ...decoded,
+    search: decoded.search ?? query.search,
+    tags: decoded.tags ?? query.tags,
+    sort: decoded.sort ?? query.sort,
+    pagination: decoded.pagination ? { ...query.pagination, ...decoded.pagination } : query.pagination
+  };
+}
 export {
   DEFAULT_INDEXEDDB_DATABASE,
   DEFAULT_INDEXEDDB_STORE,
+  DEFAULT_KEEP_URL_PARAMS,
   DEFAULT_STORAGE_KEY,
   DEFAULT_SYNC_QUEUE_DATABASE,
   DEFAULT_SYNC_QUEUE_KEY,
@@ -75,21 +168,32 @@ export {
   KeepStore,
   LocalStorageAdapter,
   LocalStorageSyncQueueAdapter,
+  ScopedStorageAdapter,
+  ScopedSyncQueueAdapter,
   SyncStorageAdapter,
   createBrowserStorageAdapter,
   createKeepInvalidationPlugin,
+  createKeepKitPreset,
+  createKeepKitSetup,
+  createScopedStorageAdapter,
   createStorageAdapter,
+  decodeKeepListQuery,
+  encodeKeepListQuery,
   exportItems,
+  getKeepScopeKey,
   getTagCounts,
   importItems,
   isKeepItemMetadataStale,
+  isSameKeepScope,
   mergeKeepItems,
+  mergeKeepListQueryFromUrl,
   migrateKeepItems,
   normalizeKeepTags,
   parseKeepMeta,
   queryKeepItems,
   reconcileKeepItems,
   revalidateKeepItems,
+  serializeKeepListQuery,
   validateKeepItem
 };
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/integrations.ts"],"sourcesContent":["import type { KeepPlugin, KeepPluginContext } from \"./types\";\n\nexport type KeepInvalidationPluginOptions<TMeta = Record<string, unknown>> = {\n  /** Query keys to invalidate after a successful local KeepKit mutation. */\n  queryKeys: readonly unknown[] | ((context: KeepPluginContext<TMeta>) => readonly (readonly unknown[])[]);\n  /** Connect this callback to queryClient.invalidateQueries or SWR mutate. */\n  invalidate: (queryKey: readonly unknown[], context: KeepPluginContext<TMeta>) => void | Promise<void>;\n  name?: string;\n};\n\n/** Framework-neutral bridge for TanStack Query, SWR, and similar caches. */\nexport function createKeepInvalidationPlugin<TMeta = Record<string, unknown>>(\n  options: KeepInvalidationPluginOptions<TMeta>,\n): KeepPlugin<TMeta> {\n  return {\n    name: options.name ?? \"keepkit-cache-invalidation\",\n    after: async (context) => {\n      const keys = typeof options.queryKeys === \"function\" ? options.queryKeys(context) : [options.queryKeys];\n      await Promise.all(keys.map((queryKey) => options.invalidate(queryKey, context)));\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,SAAS,6BACd,SACmB;AACnB,SAAO;AAAA,IACL,MAAM,QAAQ,QAAQ;AAAA,IACtB,OAAO,OAAO,YAAY;AACxB,YAAM,OAAO,OAAO,QAAQ,cAAc,aAAa,QAAQ,UAAU,OAAO,IAAI,CAAC,QAAQ,SAAS;AACtG,YAAM,QAAQ,IAAI,KAAK,IAAI,CAAC,aAAa,QAAQ,WAAW,UAAU,OAAO,CAAC,CAAC;AAAA,IACjF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/integrations.ts","../src/presets.ts","../src/url.ts"],"sourcesContent":["import type { KeepPlugin, KeepPluginContext } from \"./types\";\n\nexport type KeepInvalidationPluginOptions<TMeta = Record<string, unknown>> = {\n  /** Query keys to invalidate after a successful local KeepKit mutation. */\n  queryKeys: readonly unknown[] | ((context: KeepPluginContext<TMeta>) => readonly (readonly unknown[])[]);\n  /** Connect this callback to queryClient.invalidateQueries or SWR mutate. */\n  invalidate: (queryKey: readonly unknown[], context: KeepPluginContext<TMeta>) => void | Promise<void>;\n  name?: string;\n};\n\n/** Framework-neutral bridge for TanStack Query, SWR, and similar caches. */\nexport function createKeepInvalidationPlugin<TMeta = Record<string, unknown>>(\n  options: KeepInvalidationPluginOptions<TMeta>,\n): KeepPlugin<TMeta> {\n  return {\n    name: options.name ?? \"keepkit-cache-invalidation\",\n    after: async (context) => {\n      const keys = typeof options.queryKeys === \"function\" ? options.queryKeys(context) : [options.queryKeys];\n      await Promise.all(keys.map((queryKey) => options.invalidate(queryKey, context)));\n    },\n  };\n}\n","import { exportItems } from \"./backup\";\nimport { createScopedStorageAdapter, type KeepScope } from \"./scope\";\nimport { createBrowserStorageAdapter } from \"./storage/index\";\nimport { SyncStorageAdapter } from \"./storage/sync\";\nimport type { RemoteSyncDriver, StorageAdapter } from \"./types\";\n\nexport type KeepKitPresetMode = \"local\" | \"sync\" | \"backup\";\n\nexport type KeepKitPresetOptions<TMeta = Record<string, unknown>> = {\n  mode?: KeepKitPresetMode;\n  key?: string;\n  scope?: KeepScope;\n  remote?: RemoteSyncDriver<TMeta>;\n  storage?: StorageAdapter<TMeta>;\n};\n\nexport type KeepKitSetup<TMeta = Record<string, unknown>> = {\n  mode: KeepKitPresetMode;\n  scope?: KeepScope;\n  storage: StorageAdapter<TMeta>;\n  exportBackup: () => Promise<string>;\n};\n\n/**\n * Build the recommended local/sync/backup wiring without imposing an auth or\n * API client. Pass the current user and tenant scope whenever the account changes.\n */\nexport function createKeepKitPreset<TMeta = Record<string, unknown>>(\n  options: KeepKitPresetOptions<TMeta> = {},\n): KeepKitSetup<TMeta> {\n  const mode = options.mode ?? \"local\";\n  const local = options.storage\n    ? options.scope\n      ? createScopedStorageAdapter(options.storage, options.scope)\n      : options.storage\n    : createBrowserStorageAdapter<TMeta>({ key: options.key, scope: options.scope });\n  if (mode === \"sync\" && !options.remote) {\n    throw new Error('createKeepKitPreset({ mode: \"sync\" }) requires a remote driver.');\n  }\n  let storage: StorageAdapter<TMeta> = local;\n  if (mode === \"sync\") {\n    const remote = options.remote;\n    if (!remote) throw new Error('createKeepKitPreset({ mode: \"sync\" }) requires a remote driver.');\n    storage = new SyncStorageAdapter<TMeta>({\n      local,\n      remote,\n      userId: options.scope?.userId,\n      tenantId: options.scope?.tenantId,\n    });\n  }\n  return {\n    mode,\n    scope: options.scope,\n    storage,\n    exportBackup: () => exportItems(storage),\n  };\n}\n\nexport const createKeepKitSetup = createKeepKitPreset;\n","import type { KeepListQuery } from \"./query\";\n\nexport type KeepUrlParamNames = {\n  search: string;\n  tags: string;\n  sort: string;\n  page: string;\n};\n\nexport type KeepUrlSyncOptions = {\n  /** Parameters are intentionally short so shared collection URLs stay readable. */\n  params?: Partial<KeepUrlParamNames>;\n  /** Push is the default so browser back/forward restores collection states. */\n  history?: \"replace\" | \"push\";\n  /** URL to read/write. Defaults to the current browser URL. */\n  url?: string;\n};\n\nexport const DEFAULT_KEEP_URL_PARAMS: KeepUrlParamNames = {\n  search: \"q\",\n  tags: \"tag\",\n  sort: \"sort\",\n  page: \"page\",\n};\n\nexport type KeepUrlState = Pick<KeepListQuery, \"search\" | \"tags\" | \"sort\" | \"pagination\">;\n\n/** Convert a list query to stable URLSearchParams without serializing functions or unsupported filters. */\nexport function encodeKeepListQuery<TMeta = Record<string, unknown>>(\n  query: KeepListQuery<TMeta> = {},\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): URLSearchParams {\n  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };\n  const result = new URLSearchParams();\n  const search = query.search?.query?.trim();\n  if (search) result.set(params.search, search);\n  for (const tag of query.tags ?? []) {\n    const normalized = tag.trim();\n    if (normalized) result.append(params.tags, normalized);\n  }\n  if (query.sort?.by) result.set(params.sort, `${query.sort.by}:${query.sort.direction ?? \"desc\"}`);\n  const page = query.pagination?.page;\n  if (page !== undefined && Number.isFinite(page) && page > 1) result.set(params.page, String(Math.floor(page)));\n  return result;\n}\n\n/** Parse a URL into the query fields supported by KeepCollection. Invalid values are ignored. */\nexport function decodeKeepListQuery(\n  input: string | URL | URLSearchParams,\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): KeepUrlState {\n  const params = { ...DEFAULT_KEEP_URL_PARAMS, ...options.params };\n  const searchParams = input instanceof URLSearchParams ? input : new URL(input, \"http://keepkit.invalid\").searchParams;\n  const search = searchParams.get(params.search)?.trim();\n  const tags = [\n    ...new Set(\n      searchParams\n        .getAll(params.tags)\n        .map((tag) => tag.trim())\n        .filter(Boolean),\n    ),\n  ];\n  const sortValue = searchParams.get(params.sort)?.split(\":\");\n  const sort: KeepListQuery[\"sort\"] =\n    sortValue?.[0] === \"savedAt\" || sortValue?.[0] === \"updatedAt\"\n      ? {\n          by: sortValue[0],\n          direction: sortValue[1] === \"asc\" ? (\"asc\" as const) : (\"desc\" as const),\n        }\n      : undefined;\n  const rawPage = Number(searchParams.get(params.page));\n  const page = Number.isInteger(rawPage) && rawPage > 0 ? rawPage : undefined;\n  return {\n    ...(search ? { search: { query: search } } : {}),\n    ...(tags.length > 0 ? { tags } : {}),\n    ...(sort ? { sort } : {}),\n    ...(page ? { pagination: { page } } : {}),\n  };\n}\n\nexport function serializeKeepListQuery<TMeta = Record<string, unknown>>(\n  query: KeepListQuery<TMeta> = {},\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): string {\n  const value = encodeKeepListQuery(query, options).toString();\n  return value ? `?${value}` : \"\";\n}\n\nexport function mergeKeepListQueryFromUrl<TMeta = Record<string, unknown>>(\n  query: KeepListQuery<TMeta>,\n  input: string | URL | URLSearchParams,\n  options: Pick<KeepUrlSyncOptions, \"params\"> = {},\n): KeepListQuery<TMeta> {\n  const decoded = decodeKeepListQuery(input, options);\n  return {\n    ...query,\n    ...decoded,\n    search: decoded.search ?? query.search,\n    tags: decoded.tags ?? query.tags,\n    sort: decoded.sort ?? query.sort,\n    pagination: decoded.pagination ? { ...query.pagination, ...decoded.pagination } : query.pagination,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/react.d.ts

@@ -1,9 +1,10 @@
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes, MouseEvent, HTMLAttributes, ReactElement, ErrorInfo, Component, PropsWithChildren, ComponentType } from 'react';
-import { f as KeepItemMetadataRefresher, k as KeepItemRevalidator, R as RevalidateKeepItemsOptions, j as KeepItemRevalidationSummary, l as KeepListQuery, g as KeepItemResolver, I as ImportItemsOptions, a as ImportItemsResult, m as KeepStore, n as KeepStoreActions } from './store-Cgqx7_xd.js';
-export { i as KeepItemRevalidationResult, s as isKeepItemMetadataStale } from './store-Cgqx7_xd.js';
-import { m as KeepItemInput, a as KeepItem, k as KeepEventHandlers, S as StorageAdapter, c as KeepPlugin, K as KeepSchema, l as KeepInvalidItemPolicy, e as KeepChangeContext, u as KeepSyncState } from './types--YahIoEB.js';
-export { n as KeepItemStatus } from './types--YahIoEB.js';
+import { g as KeepItemMetadataRefresher, l as KeepItemRevalidator, R as RevalidateKeepItemsOptions, k as KeepItemRevalidationSummary, m as KeepListQuery, h as KeepItemResolver, c as KeepAutoRevalidationOptions, I as ImportItemsOptions, a as ImportItemsResult, n as KeepStore, o as KeepStoreActions } from './url-BYFEfulm.js';
+export { j as KeepItemRevalidationResult, q as KeepUrlParamNames, r as KeepUrlState, s as KeepUrlSyncOptions, y as isKeepItemMetadataStale } from './url-BYFEfulm.js';
+import { p as KeepItemInput, a as KeepItem, n as KeepEventHandlers, b as StorageAdapter, f as KeepPlugin, K as KeepSchema, o as KeepInvalidItemPolicy, h as KeepChangeContext, x as KeepSyncState, z as KeepUndoState } from './types-D-xRiz1Y.js';
+export { q as KeepItemStatus } from './types-D-xRiz1Y.js';
+export { K as KeepScope, S as ScopedStorageAdapter } from './scope-CtLSlZhq.js';
 
 type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     item: KeepItem<TMeta> | undefined;
@@ -13,6 +14,8 @@ type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     error: unknown | null;
     save: () => Promise<void>;
     remove: () => Promise<void>;
+    removeWithUndo: () => Promise<void>;
+    undo: () => Promise<void>;
     toggle: () => Promise<void>;
     updateNote: (note?: string) => Promise<void>;
     updateTags: (tags?: string[]) => Promise<void>;
@@ -36,6 +39,8 @@ type UseKeepListResult<TMeta = Record<string, unknown>> = {
     error: unknown | null;
     remove: (id: string) => Promise<void>;
     removeBatch: (ids: string[]) => Promise<void>;
+    removeWithUndo: (id: string) => Promise<void>;
+    removeBatchWithUndo: (ids: string[]) => Promise<void>;
     updateTagsBatch: (ids: string[], tags?: string[]) => Promise<void>;
     addTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
@@ -122,6 +127,7 @@ type KeepContextValue<TMeta = Record<string, unknown>> = {
     error: unknown | null;
     lastChange?: KeepChangeContext<TMeta>;
     syncState: KeepSyncState;
+    undo: KeepUndoState;
     saveItem: (item: KeepItem<TMeta>) => Promise<void>;
     updateNote: (id: string, note?: string) => Promise<void>;
     updateTags: (id: string, tags?: string[]) => Promise<void>;
@@ -130,6 +136,9 @@ type KeepContextValue<TMeta = Record<string, unknown>> = {
     removeTagsBatch: (ids: string[], tags: string[]) => Promise<void>;
     removeItem: (id: string) => Promise<void>;
     removeItems: (ids: string[]) => Promise<void>;
+    removeItemWithUndo: (id: string) => Promise<void>;
+    removeItemsWithUndo: (ids: string[]) => Promise<void>;
+    undoLastRemoval: () => Promise<void>;
     clear: () => Promise<void>;
     refresh: () => Promise<void>;
     flushSync: () => Promise<void>;
@@ -158,12 +167,14 @@ type KeepProviderProps<TMeta = Record<string, unknown>> = PropsWithChildren<Keep
     boundaryResetKey?: unknown;
     validateItem?: KeepItemRevalidator<TMeta>;
     resolveItem?: KeepItemResolver<TMeta>;
+    autoRevalidation?: KeepAutoRevalidationOptions<TMeta>;
+    undoTimeoutMs?: number;
 }>;
 type KeepStoreAccess<TMeta> = {
     store: KeepStore<TMeta>;
     actions: KeepStoreActions<TMeta>;
 };
-declare function KeepProvider<TMeta = Record<string, unknown>>({ storage, initialItems, onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onError, plugins, schemaVersion, schema, invalidItemPolicy, onInvalidItem, migrateMeta, fallback, onBoundaryError, boundaryResetKey, validateItem, resolveItem, children, }: KeepProviderProps<TMeta>): react.JSX.Element;
+declare function KeepProvider<TMeta = Record<string, unknown>>({ storage, initialItems, onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onUndo, onError, plugins, schemaVersion, schema, invalidItemPolicy, onInvalidItem, migrateMeta, fallback, onBoundaryError, boundaryResetKey, validateItem, resolveItem, autoRevalidation, undoTimeoutMs, children, }: KeepProviderProps<TMeta>): react.JSX.Element;
 declare function useKeepContext<TMeta = Record<string, unknown>>(): KeepContextValue<TMeta>;
 declare function useKeepStore<TMeta = Record<string, unknown>>(): KeepStoreAccess<TMeta>;
 
@@ -179,4 +190,4 @@ type KeepKit<TMeta> = {
 /** Create an app-specific, fully typed set of KeepKit components and hooks. */
 declare function createKeepKit<TMeta = Record<string, unknown>>(options?: CreateKeepKitOptions<TMeta>): KeepKit<TMeta>;
 
-export { type CreateKeepKitOptions, KeepButton, type KeepButtonItem, type KeepButtonProps, type KeepButtonState, type KeepContextValue, KeepErrorBoundary, type KeepErrorBoundaryProps, KeepItemMetadataRefresher, KeepItemResolver, KeepItemRevalidationSummary, KeepItemRevalidator, type KeepKit, KeepListQuery, KeepProvider, type KeepProviderProps, type KeepShortcutModifier, type KeepShortcutOptions, RevalidateKeepItemsOptions, type UseKeepItemResult, type UseKeepListResult, createKeepKit, useKeepContext, useKeepItem, useKeepList, useKeepShortcut, useKeepStore };
+export { type CreateKeepKitOptions, KeepAutoRevalidationOptions, KeepButton, type KeepButtonItem, type KeepButtonProps, type KeepButtonState, type KeepContextValue, KeepErrorBoundary, type KeepErrorBoundaryProps, KeepItemMetadataRefresher, KeepItemResolver, KeepItemRevalidationSummary, KeepItemRevalidator, type KeepKit, KeepListQuery, KeepProvider, type KeepProviderProps, type KeepShortcutModifier, type KeepShortcutOptions, KeepUndoState, RevalidateKeepItemsOptions, type UseKeepItemResult, type UseKeepListResult, createKeepKit, useKeepContext, useKeepItem, useKeepList, useKeepShortcut, useKeepStore };

package/dist/react.js

@@ -6,7 +6,7 @@ import {
   isKeepItemMetadataStale,
   queryKeepItems,
   revalidateKeepItems
-} from "./chunk-XF5VI6O5.js";
+} from "./chunk-MDTL5L64.js";
 import {
   parseKeepMeta
 } from "./chunk-THZ3ACR2.js";
@@ -14,7 +14,7 @@ import "./chunk-5QSZP6MT.js";
 import {
   createBrowserStorageAdapter,
   normalizeKeepTags
-} from "./chunk-EXE4E3GA.js";
+} from "./chunk-36YIELZE.js";
 
 // src/hooks/useKeepItem.ts
 import { useCallback as useCallback3 } from "react";
@@ -69,6 +69,7 @@ function KeepProvider({
   onNoteUpdate,
   onTagsUpdate,
   onChange,
+  onUndo,
   onError,
   plugins = [],
   schemaVersion,
@@ -81,6 +82,8 @@ function KeepProvider({
   boundaryResetKey,
   validateItem,
   resolveItem,
+  autoRevalidation,
+  undoTimeoutMs,
   children
 }) {
   const content = /* @__PURE__ */ jsx(
@@ -93,6 +96,7 @@ function KeepProvider({
       onNoteUpdate,
       onTagsUpdate,
       onChange,
+      onUndo,
       onError,
       plugins,
       schemaVersion,
@@ -102,6 +106,8 @@ function KeepProvider({
       migrateMeta,
       validateItem,
       resolveItem,
+      autoRevalidation,
+      undoTimeoutMs,
       children
     }
   );
@@ -116,6 +122,7 @@ function KeepProviderContent({
   onNoteUpdate,
   onTagsUpdate,
   onChange,
+  onUndo,
   onError,
   plugins = [],
   schemaVersion,
@@ -125,6 +132,8 @@ function KeepProviderContent({
   migrateMeta,
   validateItem,
   resolveItem,
+  autoRevalidation,
+  undoTimeoutMs = 5e3,
   children
 }) {
   const storeRef = useRef(null);
@@ -135,17 +144,19 @@ function KeepProviderContent({
       isHydrated: false,
       isMutating: false,
       error: null,
-      lastChange: void 0
+      lastChange: void 0,
+      undo: { canUndo: false, ids: [] }
     });
   }
   const store = storeRef.current;
   const state = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
-  const { items, isLoading, isHydrated, isMutating, error, lastChange } = state;
+  const { items, isLoading, isHydrated, isMutating, error, lastChange, undo: storedUndo } = state;
+  const undo = storedUndo ?? EMPTY_UNDO_STATE;
   const itemsRef = useRef(items);
   const pluginsRef = useRef(plugins);
   pluginsRef.current = plugins;
-  const handlersRef = useRef({ onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onError });
-  handlersRef.current = { onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onError };
+  const handlersRef = useRef({ onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onUndo, onError });
+  handlersRef.current = { onSave, onRemove, onNoteUpdate, onTagsUpdate, onChange, onUndo, onError };
   const migrationRef = useRef({
     schemaVersion,
     migrateMeta,
@@ -157,6 +168,10 @@ function KeepProviderContent({
   const operationTailRef = useRef(Promise.resolve());
   const pendingRefreshesRef = useRef(0);
   const pendingMutationsRef = useRef(0);
+  const undoRef = useRef(void 0);
+  const autoRevalidationRef = useRef(autoRevalidation);
+  autoRevalidationRef.current = autoRevalidation;
+  const didMountRevalidateRef = useRef(false);
   const syncStorage = isSyncCapableStorage(storage) ? storage : void 0;
   const getSyncState = useCallback(() => syncStorage?.getSyncState() ?? IDLE_SYNC_STATE, [syncStorage]);
   const subscribeSync = useCallback(
@@ -474,6 +489,69 @@ function KeepProviderContent({
     },
     [runMutation, storage]
   );
+  const rememberUndo = useCallback(
+    (removedItems) => {
+      undoRef.current?.timer && clearTimeout(undoRef.current.timer);
+      const expiresAt = Date.now() + Math.max(0, undoTimeoutMs);
+      const timer = setTimeout(
+        () => {
+          undoRef.current = void 0;
+          store.setState({ undo: { canUndo: false, ids: [] } });
+        },
+        Math.max(0, undoTimeoutMs)
+      );
+      undoRef.current = { items: removedItems, expiresAt, timer };
+      store.setState({ undo: { canUndo: true, ids: removedItems.map((item) => item.id), expiresAt } });
+    },
+    [store, undoTimeoutMs]
+  );
+  const removeItemWithUndo = useCallback(
+    async (id) => {
+      const item = itemsRef.current.find((current) => current.id === id);
+      await removeItem(id);
+      if (item) rememberUndo([item]);
+    },
+    [rememberUndo, removeItem]
+  );
+  const removeItemsWithUndo = useCallback(
+    async (ids) => {
+      const idSet = new Set(ids);
+      const removedItems = itemsRef.current.filter((item) => idSet.has(item.id));
+      await removeItems(ids);
+      if (removedItems.length > 0) rememberUndo(removedItems);
+    },
+    [rememberUndo, removeItems]
+  );
+  const undoLastRemoval = useCallback(async () => {
+    const pending = undoRef.current;
+    if (!pending || pending.expiresAt < Date.now()) {
+      undoRef.current = void 0;
+      store.setState({ undo: { canUndo: false, ids: [] } });
+      return;
+    }
+    if (pending.timer) clearTimeout(pending.timer);
+    undoRef.current = void 0;
+    store.setState({ undo: { canUndo: false, ids: [] } });
+    await runMutation("undo", void 0, (previous) => {
+      const restored = new Map(pending.items.map((item) => [item.id, item]));
+      const next = [...previous.filter((item) => !restored.has(item.id)), ...pending.items].sort(
+        (a, b) => b.updatedAt - a.updatedAt
+      );
+      return {
+        next,
+        persist: async () => {
+          if (storage.setMany) await storage.setMany(pending.items);
+          else for (const item of pending.items) await storage.set(item);
+        },
+        onSuccess: () => handlersRef.current.onUndo?.(pending.items),
+        pluginContext: { action: "undo", items: pending.items }
+      };
+    });
+  }, [runMutation, storage, store]);
+  useEffect(() => {
+    if (syncState.status !== "error" || !undoRef.current) return;
+    void undoLastRemoval();
+  }, [syncState.status, undoLastRemoval]);
   const clear = useCallback(
     () => runMutation("clear", void 0, (_previous) => ({
       next: [],
@@ -544,6 +622,27 @@ function KeepProviderContent({
       validateItem
     ]
   );
+  useEffect(() => {
+    const settings = autoRevalidationRef.current;
+    const activeRevalidator = settings?.revalidator ?? validateItem;
+    if (!settings || !activeRevalidator) return;
+    const run = () => void revalidateItems(activeRevalidator, { removeStatuses: settings.removeStatuses }).catch(() => void 0);
+    if (isHydrated && settings.onMount !== false && !didMountRevalidateRef.current) {
+      didMountRevalidateRef.current = true;
+      run();
+    }
+    const interval = settings.intervalMs && settings.intervalMs > 0 ? setInterval(run, settings.intervalMs) : void 0;
+    const onOnline = () => {
+      if (settings.onReconnect !== false) run();
+    };
+    if (typeof window !== "undefined" && settings.onReconnect !== false) {
+      window.addEventListener("online", onOnline);
+    }
+    return () => {
+      if (interval) clearInterval(interval);
+      if (typeof window !== "undefined") window.removeEventListener("online", onOnline);
+    };
+  }, [isHydrated, revalidateItems, validateItem]);
   const refreshItemMetadata = useCallback(
     async (id, refresh2) => {
       if (!itemsRef.current.some((item) => item.id === id)) {
@@ -594,6 +693,7 @@ function KeepProviderContent({
       error,
       lastChange,
       syncState,
+      undo,
       saveItem,
       updateNote,
       updateTags,
@@ -602,6 +702,9 @@ function KeepProviderContent({
       removeTagsBatch,
       removeItem,
       removeItems,
+      removeItemWithUndo,
+      removeItemsWithUndo,
+      undoLastRemoval,
       clear,
       refresh,
       flushSync,
@@ -620,9 +723,13 @@ function KeepProviderContent({
       isMutating,
       items,
       syncState,
+      undo,
       refresh,
       removeItem,
       saveItem,
+      removeItemWithUndo,
+      removeItemsWithUndo,
+      undoLastRemoval,
       updateNote,
       updateTags,
       updateTagsBatch,
@@ -645,6 +752,9 @@ function KeepProviderContent({
       removeTagsBatch,
       removeItem,
       removeItems,
+      removeItemWithUndo,
+      removeItemsWithUndo,
+      undoLastRemoval,
       clear,
       refresh,
       refreshItemMetadata,
@@ -662,7 +772,10 @@ function KeepProviderContent({
       updateTags,
       updateTagsBatch,
       refreshItemMetadata,
-      revalidateItems
+      revalidateItems,
+      removeItemWithUndo,
+      removeItemsWithUndo,
+      undoLastRemoval
     ]
   );
   const storeAccess = useMemo(() => ({ store, actions }), [actions, store]);
@@ -673,6 +786,7 @@ var IDLE_SYNC_STATE = Object.freeze({
   pendingCount: 0,
   conflictIds: []
 });
+var EMPTY_UNDO_STATE = Object.freeze({ canUndo: false, ids: [] });
 function isSyncCapableStorage(storage) {
   return "getSyncState" in storage && typeof storage.getSyncState === "function" && "subscribeSync" in storage && typeof storage.subscribeSync === "function" && "flushSync" in storage && typeof storage.flushSync === "function";
 }
@@ -745,6 +859,7 @@ function useKeepItem(input) {
     });
   }, [actions, input, item?.savedAt]);
   const remove = useCallback3(() => actions.removeItem(id), [actions, id]);
+  const removeWithUndo = useCallback3(() => actions.removeItemWithUndo(id), [actions, id]);
   const toggle = useCallback3(() => item ? remove() : save(), [item, remove, save]);
   const updateNote = useCallback3((note) => actions.updateNote(id, note), [actions, id]);
   const updateTags = useCallback3((tags) => actions.updateTags(id, tags), [actions, id]);
@@ -760,6 +875,8 @@ function useKeepItem(input) {
     error,
     save,
     remove,
+    removeWithUndo,
+    undo: actions.undoLastRemoval,
     toggle,
     updateNote,
     updateTags,
@@ -814,6 +931,8 @@ function useKeepList(query = {}) {
   const allTags = useKeepStoreSelector(store, tagsSelector);
   const remove = useCallback4((id) => actions.removeItem(id), [actions]);
   const removeBatch = useCallback4((ids) => actions.removeItems(ids), [actions]);
+  const removeWithUndo = useCallback4((id) => actions.removeItemWithUndo(id), [actions]);
+  const removeBatchWithUndo = useCallback4((ids) => actions.removeItemsWithUndo(ids), [actions]);
   const updateTagsBatch = useCallback4(
     (ids, nextTags) => actions.updateTagsBatch(ids, nextTags),
     [actions]
@@ -841,6 +960,8 @@ function useKeepList(query = {}) {
     error,
     remove,
     removeBatch,
+    removeWithUndo,
+    removeBatchWithUndo,
     updateTagsBatch,
     addTagsBatch,
     removeTagsBatch,