@keepkit/core 0.17.0 → 0.18.0

package/dist/react.d.ts

@@ -1,10 +1,10 @@
+import { g as KeepItemMetadataRefresher, l as KeepItemRevalidator, h as KeepItemResolver, c as KeepAutoRevalidationOptions, R as RevalidateKeepItemsOptions, k as KeepItemRevalidationSummary, I as ImportItemsOptions, a as ImportItemsResult, o as KeepStore, p as KeepStoreActions, m as KeepListQuery, n as KeepNavigationState } from './store-Cm35R_ho.js';
+export { j as KeepItemRevalidationResult, r as KeepUrlParamNames, s as KeepUrlState, t as KeepUrlSyncOptions, A as isKeepItemMetadataStale } from './store-Cm35R_ho.js';
+import { r as KeepItemInput, K as KeepItem, p as KeepEventHandlers, a as StorageAdapter, e as KeepPlugin, t as KeepSchema, q as KeepInvalidItemPolicy, j as KeepChangeContext, D as KeepSyncState, F as KeepUndoState } from './types-Aoc0Eyvk.js';
+export { s as KeepItemStatus } from './types-Aoc0Eyvk.js';
+export { K as KeepScope, S as ScopedStorageAdapter } from './scope-Dk5FTVz8.js';
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes, MouseEvent, HTMLAttributes, ReactElement, ErrorInfo, Component, PropsWithChildren, ComponentType } from 'react';
-import { g as KeepItemMetadataRefresher, l as KeepItemRevalidator, R as RevalidateKeepItemsOptions, k as KeepItemRevalidationSummary, m as KeepListQuery, n as KeepNavigationState, h as KeepItemResolver, c as KeepAutoRevalidationOptions, I as ImportItemsOptions, a as ImportItemsResult, o as KeepStore, p as KeepStoreActions } from './url-Blx4SPKD.js';
-export { j as KeepItemRevalidationResult, r as KeepUrlParamNames, s as KeepUrlState, t as KeepUrlSyncOptions, A as isKeepItemMetadataStale } from './url-Blx4SPKD.js';
-import { s as KeepItemInput, a as KeepItem, q as KeepEventHandlers, b as StorageAdapter, f as KeepPlugin, K as KeepSchema, r as KeepInvalidItemPolicy, k as KeepChangeContext, D as KeepSyncState, F as KeepUndoState } from './types-B3xc8-Pi.js';
-export { t as KeepItemStatus } from './types-B3xc8-Pi.js';
-export { K as KeepScope, S as ScopedStorageAdapter } from './scope-D52NbAWR.js';
 
 type UseKeepItemResult<TMeta = Record<string, unknown>> = {
     item: KeepItem<TMeta> | undefined;
@@ -24,63 +24,6 @@ type UseKeepItemResult<TMeta = Record<string, unknown>> = {
 /** Read and mutate one saved item from its complete minimal input description. */
 declare function useKeepItem<TMeta = Record<string, unknown>>(input?: KeepItemInput<TMeta>): UseKeepItemResult<TMeta>;
 
-type UseKeepListResult<TMeta = Record<string, unknown>> = {
-    items: KeepItem<TMeta>[];
-    totalCount: number;
-    tags: string[];
-    tagCounts: Record<string, number>;
-    page: number;
-    pageCount: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-    isLoading: boolean;
-    isHydrated: boolean;
-    isMutating: boolean;
-    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>;
-    reorder: (orderedIds: string[]) => Promise<void>;
-    move: (id: string, targetIndex: number) => Promise<void>;
-    clear: () => Promise<void>;
-    refresh: () => Promise<void>;
-    revalidate: (revalidator: KeepItemRevalidator<TMeta>, options?: RevalidateKeepItemsOptions<TMeta>) => Promise<KeepItemRevalidationSummary<TMeta>>;
-};
-declare function useKeepList<TMeta = Record<string, unknown>>(query?: KeepListQuery<TMeta>): UseKeepListResult<TMeta>;
-
-type UseKeepNavigatorOptions<TMeta = Record<string, unknown>> = {
-    currentId?: string;
-    initialIndex?: number;
-    query?: Omit<KeepListQuery<TMeta>, "pagination">;
-};
-type UseKeepNavigatorResult<TMeta = Record<string, unknown>> = KeepNavigationState<TMeta> & {
-    goToNext: () => KeepItem<TMeta> | null;
-    goToPrev: () => KeepItem<TMeta> | null;
-    goToIndex: (index: number) => KeepItem<TMeta> | null;
-    goToItem: (id: string) => KeepItem<TMeta> | null;
-};
-/** Derive a stable previous/current/next view and pointer actions from the provider store. */
-declare function useKeepNavigator<TMeta = Record<string, unknown>>(options?: UseKeepNavigatorOptions<TMeta>): UseKeepNavigatorResult<TMeta>;
-
-type KeepShortcutModifier = "meta" | "ctrl" | "alt" | "shift";
-type KeepShortcutOptions<TMeta = Record<string, unknown>> = {
-    key: string;
-    modifier?: KeepShortcutModifier;
-    item?: KeepItemInput<TMeta>;
-    action?: "toggle" | "save" | "remove";
-    enabled?: boolean;
-    preventDefault?: boolean;
-    allowInEditable?: boolean;
-    onTrigger?: (event: KeyboardEvent) => void | Promise<void>;
-    onError?: (error: unknown) => void;
-};
-/** Bind a keyboard shortcut to a Keep action or an arbitrary command. */
-declare function useKeepShortcut<TMeta = Record<string, unknown>>(options: KeepShortcutOptions<TMeta>): void;
-
 type KeepButtonItem<TMeta = Record<string, unknown>> = KeepItemInput<TMeta>;
 type KeepButtonSharedProps<TMeta> = {
     item: KeepButtonItem<TMeta>;
@@ -197,6 +140,63 @@ declare function KeepProvider<TMeta = Record<string, unknown>>({ storage, initia
 declare function useKeepContext<TMeta = Record<string, unknown>>(): KeepContextValue<TMeta>;
 declare function useKeepStore<TMeta = Record<string, unknown>>(): KeepStoreAccess<TMeta>;
 
+type UseKeepListResult<TMeta = Record<string, unknown>> = {
+    items: KeepItem<TMeta>[];
+    totalCount: number;
+    tags: string[];
+    tagCounts: Record<string, number>;
+    page: number;
+    pageCount: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isLoading: boolean;
+    isHydrated: boolean;
+    isMutating: boolean;
+    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>;
+    reorder: (orderedIds: string[]) => Promise<void>;
+    move: (id: string, targetIndex: number) => Promise<void>;
+    clear: () => Promise<void>;
+    refresh: () => Promise<void>;
+    revalidate: (revalidator: KeepItemRevalidator<TMeta>, options?: RevalidateKeepItemsOptions<TMeta>) => Promise<KeepItemRevalidationSummary<TMeta>>;
+};
+declare function useKeepList<TMeta = Record<string, unknown>>(query?: KeepListQuery<TMeta>): UseKeepListResult<TMeta>;
+
+type UseKeepNavigatorOptions<TMeta = Record<string, unknown>> = {
+    currentId?: string;
+    initialIndex?: number;
+    query?: Omit<KeepListQuery<TMeta>, "pagination">;
+};
+type UseKeepNavigatorResult<TMeta = Record<string, unknown>> = KeepNavigationState<TMeta> & {
+    goToNext: () => KeepItem<TMeta> | null;
+    goToPrev: () => KeepItem<TMeta> | null;
+    goToIndex: (index: number) => KeepItem<TMeta> | null;
+    goToItem: (id: string) => KeepItem<TMeta> | null;
+};
+/** Derive a stable previous/current/next view and pointer actions from the provider store. */
+declare function useKeepNavigator<TMeta = Record<string, unknown>>(options?: UseKeepNavigatorOptions<TMeta>): UseKeepNavigatorResult<TMeta>;
+
+type KeepShortcutModifier = "meta" | "ctrl" | "alt" | "shift";
+type KeepShortcutOptions<TMeta = Record<string, unknown>> = {
+    key: string;
+    modifier?: KeepShortcutModifier;
+    item?: KeepItemInput<TMeta>;
+    action?: "toggle" | "save" | "remove";
+    enabled?: boolean;
+    preventDefault?: boolean;
+    allowInEditable?: boolean;
+    onTrigger?: (event: KeyboardEvent) => void | Promise<void>;
+    onError?: (error: unknown) => void;
+};
+/** Bind a keyboard shortcut to a Keep action or an arbitrary command. */
+declare function useKeepShortcut<TMeta = Record<string, unknown>>(options: KeepShortcutOptions<TMeta>): void;
+
 type CreateKeepKitOptions<TMeta = Record<string, unknown>> = Omit<KeepProviderProps<TMeta>, "children">;
 type KeepKit<TMeta> = {
     Provider: ComponentType<KeepProviderProps<TMeta>>;

package/dist/react.js

@@ -10,19 +10,26 @@ import {
   queryKeepItems,
   reorderKeepItems,
   revalidateKeepItems
-} from "./chunk-XWZ6GRD4.js";
+} from "./chunk-62I2YZYI.js";
 import {
   parseKeepMeta
-} from "./chunk-THZ3ACR2.js";
+} from "./chunk-5W4QSJHV.js";
 import {
   createBrowserStorageAdapter,
   normalizeKeepTags
-} from "./chunk-XIBTMJ4R.js";
+} from "./chunk-PNP7OALR.js";
 
-// src/hooks/useKeepItem.ts
+// src/react/components/KeepButton.tsx
+import {
+  Children,
+  cloneElement,
+  isValidElement
+} from "react";
+
+// src/react/hooks/useKeepItem.ts
 import { useCallback as useCallback3 } from "react";
 
-// src/KeepProvider.tsx
+// src/react/components/KeepProvider.tsx
 import {
   createContext,
   useCallback,
@@ -33,7 +40,7 @@ import {
   useSyncExternalStore
 } from "react";
 
-// src/KeepErrorBoundary.tsx
+// src/react/components/KeepErrorBoundary.tsx
 import { Component } from "react";
 var KeepErrorBoundary = class extends Component {
   constructor() {
@@ -59,7 +66,7 @@ var KeepErrorBoundary = class extends Component {
   }
 };
 
-// src/KeepProvider.tsx
+// src/react/components/KeepProvider.tsx
 import { jsx } from "react/jsx-runtime";
 var defaultStorage = createBrowserStorageAdapter();
 var KeepContext = createContext(null);
@@ -565,7 +572,8 @@ function KeepProviderContent({
   const rememberUndo = useCallback(
     (removedItems) => {
       undoRef.current?.timer && clearTimeout(undoRef.current.timer);
-      const expiresAt = Date.now() + Math.max(0, undoTimeoutMs);
+      const startedAt = Date.now();
+      const expiresAt = startedAt + Math.max(0, undoTimeoutMs);
       const timer = setTimeout(
         () => {
           undoRef.current = void 0;
@@ -574,7 +582,7 @@ function KeepProviderContent({
         Math.max(0, undoTimeoutMs)
       );
       undoRef.current = { items: removedItems, expiresAt, timer };
-      store.setState({ undo: { canUndo: true, ids: removedItems.map((item) => item.id), expiresAt } });
+      store.setState({ undo: { canUndo: true, ids: removedItems.map((item) => item.id), startedAt, expiresAt } });
     },
     [store, undoTimeoutMs]
   );
@@ -910,7 +918,7 @@ function useKeepStore() {
   return context;
 }
 
-// src/hooks/useKeepStoreSelector.ts
+// src/react/hooks/useKeepStoreSelector.ts
 import { useCallback as useCallback2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2 } from "react";
 function useKeepStoreSelector(store, selector) {
   const cacheRef = useRef2(null);
@@ -925,7 +933,7 @@ function useKeepStoreSelector(store, selector) {
   return useSyncExternalStore2(store.subscribe, getSelectedSnapshot, getSelectedSnapshot);
 }
 
-// src/hooks/useKeepItem.ts
+// src/react/hooks/useKeepItem.ts
 function useKeepItem(input) {
   const { store, actions } = useKeepStore();
   const id = input?.id ?? "";
@@ -982,7 +990,96 @@ function useKeepItem(input) {
   };
 }
 
-// src/hooks/useKeepList.ts
+// src/react/components/KeepButton.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+function KeepButton({
+  item,
+  children,
+  savedLabel = "Saved",
+  unsavedLabel = "Save",
+  savedAriaLabel,
+  unsavedAriaLabel,
+  getAriaLabel,
+  asChild = false,
+  onToggleError,
+  onClick,
+  disabled,
+  ...buttonProps
+}) {
+  const state = useKeepItem(item);
+  const { isSaved, toggle } = state;
+  const isDisabled = disabled ?? state.isMutating;
+  async function handleClick(event) {
+    if (isDisabled) return;
+    if (asChild) {
+      onClick?.(event);
+    } else {
+      onClick?.(
+        event
+      );
+    }
+    if (event.defaultPrevented) return;
+    try {
+      await toggle();
+    } catch (error) {
+      onToggleError?.(error);
+    }
+  }
+  const content = typeof children === "function" ? children(state) : children ?? (isSaved ? savedLabel : unsavedLabel);
+  function handleElementClick(event) {
+    if (isDisabled) return;
+    if (asChild && isValidElement(content)) {
+      content.props.onClick?.(event);
+    }
+    if (!event.defaultPrevented) void handleClick(event);
+  }
+  function handleKeyDown(event) {
+    if (asChild && isValidElement(content)) {
+      content.props.onKeyDown?.(event);
+    }
+    buttonProps.onKeyDown?.(event);
+    if (!event.defaultPrevented && !isDisabled && asChild && (event.key === "Enter" || event.key === " ")) {
+      void handleClick(event);
+      event.preventDefault();
+    }
+  }
+  const child = asChild ? Children.only(content) : void 0;
+  if (asChild && !isValidElement(child)) {
+    throw new Error("KeepButton with asChild requires a single React element child.");
+  }
+  const commonProps = {
+    ...buttonProps,
+    "aria-pressed": isSaved,
+    "data-state": state.error ? "error" : isSaved ? "saved" : "unsaved",
+    "data-loading": state.isLoading || state.isMutating ? "true" : void 0,
+    "data-disabled": isDisabled ? "true" : void 0,
+    "aria-label": ("aria-label" in buttonProps ? buttonProps["aria-label"] : void 0) ?? getAriaLabel?.(state) ?? (isSaved ? savedAriaLabel : unsavedAriaLabel) ?? getAccessibleLabel(isSaved, item, asChild),
+    ...asChild ? {
+      "aria-disabled": isDisabled,
+      role: buttonProps.role ?? "button",
+      tabIndex: isDisabled ? -1 : buttonProps.tabIndex ?? 0
+    } : { disabled: isDisabled },
+    onClick: handleElementClick,
+    onKeyDown: handleKeyDown
+  };
+  if (asChild) {
+    return cloneElement(child, commonProps);
+  }
+  return /* @__PURE__ */ jsx2("button", { ...commonProps, type: "type" in buttonProps ? buttonProps.type ?? "button" : "button", children: content });
+}
+function getAccessibleLabel(isSaved, item, asChild) {
+  if (!asChild) return isSaved ? "Remove saved item" : "Save item";
+  const title = getMetaTitle(item.meta);
+  const subject = title ? `${item.targetType ?? "item"}: ${title}` : item.targetType ?? "item";
+  return `${isSaved ? "Remove" : "Save"} ${subject}`;
+}
+function getMetaTitle(meta) {
+  if (typeof meta !== "object" || meta === null || !("title" in meta)) return void 0;
+  const title = meta.title;
+  return typeof title === "string" && title.trim() ? title.trim() : void 0;
+}
+
+// src/react/hooks/useKeepList.ts
 import { useCallback as useCallback4, useMemo as useMemo2 } from "react";
 function useKeepList(query = {}) {
   const { store, actions } = useKeepStore();
@@ -1082,7 +1179,7 @@ function sameCounts(left, right) {
   });
 }
 
-// src/hooks/useKeepNavigator.ts
+// src/react/hooks/useKeepNavigator.ts
 import { useCallback as useCallback5, useMemo as useMemo3, useState } from "react";
 function useKeepNavigator(options = {}) {
   const { store } = useKeepStore();
@@ -1138,7 +1235,7 @@ function useKeepNavigator(options = {}) {
   return { ...navigation, goToNext, goToPrev, goToIndex, goToItem };
 }
 
-// src/hooks/useKeepShortcut.ts
+// src/react/hooks/useKeepShortcut.ts
 import { useEffect as useEffect2 } from "react";
 function useKeepShortcut(options) {
   const item = useKeepItem(options.item);
@@ -1194,101 +1291,7 @@ function isEditableTarget(target) {
   return target.isContentEditable || target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT";
 }
 
-// src/KeepButton.tsx
-import {
-  Children,
-  cloneElement,
-  isValidElement
-} from "react";
-import { jsx as jsx2 } from "react/jsx-runtime";
-function KeepButton({
-  item,
-  children,
-  savedLabel = "Saved",
-  unsavedLabel = "Save",
-  savedAriaLabel,
-  unsavedAriaLabel,
-  getAriaLabel,
-  asChild = false,
-  onToggleError,
-  onClick,
-  disabled,
-  ...buttonProps
-}) {
-  const state = useKeepItem(item);
-  const { isSaved, toggle } = state;
-  const isDisabled = disabled ?? state.isMutating;
-  async function handleClick(event) {
-    if (isDisabled) return;
-    if (asChild) {
-      onClick?.(event);
-    } else {
-      onClick?.(
-        event
-      );
-    }
-    if (event.defaultPrevented) return;
-    try {
-      await toggle();
-    } catch (error) {
-      onToggleError?.(error);
-    }
-  }
-  const content = typeof children === "function" ? children(state) : children ?? (isSaved ? savedLabel : unsavedLabel);
-  function handleElementClick(event) {
-    if (isDisabled) return;
-    if (asChild && isValidElement(content)) {
-      content.props.onClick?.(event);
-    }
-    if (!event.defaultPrevented) void handleClick(event);
-  }
-  function handleKeyDown(event) {
-    if (asChild && isValidElement(content)) {
-      content.props.onKeyDown?.(event);
-    }
-    buttonProps.onKeyDown?.(event);
-    if (!event.defaultPrevented && !isDisabled && asChild && (event.key === "Enter" || event.key === " ")) {
-      void handleClick(event);
-      event.preventDefault();
-    }
-  }
-  const child = asChild ? Children.only(content) : void 0;
-  if (asChild && !isValidElement(child)) {
-    throw new Error("KeepButton with asChild requires a single React element child.");
-  }
-  const commonProps = {
-    ...buttonProps,
-    "aria-pressed": isSaved,
-    "data-state": state.error ? "error" : isSaved ? "saved" : "unsaved",
-    "data-loading": state.isLoading || state.isMutating ? "true" : void 0,
-    "data-disabled": isDisabled ? "true" : void 0,
-    "aria-label": ("aria-label" in buttonProps ? buttonProps["aria-label"] : void 0) ?? getAriaLabel?.(state) ?? (isSaved ? savedAriaLabel : unsavedAriaLabel) ?? getAccessibleLabel(isSaved, item, asChild),
-    ...asChild ? {
-      "aria-disabled": isDisabled,
-      role: buttonProps.role ?? "button",
-      tabIndex: isDisabled ? -1 : buttonProps.tabIndex ?? 0
-    } : { disabled: isDisabled },
-    onClick: handleElementClick,
-    onKeyDown: handleKeyDown
-  };
-  if (asChild) {
-    return cloneElement(child, commonProps);
-  }
-  return /* @__PURE__ */ jsx2("button", { ...commonProps, type: "type" in buttonProps ? buttonProps.type ?? "button" : "button", children: content });
-}
-function getAccessibleLabel(isSaved, item, asChild) {
-  if (!asChild) return isSaved ? "Remove saved item" : "Save item";
-  const title = getMetaTitle(item.meta);
-  const subject = title ? `${item.targetType ?? "item"}: ${title}` : item.targetType ?? "item";
-  return `${isSaved ? "Remove" : "Save"} ${subject}`;
-}
-function getMetaTitle(meta) {
-  if (typeof meta !== "object" || meta === null || !("title" in meta)) return void 0;
-  const title = meta.title;
-  return typeof title === "string" && title.trim() ? title.trim() : void 0;
-}
-
-// src/createKeepKit.tsx
+// src/react/createKeepKit.tsx
 import { jsx as jsx3 } from "react/jsx-runtime";
 function createKeepKit(options = {}) {
   return {