@keepkit/ui 0.3.0 → 0.4.0

package/README.md

@@ -27,13 +27,28 @@ function SavedItems() {
 
 - `KeepButton`: 保存済み状態、`aria-pressed`、ローディング・エラー状態、`asChild`、render props。`labels` または既存の `savedAriaLabel` / `unsavedAriaLabel` で翻訳できます。
 - `KeepList`: 保存一覧、読み込み中・空・エラー状態、標準カード、削除操作。`renderItem` で行単位を置き換えられます。
-- `KeepItemCard`: タイトル、画像、保存ボタン、削除ボタン。`getImageUrl` とrender propsで表示を差し替えられます。
+- `KeepItemCard`: タイトル、画像、保存ボタン、削除ボタン。`getImageProps`、`imageComponent`、`renderImage` とrender propsで表示を差し替えられます。
 - `KeepTagFilter`: タグと件数を表示するキーボード操作可能なフィルター。`value` / `onValueChange` のcontrolled APIに対応します。
 - `KeepNoteEditor`: ノートの編集・保存フォーム。`render` で完全なカスタムUIにできます。
+- `KeepSearchInput` / `KeepSortSelect` / `KeepPagination`: `useKeepList` に渡す検索、ソート、offsetページング用のプリミティブ。
+- `KeepTagEditor` / `KeepBulkActions`: タグ編集、複数選択、一括削除、一括タグ更新。
+- `KeepUiProvider`: `labels`、`locale`、`labelResolver` をUI全体に適用するラベルコンテキスト。
+- `KeepAnnouncements`: 保存、削除、ノート保存の成功を `aria-live` で通知します。
 - `KeepEmptyState` / `KeepStatus`: 空、読み込み中、保存中、同期中、エラー状態の表示。
 
 すべてのルート要素で `className` を利用でき、対応コンポーネントでは `asChild` で既存要素をルートとして利用できます。コンポーネントの標準HTMLは意味的な要素、ネイティブボタン、フォーム、`aria-live` を利用します。
 
+### カスタマイズ契約
+
+- `render` / render props はstateを受け取り、標準内部マークアップを置き換えます。`KeepList.renderItem` は各アイテムだけを置き換えます。
+- `KeepItemCard` の画像は `getImageProps` で `src`、`alt`、`width`、`height`、`srcSet` を作り、`imageComponent` または `renderImage` で描画します。
+- `asChild` は単一のReact要素を必要とし、ルート要素だけを置き換えます。内部のアクセシビリティ属性とイベントは保持してください。
+- 標準構造は `KeepList` が `div > ul > li`、`KeepTagFilter` が `fieldset`、`KeepNoteEditor` が `form`、一括操作が `section > fieldset` です。
+- CSSはルートと渡された標準要素の `className` に適用します。コンポーネントはstyleを持ちません。
+- `onClick`、`onSubmit`、`onChange` は利用者のハンドラーを先に実行し、`preventDefault()` された場合は既定操作を実行しません。
+
+ラベルと画像の拡張ポイントは `KeepUiProvider` と `getImageProps`/`imageComponent`/`renderImage` に集約しています。既存の個別label propsも明示的な上書き用途として利用できます。
+
 ## English
 
 `@keepkit/ui` provides low-dependency, style-free React UI primitives that connect `@keepkit/core` state to an app's own CSS or design system. It has no direct dependency on Tailwind CSS, shadcn/ui, or another component library.
@@ -57,4 +72,8 @@ function SavedItems() {
 
 Components include `KeepButton`, `KeepList`, `KeepItemCard`, `KeepTagFilter`, `KeepNoteEditor`, `KeepEmptyState`, and `KeepStatus`. They support `className`, render props, localized labels, and `asChild` where a root element can be replaced. The defaults use semantic HTML, native keyboard behavior, `aria-pressed`, and live-region status announcements. `KeepList` includes loading, empty, error, and removal states, while `KeepTagFilter` exposes controlled `value` / `onValueChange` state.
 
-The package re-exports `KeepProvider` and the core React hooks for convenient composition. The state and storage implementation remains in `@keepkit/core`; this package only adds the UI layer.
+The package also exports `KeepSearchInput`, `KeepSortSelect`, `KeepPagination`, `KeepTagEditor`, `KeepBulkActions`, `KeepUiProvider`, and `KeepAnnouncements`. Configure labels once with `KeepUiProvider`, replace card images with `getImageProps` plus `imageComponent` or `renderImage`, and use `KeepAnnouncements` for success messages in a polite live region.
+
+Customization is explicit: render props replace component markup, `KeepList.renderItem` replaces one item, `asChild` replaces only a single root element, and standard HTML structure is stable (`div > ul > li`, `fieldset`, `form`, and `section > fieldset`). User handlers run before default behavior and `preventDefault()` cancels it. The old URL-only image entry point is replaced by the structured image API; app-wide labels belong in `KeepUiProvider`.
+
+The package re-exports `KeepProvider` and the core React hooks for convenient composition. The state and storage implementation remains in `@keepkit/core`; this package only adds the UI layer. Existing component label props remain available as explicit overrides, while app-wide defaults belong in `KeepUiProvider`.

package/dist/index.d.ts

@@ -1,10 +1,29 @@
 import * as react from 'react';
-import { ReactNode, HTMLAttributes, ReactElement, FormHTMLAttributes } from 'react';
-import { KeepItem, KeepListOptions } from '@keepkit/core/core';
+import { HTMLAttributes, ReactNode, ReactElement, ImgHTMLAttributes, ComponentType, FormHTMLAttributes, InputHTMLAttributes, SelectHTMLAttributes } from 'react';
+import { KeepListOptions, KeepItem } from '@keepkit/core/core';
 export { KeepItem, KeepItemInput, KeepListOptions, KeepSyncStatus } from '@keepkit/core/core';
 import { KeepButtonProps as KeepButtonProps$1, UseKeepListResult } from '@keepkit/core/react';
 export { KeepContextValue, KeepProvider, KeepProviderProps, useKeepContext, useKeepItem, useKeepList } from '@keepkit/core/react';
 
+type KeepUiLabelKey = "save" | "saved" | "remove" | "loading" | "saving" | "syncing" | "error" | "allTags" | "filterTags" | "note" | "saveNote" | "noItems" | "loadingItems" | "errorItems" | "search" | "sort" | "newest" | "oldest" | "previousPage" | "nextPage" | "pagination" | "page" | "selectItems" | "selectedCount" | "deleteSelected" | "tagsToApply" | "applyTags" | "savedMessage" | "removedMessage" | "noteSavedMessage";
+type KeepUiLabels = Partial<Record<KeepUiLabelKey, string>>;
+type KeepUiLabelContext = {
+    locale?: string;
+    labels: Readonly<Record<KeepUiLabelKey, string>>;
+    labelResolver?: (key: KeepUiLabelKey, context: {
+        locale?: string;
+    }) => string | undefined;
+};
+type KeepUiProviderProps = {
+    labels?: KeepUiLabels;
+    locale?: string;
+    labelResolver?: KeepUiLabelContext["labelResolver"];
+    children?: ReactNode;
+};
+/** Provides one locale-aware label source to every UI primitive. */
+declare function KeepUiProvider({ labels, locale, labelResolver, children }: KeepUiProviderProps): react.JSX.Element;
+declare function useKeepUiLabels(): KeepUiLabelContext;
+
 type RenderProp<TState> = (state: TState) => ReactNode;
 type KeepButtonLabels = {
     saved?: ReactNode;
@@ -26,10 +45,16 @@ type KeepItemCardState<TMeta = Record<string, unknown>> = {
     error: unknown | null;
     remove: () => Promise<void>;
 };
+type KeepImageProps = ImgHTMLAttributes<HTMLImageElement> & {
+    src: string;
+    alt: string;
+};
 type KeepItemCardProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & {
     item: KeepItem<TMeta>;
     title?: ReactNode | ((item: KeepItem<TMeta>) => ReactNode);
-    getImageUrl?: (item: KeepItem<TMeta>) => string | undefined;
+    getImageProps?: (item: KeepItem<TMeta>, title: ReactNode) => KeepImageProps | undefined;
+    imageComponent?: ComponentType<KeepImageProps>;
+    renderImage?: (props: KeepImageProps, item: KeepItem<TMeta>) => ReactNode;
     imageAlt?: string;
     render?: RenderProp<KeepItemCardState<TMeta>>;
     children?: ReactNode | RenderProp<KeepItemCardState<TMeta>>;
@@ -41,7 +66,7 @@ type KeepItemCardProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HT
     asChild?: boolean;
 };
 /** A low-dependency item presentation primitive. The default markup can be replaced with render props. */
-declare function KeepItemCard<TMeta = Record<string, unknown>>({ item, title, getImageUrl, imageAlt, render, children, removeLabel, onRemoveError, onRemoved, showSaveButton, saveButtonLabels, asChild, className, ...rootProps }: KeepItemCardProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+declare function KeepItemCard<TMeta = Record<string, unknown>>({ item, title, getImageProps, imageComponent: ImageComponent, renderImage, imageAlt, render, children, removeLabel, onRemoveError, onRemoved, showSaveButton, saveButtonLabels, asChild, className, ...rootProps }: KeepItemCardProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
 type KeepListState<TMeta = Record<string, unknown>> = UseKeepListResult<TMeta>;
 type KeepListProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
     options?: KeepListOptions<TMeta>;
@@ -97,7 +122,59 @@ type KeepNoteEditorProps<TMeta = Record<string, unknown>> = Omit<FormHTMLAttribu
     asChild?: boolean;
 };
 /** A controlled-by-default note editor that persists through useKeepItem. */
-declare function KeepNoteEditor<TMeta = Record<string, unknown>>({ item, label, saveLabel, placeholder, onSaved, onSaveError, render, children, asChild, className, ...formProps }: KeepNoteEditorProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+declare function KeepNoteEditor<TMeta = Record<string, unknown>>({ item, label, saveLabel, placeholder, onSaved, onSaveError, render, children, asChild, className, ...formProps }: KeepNoteEditorProps<TMeta>): react.JSX.Element;
+type KeepSearchInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange"> & {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+};
+/** A controlled/uncontrolled search field for wiring into useKeepList.searchQuery. */
+declare function KeepSearchInput({ value: controlledValue, defaultValue, onValueChange, "aria-label": ariaLabel, placeholder, ...props }: KeepSearchInputProps): react.JSX.Element;
+type KeepSortValue = "savedAt:desc" | "savedAt:asc" | "updatedAt:desc" | "updatedAt:asc";
+type KeepSortSelectProps = Omit<SelectHTMLAttributes<HTMLSelectElement>, "value" | "defaultValue" | "onChange"> & {
+    value?: KeepSortValue;
+    defaultValue?: KeepSortValue;
+    onValueChange?: (value: KeepSortValue, sort: NonNullable<KeepListOptions["sort"]>) => void;
+};
+/** Emits a normalized sort descriptor that can be passed directly to useKeepList. */
+declare function KeepSortSelect({ value: controlledValue, defaultValue, onValueChange, "aria-label": ariaLabel, children, ...props }: KeepSortSelectProps): react.JSX.Element;
+type KeepPaginationProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    totalCount: number;
+    pageSize: number;
+    page?: number;
+    onPageChange?: (page: number, offset: number) => void;
+    render?: RenderProp<{
+        page: number;
+        pageCount: number;
+        goToPage: (page: number) => void;
+    }>;
+};
+/** A small accessible pagination control using one-based pages and zero-based offsets. */
+declare function KeepPagination({ totalCount, pageSize, page, onPageChange, render, ...props }: KeepPaginationProps): react.JSX.Element;
+type KeepTagEditorProps<TMeta = Record<string, unknown>> = Omit<FormHTMLAttributes<HTMLFormElement>, "children" | "onSubmit"> & {
+    item: KeepItem<TMeta>;
+    availableTags?: string[];
+    onSaved?: (tags?: string[]) => void;
+    onSaveError?: (error: unknown) => void;
+    render?: RenderProp<{
+        tags: string[];
+        setTags: (tags: string[]) => void;
+        save: () => Promise<void>;
+        isSaving: boolean;
+    }>;
+};
+/** Edits one item's normalized tag set and exposes a render-prop escape hatch. */
+declare function KeepTagEditor<TMeta = Record<string, unknown>>({ item, availableTags, onSaved, onSaveError, render, ...props }: KeepTagEditorProps<TMeta>): react.JSX.Element;
+type KeepBulkActionsProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    listOptions?: KeepListOptions<TMeta>;
+    selectedIds?: string[];
+    defaultSelectedIds?: string[];
+    onSelectedIdsChange?: (ids: string[]) => void;
+    renderItem?: (item: KeepItem<TMeta>, selected: boolean) => ReactNode;
+    onCompleted?: (action: "remove" | "tags", ids: string[]) => void;
+};
+/** Selects visible items and performs one storage operation for the whole selection. */
+declare function KeepBulkActions<TMeta = Record<string, unknown>>({ listOptions, selectedIds: controlledSelectedIds, defaultSelectedIds, onSelectedIdsChange, renderItem, onCompleted, ...props }: KeepBulkActionsProps<TMeta>): react.JSX.Element;
 type KeepEmptyStateProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & {
     title?: ReactNode;
     description?: ReactNode;
@@ -124,5 +201,10 @@ type KeepStatusProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTML
 };
 /** Presents provider loading, mutation, synchronization, empty, and error states accessibly. */
 declare function KeepStatus<TMeta = Record<string, unknown>>({ status, labels, children, render, asChild, className, ...rootProps }: KeepStatusProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+type KeepAnnouncementsProps = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    messages?: Partial<Record<"save" | "remove" | "note", string>>;
+};
+/** Announces successful save, remove, and note operations in a polite live region. */
+declare function KeepAnnouncements<TMeta = Record<string, unknown>>({ messages, ...props }: KeepAnnouncementsProps): react.JSX.Element;
 
-export { KeepButton, type KeepButtonLabels, type KeepButtonProps, KeepEmptyState, type KeepEmptyStateProps, KeepItemCard, type KeepItemCardProps, type KeepItemCardState, KeepList, type KeepListProps, type KeepListState, KeepNoteEditor, type KeepNoteEditorProps, type KeepNoteEditorState, KeepStatus, type KeepStatusLabels, type KeepStatusProps, type KeepStatusState, type KeepStatusValue, KeepTagFilter, type KeepTagFilterProps, type KeepTagFilterState, type RenderProp };
+export { KeepAnnouncements, type KeepAnnouncementsProps, KeepBulkActions, type KeepBulkActionsProps, KeepButton, type KeepButtonLabels, type KeepButtonProps, KeepEmptyState, type KeepEmptyStateProps, type KeepImageProps, KeepItemCard, type KeepItemCardProps, type KeepItemCardState, KeepList, type KeepListProps, type KeepListState, KeepNoteEditor, type KeepNoteEditorProps, type KeepNoteEditorState, KeepPagination, type KeepPaginationProps, KeepSearchInput, type KeepSearchInputProps, KeepSortSelect, type KeepSortSelectProps, type KeepSortValue, KeepStatus, type KeepStatusLabels, type KeepStatusProps, type KeepStatusState, type KeepStatusValue, KeepTagEditor, type KeepTagEditorProps, KeepTagFilter, type KeepTagFilterProps, type KeepTagFilterState, type KeepUiLabelContext, type KeepUiLabelKey, type KeepUiLabels, KeepUiProvider, type KeepUiProviderProps, type RenderProp, useKeepUiLabels };

package/dist/index.js

@@ -9,15 +9,69 @@ import {
 } from "@keepkit/core/react";
 import {
   cloneElement,
+  createContext,
   isValidElement,
   useCallback,
+  useContext,
   useEffect,
   useMemo,
+  useRef,
   useState
 } from "react";
 import { KeepProvider, useKeepContext as useKeepContext2, useKeepItem as useKeepItem2, useKeepList as useKeepList2 } from "@keepkit/core/react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var DEFAULT_LABELS = {
+  save: "Save",
+  saved: "Saved",
+  remove: "Remove",
+  loading: "Loading\u2026",
+  saving: "Saving\u2026",
+  syncing: "Syncing\u2026",
+  error: "Something went wrong.",
+  allTags: "All",
+  filterTags: "Filter saved items by tag",
+  note: "Note",
+  saveNote: "Save note",
+  noItems: "No saved items.",
+  loadingItems: "Loading saved items\u2026",
+  errorItems: "Could not load saved items.",
+  search: "Search saved items",
+  sort: "Sort saved items",
+  newest: "Newest first",
+  oldest: "Oldest first",
+  previousPage: "Previous page",
+  nextPage: "Next page",
+  pagination: "Pagination",
+  page: "Page",
+  selectItems: "Select saved items",
+  selectedCount: "selected",
+  deleteSelected: "Delete selected",
+  tagsToApply: "Tags to apply",
+  applyTags: "Apply tags",
+  savedMessage: "Item saved.",
+  removedMessage: "Item removed.",
+  noteSavedMessage: "Note saved."
+};
+var KeepUiLabelsContext = createContext({ labels: DEFAULT_LABELS });
+function KeepUiProvider({ labels, locale, labelResolver, children }) {
+  const value = useMemo(() => {
+    const resolved = { ...DEFAULT_LABELS, ...labels };
+    return { locale, labels: resolved, labelResolver };
+  }, [labelResolver, labels, locale]);
+  return /* @__PURE__ */ jsx(KeepUiLabelsContext.Provider, { value, children });
+}
+function useKeepUiLabels() {
+  return useContext(KeepUiLabelsContext);
+}
+function useUiLabel(key, override) {
+  const context = useKeepUiLabels();
+  return override ?? context.labelResolver?.(key, { locale: context.locale }) ?? context.labels[key];
+}
 function KeepButton({ labels, ...props }) {
+  const saveLabel = useUiLabel("save", typeof labels?.unsaved === "string" ? labels.unsaved : void 0);
+  const savedLabel = useUiLabel("saved", typeof labels?.saved === "string" ? labels.saved : void 0);
+  const loadingLabel = useUiLabel("loading", typeof labels?.loading === "string" ? labels.loading : void 0);
+  const errorLabel = useUiLabel("error", typeof labels?.error === "string" ? labels.error : void 0);
   const buttonState = useKeepItem(props.item.id, {
     meta: props.item.meta,
     targetType: props.item.targetType,
@@ -26,18 +80,18 @@ function KeepButton({ labels, ...props }) {
   });
   const customStateLabel = labels?.loading !== void 0 || labels?.error !== void 0;
   const getStateContent = (state) => {
-    if (state.error && labels?.error !== void 0) return labels.error;
-    if (state.isMutating && labels?.loading !== void 0) return labels.loading;
+    if (state.error) return labels?.error ?? errorLabel;
+    if (state.isMutating) return labels?.loading ?? loadingLabel;
     if (typeof props.children === "function") return props.children(state);
     if (props.children !== void 0) return props.children;
-    return state.isSaved ? labels?.saved ?? "Saved" : labels?.unsaved ?? "Save";
+    return state.isSaved ? labels?.saved ?? savedLabel : labels?.unsaved ?? saveLabel;
   };
   if (props.asChild === true) {
     const sharedProps2 = {
       ...props,
       "aria-busy": props["aria-busy"] ?? (buttonState.isLoading || buttonState.isMutating),
-      savedLabel: labels?.saved ?? props.savedLabel,
-      unsavedLabel: labels?.unsaved ?? props.unsavedLabel,
+      savedLabel: labels?.saved ?? savedLabel,
+      unsavedLabel: labels?.unsaved ?? saveLabel,
       savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,
       unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel
     };
@@ -51,8 +105,8 @@ function KeepButton({ labels, ...props }) {
   const sharedProps = {
     ...props,
     "aria-busy": props["aria-busy"] ?? (buttonState.isLoading || buttonState.isMutating),
-    savedLabel: labels?.saved ?? props.savedLabel,
-    unsavedLabel: labels?.unsaved ?? props.unsavedLabel,
+    savedLabel: labels?.saved ?? savedLabel,
+    unsavedLabel: labels?.unsaved ?? saveLabel,
     savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,
     unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel
   };
@@ -63,11 +117,13 @@ function KeepButton({ labels, ...props }) {
 function KeepItemCard({
   item,
   title,
-  getImageUrl,
+  getImageProps,
+  imageComponent: ImageComponent,
+  renderImage,
   imageAlt,
   render,
   children,
-  removeLabel = "Remove",
+  removeLabel,
   onRemoveError,
   onRemoved,
   showSaveButton = true,
@@ -76,6 +132,8 @@ function KeepItemCard({
   className,
   ...rootProps
 }) {
+  const saveActionLabel = useUiLabel("save");
+  const removeActionLabel = useUiLabel("remove");
   const itemState = useKeepItem(item.id);
   const contentChildren = asChild && isValidElement(children) ? void 0 : children;
   const state = {
@@ -86,7 +144,7 @@ function KeepItemCard({
     remove: itemState.remove
   };
   const resolvedTitle = typeof title === "function" ? title(item) : title ?? getMetaTitle(item.meta) ?? item.id;
-  const imageUrl = getImageUrl?.(item);
+  const imageProps = getImageProps?.(item, resolvedTitle);
   async function handleRemove() {
     try {
       await itemState.remove();
@@ -96,17 +154,17 @@ function KeepItemCard({
     }
   }
   const body = render ? render(state) : typeof contentChildren === "function" ? contentChildren(state) : contentChildren ?? /* @__PURE__ */ jsxs(Fragment, { children: [
-    imageUrl ? /* @__PURE__ */ jsx("img", { src: imageUrl, alt: imageAlt ?? String(resolvedTitle) }) : null,
+    imageProps ? renderImage?.({ ...imageProps, alt: imageAlt ?? imageProps.alt }, item) ?? (ImageComponent ? /* @__PURE__ */ jsx(ImageComponent, { ...imageProps, alt: imageAlt ?? imageProps.alt }) : /* @__PURE__ */ jsx("img", { ...imageProps, alt: imageAlt ?? imageProps.alt })) : null,
     /* @__PURE__ */ jsx("h3", { children: resolvedTitle }),
     showSaveButton ? /* @__PURE__ */ jsx(
       KeepButton,
       {
         item: toKeepButtonItem(item),
         labels: saveButtonLabels,
-        getAriaLabel: (buttonState) => `${buttonState.isSaved ? "Remove" : "Save"} ${String(resolvedTitle)}`
+        getAriaLabel: (buttonState) => `${buttonState.isSaved ? removeActionLabel : saveActionLabel} ${String(resolvedTitle)}`
       }
     ) : null,
-    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void handleRemove(), disabled: itemState.isMutating, children: removeLabel })
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void handleRemove(), disabled: itemState.isMutating, children: removeLabel ?? removeActionLabel })
   ] });
   return renderRoot(
     asChild,
@@ -120,16 +178,26 @@ function KeepList({
   options,
   children,
   renderItem,
-  loading = "Loading saved items\u2026",
-  empty = "No saved items.",
-  error: errorContent = "Could not load saved items.",
+  loading,
+  empty,
+  error: errorContent,
   itemCardProps,
   asChild = false,
   className,
   ...rootProps
 }) {
+  const defaultLoading = useUiLabel("loadingItems");
+  const defaultEmpty = useUiLabel("noItems");
+  const defaultError = useUiLabel("errorItems");
   const state = useKeepList(options);
-  const body = getListBody(state, { children, renderItem, loading, empty, error: errorContent, itemCardProps });
+  const body = getListBody(state, {
+    children,
+    renderItem,
+    loading: loading ?? defaultLoading,
+    empty: empty ?? defaultEmpty,
+    error: errorContent ?? defaultError,
+    itemCardProps
+  });
   const root = asChild && isValidElement(children) ? children : void 0;
   return renderRoot(
     asChild,
@@ -156,8 +224,8 @@ function KeepTagFilter({
   defaultValue,
   onChange,
   onValueChange,
-  allLabel = "All",
-  ariaLabel = "Filter saved items by tag",
+  allLabel,
+  ariaLabel,
   renderTag,
   render,
   children,
@@ -165,6 +233,10 @@ function KeepTagFilter({
   className,
   ...rootProps
 }) {
+  const uiAllLabel = useUiLabel("allTags");
+  const uiAriaLabel = useUiLabel("filterTags");
+  const defaultAllLabel = allLabel ?? uiAllLabel;
+  const defaultAriaLabel = ariaLabel ?? uiAriaLabel;
   const list = useKeepList(listOptions);
   const contentChildren = asChild && isValidElement(children) ? void 0 : children;
   const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);
@@ -182,8 +254,8 @@ function KeepTagFilter({
     [list.tagCounts, list.tags, select, value]
   );
   const body = render ? render(state) : typeof contentChildren === "function" ? contentChildren(state) : contentChildren ?? /* @__PURE__ */ jsxs("fieldset", { children: [
-    /* @__PURE__ */ jsx("legend", { children: ariaLabel }),
-    /* @__PURE__ */ jsx("button", { type: "button", "aria-pressed": value === void 0, onClick: () => select(), children: allLabel }),
+    /* @__PURE__ */ jsx("legend", { children: defaultAriaLabel }),
+    /* @__PURE__ */ jsx("button", { type: "button", "aria-pressed": value === void 0, onClick: () => select(), children: defaultAllLabel }),
     list.tags.map((tag) => /* @__PURE__ */ jsxs("button", { type: "button", "aria-pressed": value === tag, onClick: () => select(tag), children: [
       renderTag ? renderTag(tag, list.tagCounts[tag] ?? 0, value === tag) : tag,
       /* @__PURE__ */ jsxs("span", { children: [
@@ -203,8 +275,8 @@ function KeepTagFilter({
 }
 function KeepNoteEditor({
   item,
-  label = "Note",
-  saveLabel = "Save note",
+  label,
+  saveLabel,
   placeholder,
   onSaved,
   onSaveError,
@@ -214,6 +286,8 @@ function KeepNoteEditor({
   className,
   ...formProps
 }) {
+  const defaultLabel = useUiLabel("note");
+  const defaultSaveLabel = useUiLabel("saveNote");
   const itemState = useKeepItem(item.id);
   const contentChildren = asChild && isValidElement(children) ? void 0 : children;
   const [note, setNote] = useState(item.note ?? "");
@@ -239,7 +313,7 @@ function KeepNoteEditor({
   };
   const body = render ? render(state) : typeof contentChildren === "function" ? contentChildren(state) : contentChildren ?? /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsxs("label", { children: [
-      label,
+      label ?? defaultLabel,
       /* @__PURE__ */ jsx(
         "textarea",
         {
@@ -250,22 +324,256 @@ function KeepNoteEditor({
         }
       )
     ] }),
-    /* @__PURE__ */ jsx("button", { type: "submit", disabled: itemState.isMutating, "aria-busy": itemState.isMutating, children: saveLabel })
+    /* @__PURE__ */ jsx("button", { type: "submit", disabled: itemState.isMutating, "aria-busy": itemState.isMutating, children: saveLabel ?? defaultSaveLabel })
   ] });
   const handleSubmit = (event) => {
     event.preventDefault();
     void save().catch(() => void 0);
   };
+  if (!asChild) {
+    return /* @__PURE__ */ jsx(
+      "form",
+      {
+        ...formProps,
+        className,
+        onSubmit: handleSubmit,
+        "aria-busy": itemState.isMutating || formProps["aria-busy"],
+        children: body
+      }
+    );
+  }
   return renderRoot(
-    asChild,
+    true,
     isValidElement(children) ? children : void 0,
     { ...formProps, className, onSubmit: handleSubmit, "aria-busy": itemState.isMutating || formProps["aria-busy"] },
     body,
     "KeepNoteEditor"
   );
 }
+function KeepSearchInput({
+  value: controlledValue,
+  defaultValue = "",
+  onValueChange,
+  "aria-label": ariaLabel,
+  placeholder,
+  ...props
+}) {
+  const label = useUiLabel("search");
+  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);
+  const value = controlledValue ?? uncontrolledValue;
+  return /* @__PURE__ */ jsx(
+    "input",
+    {
+      ...props,
+      type: "search",
+      value,
+      "aria-label": ariaLabel ?? label,
+      placeholder: placeholder ?? label,
+      onChange: (event) => {
+        const nextValue = event.currentTarget.value;
+        if (controlledValue === void 0) setUncontrolledValue(nextValue);
+        onValueChange?.(nextValue);
+      }
+    }
+  );
+}
+function KeepSortSelect({
+  value: controlledValue,
+  defaultValue = "updatedAt:desc",
+  onValueChange,
+  "aria-label": ariaLabel,
+  children,
+  ...props
+}) {
+  const label = useUiLabel("sort");
+  const newestLabel = useUiLabel("newest");
+  const savedLabel = useUiLabel("saved");
+  const oldestLabel = useUiLabel("oldest");
+  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);
+  const value = controlledValue ?? uncontrolledValue;
+  const options = children ?? /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("option", { value: "updatedAt:desc", children: newestLabel }),
+    /* @__PURE__ */ jsx("option", { value: "savedAt:desc", children: savedLabel }),
+    /* @__PURE__ */ jsx("option", { value: "updatedAt:asc", children: oldestLabel }),
+    /* @__PURE__ */ jsx("option", { value: "savedAt:asc", children: oldestLabel })
+  ] });
+  return /* @__PURE__ */ jsx(
+    "select",
+    {
+      ...props,
+      value,
+      "aria-label": ariaLabel ?? label,
+      onChange: (event) => {
+        const nextValue = event.currentTarget.value;
+        if (controlledValue === void 0) setUncontrolledValue(nextValue);
+        const [by, direction] = nextValue.split(":");
+        onValueChange?.(nextValue, { by, direction });
+      },
+      children: options
+    }
+  );
+}
+function KeepPagination({
+  totalCount,
+  pageSize,
+  page = 1,
+  onPageChange,
+  render,
+  ...props
+}) {
+  const previousPageLabel = useUiLabel("previousPage");
+  const nextPageLabel = useUiLabel("nextPage");
+  const pageLabel = useUiLabel("page");
+  const paginationLabel = useUiLabel("pagination");
+  const pageCount = Math.max(1, Math.ceil(totalCount / Math.max(1, pageSize)));
+  const currentPage = Math.min(Math.max(1, page), pageCount);
+  const goToPage = (nextPage) => {
+    const next = Math.min(Math.max(1, nextPage), pageCount);
+    onPageChange?.(next, (next - 1) * pageSize);
+  };
+  if (render) return /* @__PURE__ */ jsx("nav", { ...props, children: render({ page: currentPage, pageCount, goToPage }) });
+  return /* @__PURE__ */ jsxs("nav", { ...props, "aria-label": props["aria-label"] ?? paginationLabel, children: [
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => goToPage(currentPage - 1), disabled: currentPage <= 1, children: previousPageLabel }),
+    /* @__PURE__ */ jsxs("span", { "aria-current": "page", children: [
+      pageLabel,
+      " ",
+      currentPage,
+      " / ",
+      pageCount
+    ] }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => goToPage(currentPage + 1), disabled: currentPage >= pageCount, children: nextPageLabel })
+  ] });
+}
+function KeepTagEditor({
+  item,
+  availableTags = [],
+  onSaved,
+  onSaveError,
+  render,
+  ...props
+}) {
+  const tagsLabel = useUiLabel("tagsToApply");
+  const removeLabel = useUiLabel("remove");
+  const applyTagsLabel = useUiLabel("applyTags");
+  const itemState = useKeepItem(item.id);
+  const [tags, setTags] = useState(item.tags ?? []);
+  const [input, setInput] = useState("");
+  useEffect(() => setTags(itemState.item?.tags ?? item.tags ?? []), [item.tags, itemState.item?.tags]);
+  const save = useCallback(async () => {
+    const nextTags = normalizeUiTags(tags);
+    try {
+      await itemState.updateTags(nextTags);
+      setTags(nextTags);
+      onSaved?.(nextTags);
+    } catch (error) {
+      onSaveError?.(error);
+      throw error;
+    }
+  }, [itemState, onSaveError, onSaved, tags]);
+  const addTag = (tag) => {
+    const next = normalizeUiTags([...tags, tag]);
+    setTags(next);
+    setInput("");
+  };
+  const body = render ? render({ tags, setTags, save, isSaving: itemState.isMutating }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("label", { children: [
+      tagsLabel,
+      /* @__PURE__ */ jsx(
+        "input",
+        {
+          value: input,
+          list: availableTags.length > 0 ? `keep-tags-${item.id}` : void 0,
+          onChange: (event) => setInput(event.currentTarget.value),
+          onKeyDown: (event) => {
+            if (event.key === "Enter") {
+              event.preventDefault();
+              if (input.trim()) addTag(input);
+            }
+          }
+        }
+      )
+    ] }),
+    availableTags.length > 0 ? /* @__PURE__ */ jsx("datalist", { id: `keep-tags-${item.id}`, children: availableTags.map((tag) => /* @__PURE__ */ jsx("option", { value: tag }, tag)) }) : null,
+    /* @__PURE__ */ jsx("ul", { "aria-label": tagsLabel, children: tags.map((tag) => /* @__PURE__ */ jsxs("li", { children: [
+      tag,
+      /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setTags(tags.filter((current) => current !== tag)), children: removeLabel })
+    ] }, tag)) }),
+    /* @__PURE__ */ jsx("button", { type: "submit", disabled: itemState.isMutating, "aria-busy": itemState.isMutating, children: applyTagsLabel })
+  ] });
+  return /* @__PURE__ */ jsx(
+    "form",
+    {
+      ...props,
+      onSubmit: (event) => {
+        event.preventDefault();
+        void save().catch(() => void 0);
+      },
+      "aria-busy": itemState.isMutating || props["aria-busy"],
+      children: body
+    }
+  );
+}
+function KeepBulkActions({
+  listOptions,
+  selectedIds: controlledSelectedIds,
+  defaultSelectedIds = [],
+  onSelectedIdsChange,
+  renderItem,
+  onCompleted,
+  ...props
+}) {
+  const selectItemsLabel = useUiLabel("selectItems");
+  const selectedCountLabel = useUiLabel("selectedCount");
+  const deleteSelectedLabel = useUiLabel("deleteSelected");
+  const tagsLabel = useUiLabel("tagsToApply");
+  const applyTagsLabel = useUiLabel("applyTags");
+  const list = useKeepList(listOptions);
+  const [uncontrolledSelectedIds, setUncontrolledSelectedIds] = useState(defaultSelectedIds);
+  const selectedIds = controlledSelectedIds ?? uncontrolledSelectedIds;
+  const selected = new Set(selectedIds);
+  const [tagsInput, setTagsInput] = useState("");
+  const setSelectedIds = (ids) => {
+    if (controlledSelectedIds === void 0) setUncontrolledSelectedIds(ids);
+    onSelectedIdsChange?.(ids);
+  };
+  const toggle = (id) => setSelectedIds(selected.has(id) ? selectedIds.filter((current) => current !== id) : [...selectedIds, id]);
+  const allSelected = list.items.length > 0 && list.items.every((item) => selected.has(item.id));
+  const toggleAll = () => setSelectedIds(allSelected ? [] : list.items.map((item) => item.id));
+  const remove = async () => {
+    await list.removeBatch(selectedIds);
+    onCompleted?.("remove", selectedIds);
+    setSelectedIds([]);
+  };
+  const updateTags = async () => {
+    const tags = normalizeUiTags(tagsInput.split(","));
+    await list.updateTagsBatch(selectedIds, tags);
+    onCompleted?.("tags", selectedIds);
+    setSelectedIds([]);
+  };
+  return /* @__PURE__ */ jsxs("section", { ...props, "aria-busy": list.isMutating || props["aria-busy"], children: [
+    /* @__PURE__ */ jsxs("fieldset", { children: [
+      /* @__PURE__ */ jsx("legend", { children: selectItemsLabel }),
+      /* @__PURE__ */ jsxs("label", { children: [
+        /* @__PURE__ */ jsx("input", { type: "checkbox", checked: allSelected, onChange: toggleAll }),
+        selectedIds.length,
+        " ",
+        selectedCountLabel
+      ] }),
+      list.items.map((item) => /* @__PURE__ */ jsxs("label", { children: [
+        /* @__PURE__ */ jsx("input", { type: "checkbox", checked: selected.has(item.id), onChange: () => toggle(item.id) }),
+        renderItem ? renderItem(item, selected.has(item.id)) : getMetaTitle(item.meta) ?? item.id
+      ] }, item.id))
+    ] }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void remove(), disabled: selectedIds.length === 0 || list.isMutating, children: deleteSelectedLabel }),
+    /* @__PURE__ */ jsxs("label", { children: [
+      tagsLabel,
+      /* @__PURE__ */ jsx("input", { value: tagsInput, onChange: (event) => setTagsInput(event.currentTarget.value) })
+    ] }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void updateTags(), disabled: selectedIds.length === 0 || list.isMutating, children: applyTagsLabel })
+  ] });
+}
 function KeepEmptyState({
-  title = "No saved items",
+  title,
   description,
   action,
   children,
@@ -273,9 +581,10 @@ function KeepEmptyState({
   className,
   ...rootProps
 }) {
+  const defaultTitle = useUiLabel("noItems").replace(/\.$/, "");
   const contentChildren = asChild && isValidElement(children) ? void 0 : children;
   const body = contentChildren ?? /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx("h2", { children: title }),
+    /* @__PURE__ */ jsx("h2", { children: title ?? defaultTitle }),
     description ? /* @__PURE__ */ jsx("p", { children: description }) : null,
     action
   ] });
@@ -293,13 +602,14 @@ function KeepStatus({
   const context = useKeepContext();
   const contentChildren = asChild && isValidElement(children) ? void 0 : children;
   const resolvedStatus = status ?? getDerivedStatus(context);
+  const defaultLabel = useUiLabel(getStatusLabelKey(resolvedStatus));
   const state = {
     status: resolvedStatus,
     error: context.error,
     pendingCount: context.syncState.pendingCount,
     items: context.items
   };
-  const body = render ? render(state) : typeof contentChildren === "function" ? contentChildren(state) : contentChildren ?? labels?.[resolvedStatus] ?? getDefaultStatusLabel(resolvedStatus);
+  const body = render ? render(state) : typeof contentChildren === "function" ? contentChildren(state) : contentChildren ?? labels?.[resolvedStatus] ?? defaultLabel;
   const role = rootProps.role ?? (resolvedStatus === "error" ? "alert" : "status");
   return renderRoot(
     asChild,
@@ -309,6 +619,23 @@ function KeepStatus({
     "KeepStatus"
   );
 }
+function KeepAnnouncements({ messages, ...props }) {
+  const context = useKeepContext();
+  const savedMessage = useUiLabel("savedMessage", messages?.save);
+  const removedMessage = useUiLabel("removedMessage", messages?.remove);
+  const noteSavedMessage = useUiLabel("noteSavedMessage", messages?.note);
+  const [message, setMessage] = useState("");
+  const lastChangeRef = useRef(void 0);
+  useEffect(() => {
+    const change = context.lastChange;
+    if (!change || change === lastChangeRef.current) return;
+    lastChangeRef.current = change;
+    if (change.action === "save") setMessage(savedMessage);
+    else if (change.action === "remove" || change.action === "removeBatch") setMessage(removedMessage);
+    else if (change.action === "updateNote") setMessage(noteSavedMessage);
+  }, [context.lastChange, noteSavedMessage, removedMessage, savedMessage]);
+  return /* @__PURE__ */ jsx("div", { ...props, role: props.role ?? "status", "aria-live": props["aria-live"] ?? "polite", "aria-atomic": "true", children: message });
+}
 function getDerivedStatus(context) {
   if (context.error) return "error";
   if (context.syncState.status === "pending" || context.syncState.status === "syncing") return "syncing";
@@ -317,13 +644,13 @@ function getDerivedStatus(context) {
   if (context.isHydrated && context.items.length === 0) return "empty";
   return "idle";
 }
-function getDefaultStatusLabel(status) {
-  if (status === "empty") return "No saved items.";
-  if (status === "loading") return "Loading saved items\u2026";
-  if (status === "saving") return "Saving\u2026";
-  if (status === "syncing") return "Syncing\u2026";
-  if (status === "error") return "Something went wrong.";
-  return "";
+function getStatusLabelKey(status) {
+  if (status === "empty") return "noItems";
+  if (status === "loading") return "loadingItems";
+  if (status === "error") return "error";
+  if (status === "saving") return "saving";
+  if (status === "syncing") return "syncing";
+  return "saved";
 }
 function resolveContent(content, state) {
   return typeof content === "function" ? content(state) : content;
@@ -342,6 +669,9 @@ function getMetaTitle(meta) {
   const title = meta.title;
   return typeof title === "string" && title.trim() ? title.trim() : void 0;
 }
+function normalizeUiTags(tags) {
+  return [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];
+}
 function renderRoot(asChild, child, props, body, componentName) {
   if (asChild) {
     if (!isValidElement(child)) throw new Error(`${componentName} with asChild requires a single React element child.`);
@@ -350,16 +680,24 @@ function renderRoot(asChild, child, props, body, componentName) {
   return /* @__PURE__ */ jsx("div", { ...props, children: body });
 }
 export {
+  KeepAnnouncements,
+  KeepBulkActions,
   KeepButton,
   KeepEmptyState,
   KeepItemCard,
   KeepList,
   KeepNoteEditor,
+  KeepPagination,
   KeepProvider,
+  KeepSearchInput,
+  KeepSortSelect,
   KeepStatus,
+  KeepTagEditor,
   KeepTagFilter,
+  KeepUiProvider,
   useKeepContext2 as useKeepContext,
   useKeepItem2 as useKeepItem,
-  useKeepList2 as useKeepList
+  useKeepList2 as useKeepList,
+  useKeepUiLabels
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["\"use client\";\n\nimport type { KeepItem, KeepItemInput, KeepListOptions, KeepSyncStatus } from \"@keepkit/core/core\";\nimport type { UseKeepListResult } from \"@keepkit/core/react\";\nimport {\n  KeepButton as CoreKeepButton,\n  type KeepButtonProps as CoreKeepButtonProps,\n  type KeepButtonState,\n  useKeepContext,\n  useKeepItem,\n  useKeepList,\n} from \"@keepkit/core/react\";\nimport {\n  cloneElement,\n  type FormHTMLAttributes,\n  type HTMLAttributes,\n  isValidElement,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\n\nexport type { KeepContextValue, KeepProviderProps } from \"@keepkit/core/react\";\nexport { KeepProvider, useKeepContext, useKeepItem, useKeepList } from \"@keepkit/core/react\";\nexport type { KeepItem, KeepItemInput, KeepListOptions, KeepSyncStatus };\n\nexport type RenderProp<TState> = (state: TState) => ReactNode;\n\nexport type KeepButtonLabels = {\n  saved?: ReactNode;\n  unsaved?: ReactNode;\n  loading?: ReactNode;\n  error?: ReactNode;\n  savedAriaLabel?: string;\n  unsavedAriaLabel?: string;\n};\n\nexport type KeepButtonProps<TMeta = Record<string, unknown>> = CoreKeepButtonProps<TMeta> & {\n  labels?: KeepButtonLabels;\n};\n\n/** A style-free save toggle with localized labels and the core button's ARIA/asChild behavior. */\nexport function KeepButton<TMeta = Record<string, unknown>>({ labels, ...props }: KeepButtonProps<TMeta>) {\n  const buttonState = useKeepItem<TMeta>(props.item.id, {\n    meta: props.item.meta,\n    targetType: props.item.targetType,\n    note: props.item.note,\n    tags: props.item.tags,\n  });\n  const customStateLabel = labels?.loading !== undefined || labels?.error !== undefined;\n  const getStateContent = (state: KeepButtonState<TMeta>): ReactNode => {\n    if (state.error && labels?.error !== undefined) return labels.error;\n    if (state.isMutating && labels?.loading !== undefined) return labels.loading;\n    if (typeof props.children === \"function\") return props.children(state);\n    if (props.children !== undefined) return props.children;\n    return state.isSaved ? (labels?.saved ?? \"Saved\") : (labels?.unsaved ?? \"Save\");\n  };\n  if (props.asChild === true) {\n    const sharedProps = {\n      ...props,\n      \"aria-busy\": props[\"aria-busy\"] ?? (buttonState.isLoading || buttonState.isMutating),\n      savedLabel: labels?.saved ?? props.savedLabel,\n      unsavedLabel: labels?.unsaved ?? props.unsavedLabel,\n      savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,\n      unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel,\n    };\n    if (!customStateLabel) return <CoreKeepButton<TMeta> {...sharedProps} />;\n    const statefulProps = {\n      ...sharedProps,\n      children: (state: KeepButtonState<TMeta>) => <>{getStateContent(state)}</>,\n    };\n    return <CoreKeepButton<TMeta> {...statefulProps} />;\n  }\n  const sharedProps = {\n    ...props,\n    \"aria-busy\": props[\"aria-busy\"] ?? (buttonState.isLoading || buttonState.isMutating),\n    savedLabel: labels?.saved ?? props.savedLabel,\n    unsavedLabel: labels?.unsaved ?? props.unsavedLabel,\n    savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,\n    unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel,\n  };\n  if (!customStateLabel) return <CoreKeepButton<TMeta> {...sharedProps} />;\n  const statefulProps = { ...sharedProps, children: (state: KeepButtonState<TMeta>) => getStateContent(state) };\n  return <CoreKeepButton<TMeta> {...statefulProps} />;\n}\n\nexport type KeepItemCardState<TMeta = Record<string, unknown>> = {\n  item: KeepItem<TMeta>;\n  isSaved: boolean;\n  isMutating: boolean;\n  error: unknown | null;\n  remove: () => Promise<void>;\n};\n\nexport type KeepItemCardProps<TMeta = Record<string, unknown>> = Omit<\n  HTMLAttributes<HTMLElement>,\n  \"children\" | \"title\"\n> & {\n  item: KeepItem<TMeta>;\n  title?: ReactNode | ((item: KeepItem<TMeta>) => ReactNode);\n  getImageUrl?: (item: KeepItem<TMeta>) => string | undefined;\n  imageAlt?: string;\n  render?: RenderProp<KeepItemCardState<TMeta>>;\n  children?: ReactNode | RenderProp<KeepItemCardState<TMeta>>;\n  removeLabel?: string;\n  onRemoveError?: (error: unknown) => void;\n  onRemoved?: (item: KeepItem<TMeta>) => void;\n  showSaveButton?: boolean;\n  saveButtonLabels?: KeepButtonLabels;\n  asChild?: boolean;\n};\n\n/** A low-dependency item presentation primitive. The default markup can be replaced with render props. */\nexport function KeepItemCard<TMeta = Record<string, unknown>>({\n  item,\n  title,\n  getImageUrl,\n  imageAlt,\n  render,\n  children,\n  removeLabel = \"Remove\",\n  onRemoveError,\n  onRemoved,\n  showSaveButton = true,\n  saveButtonLabels,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepItemCardProps<TMeta>) {\n  const itemState = useKeepItem<TMeta>(item.id);\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const state: KeepItemCardState<TMeta> = {\n    item,\n    isSaved: itemState.isSaved,\n    isMutating: itemState.isMutating,\n    error: itemState.error,\n    remove: itemState.remove,\n  };\n  const resolvedTitle = typeof title === \"function\" ? title(item) : (title ?? getMetaTitle(item.meta) ?? item.id);\n  const imageUrl = getImageUrl?.(item);\n\n  async function handleRemove() {\n    try {\n      await itemState.remove();\n      onRemoved?.(item);\n    } catch (error) {\n      onRemoveError?.(error);\n    }\n  }\n\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? (\n          <>\n            {imageUrl ? <img src={imageUrl} alt={imageAlt ?? String(resolvedTitle)} /> : null}\n            <h3>{resolvedTitle}</h3>\n            {showSaveButton ? (\n              <KeepButton\n                item={toKeepButtonItem(item)}\n                labels={saveButtonLabels}\n                getAriaLabel={(buttonState) => `${buttonState.isSaved ? \"Remove\" : \"Save\"} ${String(resolvedTitle)}`}\n              />\n            ) : null}\n            <button type=\"button\" onClick={() => void handleRemove()} disabled={itemState.isMutating}>\n              {removeLabel}\n            </button>\n          </>\n        ));\n\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...rootProps, className, \"aria-busy\": itemState.isMutating || rootProps[\"aria-busy\"] },\n    body,\n    \"KeepItemCard\",\n  );\n}\n\nexport type KeepListState<TMeta = Record<string, unknown>> = UseKeepListResult<TMeta>;\n\nexport type KeepListProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  options?: KeepListOptions<TMeta>;\n  children?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  renderItem?: (item: KeepItem<TMeta>, state: KeepListState<TMeta>) => ReactNode;\n  loading?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  empty?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  error?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  itemCardProps?: Omit<KeepItemCardProps<TMeta>, \"item\" | \"children\" | \"render\">;\n  asChild?: boolean;\n};\n\n/** A list primitive with built-in loading, empty, error, and removal states. */\nexport function KeepList<TMeta = Record<string, unknown>>({\n  options,\n  children,\n  renderItem,\n  loading = \"Loading saved items…\",\n  empty = \"No saved items.\",\n  error: errorContent = \"Could not load saved items.\",\n  itemCardProps,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepListProps<TMeta>) {\n  const state = useKeepList<TMeta>(options);\n  const body = getListBody(state, { children, renderItem, loading, empty, error: errorContent, itemCardProps });\n  const root = asChild && isValidElement(children) ? children : undefined;\n  return renderRoot(\n    asChild,\n    root,\n    { ...rootProps, className, \"aria-busy\": state.isLoading || rootProps[\"aria-busy\"] },\n    body,\n    \"KeepList\",\n  );\n}\n\nfunction getListBody<TMeta>(\n  state: KeepListState<TMeta>,\n  options: {\n    children?: ReactNode | RenderProp<KeepListState<TMeta>>;\n    renderItem?: (item: KeepItem<TMeta>, state: KeepListState<TMeta>) => ReactNode;\n    loading: ReactNode | RenderProp<KeepListState<TMeta>>;\n    empty: ReactNode | RenderProp<KeepListState<TMeta>>;\n    error: ReactNode | RenderProp<KeepListState<TMeta>>;\n    itemCardProps?: Omit<KeepItemCardProps<TMeta>, \"item\" | \"children\" | \"render\">;\n  },\n): ReactNode {\n  if (state.error && state.items.length === 0) return resolveContent(options.error, state);\n  if (state.isLoading && !state.isHydrated) return resolveContent(options.loading, state);\n  if (state.isHydrated && state.items.length === 0) return resolveContent(options.empty, state);\n  if (typeof options.children === \"function\") return options.children(state);\n  if (options.children !== undefined && !isValidElement(options.children)) return options.children;\n  const items = state.items.map((item) =>\n    options.renderItem ? (\n      options.renderItem(item, state)\n    ) : (\n      <li key={item.id}>\n        <KeepItemCard item={item} {...options.itemCardProps} />\n      </li>\n    ),\n  );\n  return <ul>{items}</ul>;\n}\n\nexport type KeepTagFilterState = {\n  tags: string[];\n  tagCounts: Record<string, number>;\n  value?: string;\n  select: (tag?: string) => void;\n};\n\nexport type KeepTagFilterProps<TMeta = Record<string, unknown>> = Omit<\n  HTMLAttributes<HTMLElement>,\n  \"children\" | \"onChange\"\n> & {\n  listOptions?: KeepListOptions<TMeta>;\n  value?: string;\n  defaultValue?: string;\n  onChange?: (tag?: string) => void;\n  onValueChange?: (tag?: string) => void;\n  allLabel?: ReactNode;\n  ariaLabel?: string;\n  renderTag?: (tag: string, count: number, selected: boolean) => ReactNode;\n  render?: RenderProp<KeepTagFilterState>;\n  children?: ReactNode | RenderProp<KeepTagFilterState>;\n  asChild?: boolean;\n};\n\n/** An ARIA button group for tag filtering; consumers can connect value to KeepList options. */\nexport function KeepTagFilter<TMeta = Record<string, unknown>>({\n  listOptions,\n  value: controlledValue,\n  defaultValue,\n  onChange,\n  onValueChange,\n  allLabel = \"All\",\n  ariaLabel = \"Filter saved items by tag\",\n  renderTag,\n  render,\n  children,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepTagFilterProps<TMeta>) {\n  const list = useKeepList<TMeta>(listOptions);\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);\n  const value = controlledValue ?? uncontrolledValue;\n  const select = useCallback(\n    (tag?: string) => {\n      if (controlledValue === undefined) setUncontrolledValue(tag);\n      onChange?.(tag);\n      onValueChange?.(tag);\n    },\n    [controlledValue, onChange, onValueChange],\n  );\n  const state = useMemo<KeepTagFilterState>(\n    () => ({ tags: list.tags, tagCounts: list.tagCounts, value, select }),\n    [list.tagCounts, list.tags, select, value],\n  );\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? (\n          <fieldset>\n            <legend>{ariaLabel}</legend>\n            <button type=\"button\" aria-pressed={value === undefined} onClick={() => select()}>\n              {allLabel}\n            </button>\n            {list.tags.map((tag) => (\n              <button key={tag} type=\"button\" aria-pressed={value === tag} onClick={() => select(tag)}>\n                {renderTag ? renderTag(tag, list.tagCounts[tag] ?? 0, value === tag) : tag}\n                <span> ({list.tagCounts[tag] ?? 0})</span>\n              </button>\n            ))}\n          </fieldset>\n        ));\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...rootProps, className },\n    body,\n    \"KeepTagFilter\",\n  );\n}\n\nexport type KeepNoteEditorState<TMeta = Record<string, unknown>> = {\n  item: KeepItem<TMeta>;\n  note: string;\n  setNote: (note: string) => void;\n  isDirty: boolean;\n  isSaving: boolean;\n  error: unknown | null;\n  save: () => Promise<void>;\n};\n\nexport type KeepNoteEditorProps<TMeta = Record<string, unknown>> = Omit<\n  FormHTMLAttributes<HTMLFormElement>,\n  \"children\" | \"onSubmit\"\n> & {\n  item: KeepItem<TMeta>;\n  label?: ReactNode;\n  saveLabel?: ReactNode;\n  placeholder?: string;\n  onSaved?: (note?: string) => void;\n  onSaveError?: (error: unknown) => void;\n  render?: RenderProp<KeepNoteEditorState<TMeta>>;\n  children?: ReactNode | RenderProp<KeepNoteEditorState<TMeta>>;\n  asChild?: boolean;\n};\n\n/** A controlled-by-default note editor that persists through useKeepItem. */\nexport function KeepNoteEditor<TMeta = Record<string, unknown>>({\n  item,\n  label = \"Note\",\n  saveLabel = \"Save note\",\n  placeholder,\n  onSaved,\n  onSaveError,\n  render,\n  children,\n  asChild = false,\n  className,\n  ...formProps\n}: KeepNoteEditorProps<TMeta>) {\n  const itemState = useKeepItem<TMeta>(item.id);\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const [note, setNote] = useState(item.note ?? \"\");\n  useEffect(() => setNote(itemState.item?.note ?? item.note ?? \"\"), [item.note, itemState.item?.note]);\n  const save = useCallback(async () => {\n    const nextNote = note.trim() || undefined;\n    try {\n      await itemState.updateNote(nextNote);\n      onSaved?.(nextNote);\n    } catch (error) {\n      onSaveError?.(error);\n      throw error;\n    }\n  }, [itemState, note, onSaveError, onSaved]);\n  const state: KeepNoteEditorState<TMeta> = {\n    item,\n    note,\n    setNote,\n    isDirty: note !== (itemState.item?.note ?? item.note ?? \"\"),\n    isSaving: itemState.isMutating,\n    error: itemState.error,\n    save,\n  };\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? (\n          <>\n            <label>\n              {label}\n              <textarea\n                value={note}\n                onChange={(event) => setNote(event.currentTarget.value)}\n                placeholder={placeholder}\n                disabled={itemState.isMutating}\n              />\n            </label>\n            <button type=\"submit\" disabled={itemState.isMutating} aria-busy={itemState.isMutating}>\n              {saveLabel}\n            </button>\n          </>\n        ));\n  const handleSubmit: FormHTMLAttributes<HTMLFormElement>[\"onSubmit\"] = (event) => {\n    event.preventDefault();\n    void save().catch(() => undefined);\n  };\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...formProps, className, onSubmit: handleSubmit, \"aria-busy\": itemState.isMutating || formProps[\"aria-busy\"] },\n    body,\n    \"KeepNoteEditor\",\n  );\n}\n\nexport type KeepEmptyStateProps = Omit<HTMLAttributes<HTMLElement>, \"children\" | \"title\"> & {\n  title?: ReactNode;\n  description?: ReactNode;\n  action?: ReactNode;\n  children?: ReactNode;\n  asChild?: boolean;\n};\n\n/** A style-free, reusable empty collection state. */\nexport function KeepEmptyState({\n  title = \"No saved items\",\n  description,\n  action,\n  children,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepEmptyStateProps) {\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const body = contentChildren ?? (\n    <>\n      <h2>{title}</h2>\n      {description ? <p>{description}</p> : null}\n      {action}\n    </>\n  );\n  return renderRoot(asChild, children, { ...rootProps, className }, body, \"KeepEmptyState\");\n}\n\nexport type KeepStatusValue = \"idle\" | \"empty\" | \"loading\" | \"saving\" | \"syncing\" | \"error\";\n\nexport type KeepStatusLabels = Partial<Record<KeepStatusValue, ReactNode>>;\n\nexport type KeepStatusState<TMeta = Record<string, unknown>> = {\n  status: KeepStatusValue;\n  error: unknown | null;\n  pendingCount: number;\n  items: KeepItem<TMeta>[];\n};\n\nexport type KeepStatusProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  status?: KeepStatusValue;\n  labels?: KeepStatusLabels;\n  children?: ReactNode | RenderProp<KeepStatusState<TMeta>>;\n  render?: RenderProp<KeepStatusState<TMeta>>;\n  asChild?: boolean;\n};\n\n/** Presents provider loading, mutation, synchronization, empty, and error states accessibly. */\nexport function KeepStatus<TMeta = Record<string, unknown>>({\n  status,\n  labels,\n  children,\n  render,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepStatusProps<TMeta>) {\n  const context = useKeepContext<TMeta>();\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const resolvedStatus = status ?? getDerivedStatus(context);\n  const state: KeepStatusState<TMeta> = {\n    status: resolvedStatus,\n    error: context.error,\n    pendingCount: context.syncState.pendingCount,\n    items: context.items,\n  };\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? labels?.[resolvedStatus] ?? getDefaultStatusLabel(resolvedStatus));\n  const role = rootProps.role ?? (resolvedStatus === \"error\" ? \"alert\" : \"status\");\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...rootProps, className, role, \"aria-live\": rootProps[\"aria-live\"] ?? \"polite\" },\n    body,\n    \"KeepStatus\",\n  );\n}\n\nfunction getDerivedStatus<TMeta>(context: ReturnType<typeof useKeepContext<TMeta>>): KeepStatusValue {\n  if (context.error) return \"error\";\n  if (context.syncState.status === \"pending\" || context.syncState.status === \"syncing\") return \"syncing\";\n  if (context.isMutating) return \"saving\";\n  if (context.isLoading && !context.isHydrated) return \"loading\";\n  if (context.isHydrated && context.items.length === 0) return \"empty\";\n  return \"idle\";\n}\n\nfunction getDefaultStatusLabel(status: KeepStatusValue): string {\n  if (status === \"empty\") return \"No saved items.\";\n  if (status === \"loading\") return \"Loading saved items…\";\n  if (status === \"saving\") return \"Saving…\";\n  if (status === \"syncing\") return \"Syncing…\";\n  if (status === \"error\") return \"Something went wrong.\";\n  return \"\";\n}\n\nfunction resolveContent<TState>(content: ReactNode | RenderProp<TState>, state: TState): ReactNode {\n  return typeof content === \"function\" ? content(state) : content;\n}\n\nfunction toKeepButtonItem<TMeta>(item: KeepItem<TMeta>): KeepItemInput<TMeta> & { id: string } {\n  return {\n    id: item.id,\n    meta: item.meta,\n    targetType: item.targetType,\n    note: item.note,\n    tags: item.tags,\n  };\n}\n\nfunction getMetaTitle<TMeta>(meta: TMeta): string | undefined {\n  if (typeof meta !== \"object\" || meta === null || !(\"title\" in meta)) return undefined;\n  const title = (meta as { title?: unknown }).title;\n  return typeof title === \"string\" && title.trim() ? title.trim() : undefined;\n}\n\nfunction renderRoot(\n  asChild: boolean,\n  child: ReactNode,\n  props: HTMLAttributes<HTMLElement> & Record<string, unknown>,\n  body: ReactNode,\n  componentName: string,\n): ReactElement {\n  if (asChild) {\n    if (!isValidElement(child)) throw new Error(`${componentName} with asChild requires a single React element child.`);\n    return cloneElement(child as ReactElement<Record<string, unknown>>, { ...props, children: body });\n  }\n  return <div {...props}>{body}</div>;\n}\n"],"mappings":"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","names":["useKeepContext","useKeepItem","useKeepList","sharedProps","statefulProps"]}
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["\"use client\";\n\nimport type { KeepChangeContext, KeepItem, KeepItemInput, KeepListOptions, KeepSyncStatus } from \"@keepkit/core/core\";\nimport type { UseKeepListResult } from \"@keepkit/core/react\";\nimport {\n  KeepButton as CoreKeepButton,\n  type KeepButtonProps as CoreKeepButtonProps,\n  type KeepButtonState,\n  useKeepContext,\n  useKeepItem,\n  useKeepList,\n} from \"@keepkit/core/react\";\nimport {\n  type ComponentType,\n  cloneElement,\n  createContext,\n  type FormHTMLAttributes,\n  type HTMLAttributes,\n  type ImgHTMLAttributes,\n  type InputHTMLAttributes,\n  isValidElement,\n  type ReactElement,\n  type ReactNode,\n  type SelectHTMLAttributes,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\n\nexport type KeepUiLabelKey =\n  | \"save\"\n  | \"saved\"\n  | \"remove\"\n  | \"loading\"\n  | \"saving\"\n  | \"syncing\"\n  | \"error\"\n  | \"allTags\"\n  | \"filterTags\"\n  | \"note\"\n  | \"saveNote\"\n  | \"noItems\"\n  | \"loadingItems\"\n  | \"errorItems\"\n  | \"search\"\n  | \"sort\"\n  | \"newest\"\n  | \"oldest\"\n  | \"previousPage\"\n  | \"nextPage\"\n  | \"pagination\"\n  | \"page\"\n  | \"selectItems\"\n  | \"selectedCount\"\n  | \"deleteSelected\"\n  | \"tagsToApply\"\n  | \"applyTags\"\n  | \"savedMessage\"\n  | \"removedMessage\"\n  | \"noteSavedMessage\";\n\nexport type KeepUiLabels = Partial<Record<KeepUiLabelKey, string>>;\n\nexport type KeepUiLabelContext = {\n  locale?: string;\n  labels: Readonly<Record<KeepUiLabelKey, string>>;\n  labelResolver?: (key: KeepUiLabelKey, context: { locale?: string }) => string | undefined;\n};\n\nconst DEFAULT_LABELS: Record<KeepUiLabelKey, string> = {\n  save: \"Save\",\n  saved: \"Saved\",\n  remove: \"Remove\",\n  loading: \"Loading…\",\n  saving: \"Saving…\",\n  syncing: \"Syncing…\",\n  error: \"Something went wrong.\",\n  allTags: \"All\",\n  filterTags: \"Filter saved items by tag\",\n  note: \"Note\",\n  saveNote: \"Save note\",\n  noItems: \"No saved items.\",\n  loadingItems: \"Loading saved items…\",\n  errorItems: \"Could not load saved items.\",\n  search: \"Search saved items\",\n  sort: \"Sort saved items\",\n  newest: \"Newest first\",\n  oldest: \"Oldest first\",\n  previousPage: \"Previous page\",\n  nextPage: \"Next page\",\n  pagination: \"Pagination\",\n  page: \"Page\",\n  selectItems: \"Select saved items\",\n  selectedCount: \"selected\",\n  deleteSelected: \"Delete selected\",\n  tagsToApply: \"Tags to apply\",\n  applyTags: \"Apply tags\",\n  savedMessage: \"Item saved.\",\n  removedMessage: \"Item removed.\",\n  noteSavedMessage: \"Note saved.\",\n};\n\nconst KeepUiLabelsContext = createContext<KeepUiLabelContext>({ labels: DEFAULT_LABELS });\n\nexport type KeepUiProviderProps = {\n  labels?: KeepUiLabels;\n  locale?: string;\n  labelResolver?: KeepUiLabelContext[\"labelResolver\"];\n  children?: ReactNode;\n};\n\n/** Provides one locale-aware label source to every UI primitive. */\nexport function KeepUiProvider({ labels, locale, labelResolver, children }: KeepUiProviderProps) {\n  const value = useMemo<KeepUiLabelContext>(() => {\n    const resolved = { ...DEFAULT_LABELS, ...labels };\n    return { locale, labels: resolved, labelResolver };\n  }, [labelResolver, labels, locale]);\n  return <KeepUiLabelsContext.Provider value={value}>{children}</KeepUiLabelsContext.Provider>;\n}\n\nexport function useKeepUiLabels(): KeepUiLabelContext {\n  return useContext(KeepUiLabelsContext);\n}\n\nfunction useUiLabel(key: KeepUiLabelKey, override?: string): string {\n  const context = useKeepUiLabels();\n  return override ?? context.labelResolver?.(key, { locale: context.locale }) ?? context.labels[key];\n}\n\nexport type { KeepContextValue, KeepProviderProps } from \"@keepkit/core/react\";\nexport { KeepProvider, useKeepContext, useKeepItem, useKeepList } from \"@keepkit/core/react\";\nexport type { KeepItem, KeepItemInput, KeepListOptions, KeepSyncStatus };\n\nexport type RenderProp<TState> = (state: TState) => ReactNode;\n\nexport type KeepButtonLabels = {\n  saved?: ReactNode;\n  unsaved?: ReactNode;\n  loading?: ReactNode;\n  error?: ReactNode;\n  savedAriaLabel?: string;\n  unsavedAriaLabel?: string;\n};\n\nexport type KeepButtonProps<TMeta = Record<string, unknown>> = CoreKeepButtonProps<TMeta> & {\n  labels?: KeepButtonLabels;\n};\n\n/** A style-free save toggle with localized labels and the core button's ARIA/asChild behavior. */\nexport function KeepButton<TMeta = Record<string, unknown>>({ labels, ...props }: KeepButtonProps<TMeta>) {\n  const saveLabel = useUiLabel(\"save\", typeof labels?.unsaved === \"string\" ? labels.unsaved : undefined);\n  const savedLabel = useUiLabel(\"saved\", typeof labels?.saved === \"string\" ? labels.saved : undefined);\n  const loadingLabel = useUiLabel(\"loading\", typeof labels?.loading === \"string\" ? labels.loading : undefined);\n  const errorLabel = useUiLabel(\"error\", typeof labels?.error === \"string\" ? labels.error : undefined);\n  const buttonState = useKeepItem<TMeta>(props.item.id, {\n    meta: props.item.meta,\n    targetType: props.item.targetType,\n    note: props.item.note,\n    tags: props.item.tags,\n  });\n  const customStateLabel = labels?.loading !== undefined || labels?.error !== undefined;\n  const getStateContent = (state: KeepButtonState<TMeta>): ReactNode => {\n    if (state.error) return labels?.error ?? errorLabel;\n    if (state.isMutating) return labels?.loading ?? loadingLabel;\n    if (typeof props.children === \"function\") return props.children(state);\n    if (props.children !== undefined) return props.children;\n    return state.isSaved ? (labels?.saved ?? savedLabel) : (labels?.unsaved ?? saveLabel);\n  };\n  if (props.asChild === true) {\n    const sharedProps = {\n      ...props,\n      \"aria-busy\": props[\"aria-busy\"] ?? (buttonState.isLoading || buttonState.isMutating),\n      savedLabel: labels?.saved ?? savedLabel,\n      unsavedLabel: labels?.unsaved ?? saveLabel,\n      savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,\n      unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel,\n    };\n    if (!customStateLabel) return <CoreKeepButton<TMeta> {...sharedProps} />;\n    const statefulProps = {\n      ...sharedProps,\n      children: (state: KeepButtonState<TMeta>) => <>{getStateContent(state)}</>,\n    };\n    return <CoreKeepButton<TMeta> {...statefulProps} />;\n  }\n  const sharedProps = {\n    ...props,\n    \"aria-busy\": props[\"aria-busy\"] ?? (buttonState.isLoading || buttonState.isMutating),\n    savedLabel: labels?.saved ?? savedLabel,\n    unsavedLabel: labels?.unsaved ?? saveLabel,\n    savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,\n    unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel,\n  };\n  if (!customStateLabel) return <CoreKeepButton<TMeta> {...sharedProps} />;\n  const statefulProps = { ...sharedProps, children: (state: KeepButtonState<TMeta>) => getStateContent(state) };\n  return <CoreKeepButton<TMeta> {...statefulProps} />;\n}\n\nexport type KeepItemCardState<TMeta = Record<string, unknown>> = {\n  item: KeepItem<TMeta>;\n  isSaved: boolean;\n  isMutating: boolean;\n  error: unknown | null;\n  remove: () => Promise<void>;\n};\n\nexport type KeepImageProps = ImgHTMLAttributes<HTMLImageElement> & {\n  src: string;\n  alt: string;\n};\n\nexport type KeepItemCardProps<TMeta = Record<string, unknown>> = Omit<\n  HTMLAttributes<HTMLElement>,\n  \"children\" | \"title\"\n> & {\n  item: KeepItem<TMeta>;\n  title?: ReactNode | ((item: KeepItem<TMeta>) => ReactNode);\n  getImageProps?: (item: KeepItem<TMeta>, title: ReactNode) => KeepImageProps | undefined;\n  imageComponent?: ComponentType<KeepImageProps>;\n  renderImage?: (props: KeepImageProps, item: KeepItem<TMeta>) => ReactNode;\n  imageAlt?: string;\n  render?: RenderProp<KeepItemCardState<TMeta>>;\n  children?: ReactNode | RenderProp<KeepItemCardState<TMeta>>;\n  removeLabel?: string;\n  onRemoveError?: (error: unknown) => void;\n  onRemoved?: (item: KeepItem<TMeta>) => void;\n  showSaveButton?: boolean;\n  saveButtonLabels?: KeepButtonLabels;\n  asChild?: boolean;\n};\n\n/** A low-dependency item presentation primitive. The default markup can be replaced with render props. */\nexport function KeepItemCard<TMeta = Record<string, unknown>>({\n  item,\n  title,\n  getImageProps,\n  imageComponent: ImageComponent,\n  renderImage,\n  imageAlt,\n  render,\n  children,\n  removeLabel,\n  onRemoveError,\n  onRemoved,\n  showSaveButton = true,\n  saveButtonLabels,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepItemCardProps<TMeta>) {\n  const saveActionLabel = useUiLabel(\"save\");\n  const removeActionLabel = useUiLabel(\"remove\");\n  const itemState = useKeepItem<TMeta>(item.id);\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const state: KeepItemCardState<TMeta> = {\n    item,\n    isSaved: itemState.isSaved,\n    isMutating: itemState.isMutating,\n    error: itemState.error,\n    remove: itemState.remove,\n  };\n  const resolvedTitle = typeof title === \"function\" ? title(item) : (title ?? getMetaTitle(item.meta) ?? item.id);\n  const imageProps = getImageProps?.(item, resolvedTitle);\n\n  async function handleRemove() {\n    try {\n      await itemState.remove();\n      onRemoved?.(item);\n    } catch (error) {\n      onRemoveError?.(error);\n    }\n  }\n\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? (\n          <>\n            {imageProps\n              ? (renderImage?.({ ...imageProps, alt: imageAlt ?? imageProps.alt }, item) ??\n                (ImageComponent ? (\n                  <ImageComponent {...imageProps} alt={imageAlt ?? imageProps.alt} />\n                ) : (\n                  <img {...imageProps} alt={imageAlt ?? imageProps.alt} />\n                )))\n              : null}\n            <h3>{resolvedTitle}</h3>\n            {showSaveButton ? (\n              <KeepButton\n                item={toKeepButtonItem(item)}\n                labels={saveButtonLabels}\n                getAriaLabel={(buttonState) =>\n                  `${buttonState.isSaved ? removeActionLabel : saveActionLabel} ${String(resolvedTitle)}`\n                }\n              />\n            ) : null}\n            <button type=\"button\" onClick={() => void handleRemove()} disabled={itemState.isMutating}>\n              {removeLabel ?? removeActionLabel}\n            </button>\n          </>\n        ));\n\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...rootProps, className, \"aria-busy\": itemState.isMutating || rootProps[\"aria-busy\"] },\n    body,\n    \"KeepItemCard\",\n  );\n}\n\nexport type KeepListState<TMeta = Record<string, unknown>> = UseKeepListResult<TMeta>;\n\nexport type KeepListProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  options?: KeepListOptions<TMeta>;\n  children?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  renderItem?: (item: KeepItem<TMeta>, state: KeepListState<TMeta>) => ReactNode;\n  loading?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  empty?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  error?: ReactNode | RenderProp<KeepListState<TMeta>>;\n  itemCardProps?: Omit<KeepItemCardProps<TMeta>, \"item\" | \"children\" | \"render\">;\n  asChild?: boolean;\n};\n\n/** A list primitive with built-in loading, empty, error, and removal states. */\nexport function KeepList<TMeta = Record<string, unknown>>({\n  options,\n  children,\n  renderItem,\n  loading,\n  empty,\n  error: errorContent,\n  itemCardProps,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepListProps<TMeta>) {\n  const defaultLoading = useUiLabel(\"loadingItems\");\n  const defaultEmpty = useUiLabel(\"noItems\");\n  const defaultError = useUiLabel(\"errorItems\");\n  const state = useKeepList<TMeta>(options);\n  const body = getListBody(state, {\n    children,\n    renderItem,\n    loading: loading ?? defaultLoading,\n    empty: empty ?? defaultEmpty,\n    error: errorContent ?? defaultError,\n    itemCardProps,\n  });\n  const root = asChild && isValidElement(children) ? children : undefined;\n  return renderRoot(\n    asChild,\n    root,\n    { ...rootProps, className, \"aria-busy\": state.isLoading || rootProps[\"aria-busy\"] },\n    body,\n    \"KeepList\",\n  );\n}\n\nfunction getListBody<TMeta>(\n  state: KeepListState<TMeta>,\n  options: {\n    children?: ReactNode | RenderProp<KeepListState<TMeta>>;\n    renderItem?: (item: KeepItem<TMeta>, state: KeepListState<TMeta>) => ReactNode;\n    loading: ReactNode | RenderProp<KeepListState<TMeta>>;\n    empty: ReactNode | RenderProp<KeepListState<TMeta>>;\n    error: ReactNode | RenderProp<KeepListState<TMeta>>;\n    itemCardProps?: Omit<KeepItemCardProps<TMeta>, \"item\" | \"children\" | \"render\">;\n  },\n): ReactNode {\n  if (state.error && state.items.length === 0) return resolveContent(options.error, state);\n  if (state.isLoading && !state.isHydrated) return resolveContent(options.loading, state);\n  if (state.isHydrated && state.items.length === 0) return resolveContent(options.empty, state);\n  if (typeof options.children === \"function\") return options.children(state);\n  if (options.children !== undefined && !isValidElement(options.children)) return options.children;\n  const items = state.items.map((item) =>\n    options.renderItem ? (\n      options.renderItem(item, state)\n    ) : (\n      <li key={item.id}>\n        <KeepItemCard item={item} {...options.itemCardProps} />\n      </li>\n    ),\n  );\n  return <ul>{items}</ul>;\n}\n\nexport type KeepTagFilterState = {\n  tags: string[];\n  tagCounts: Record<string, number>;\n  value?: string;\n  select: (tag?: string) => void;\n};\n\nexport type KeepTagFilterProps<TMeta = Record<string, unknown>> = Omit<\n  HTMLAttributes<HTMLElement>,\n  \"children\" | \"onChange\"\n> & {\n  listOptions?: KeepListOptions<TMeta>;\n  value?: string;\n  defaultValue?: string;\n  onChange?: (tag?: string) => void;\n  onValueChange?: (tag?: string) => void;\n  allLabel?: ReactNode;\n  ariaLabel?: string;\n  renderTag?: (tag: string, count: number, selected: boolean) => ReactNode;\n  render?: RenderProp<KeepTagFilterState>;\n  children?: ReactNode | RenderProp<KeepTagFilterState>;\n  asChild?: boolean;\n};\n\n/** An ARIA button group for tag filtering; consumers can connect value to KeepList options. */\nexport function KeepTagFilter<TMeta = Record<string, unknown>>({\n  listOptions,\n  value: controlledValue,\n  defaultValue,\n  onChange,\n  onValueChange,\n  allLabel,\n  ariaLabel,\n  renderTag,\n  render,\n  children,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepTagFilterProps<TMeta>) {\n  const uiAllLabel = useUiLabel(\"allTags\");\n  const uiAriaLabel = useUiLabel(\"filterTags\");\n  const defaultAllLabel = allLabel ?? uiAllLabel;\n  const defaultAriaLabel = ariaLabel ?? uiAriaLabel;\n  const list = useKeepList<TMeta>(listOptions);\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);\n  const value = controlledValue ?? uncontrolledValue;\n  const select = useCallback(\n    (tag?: string) => {\n      if (controlledValue === undefined) setUncontrolledValue(tag);\n      onChange?.(tag);\n      onValueChange?.(tag);\n    },\n    [controlledValue, onChange, onValueChange],\n  );\n  const state = useMemo<KeepTagFilterState>(\n    () => ({ tags: list.tags, tagCounts: list.tagCounts, value, select }),\n    [list.tagCounts, list.tags, select, value],\n  );\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? (\n          <fieldset>\n            <legend>{defaultAriaLabel}</legend>\n            <button type=\"button\" aria-pressed={value === undefined} onClick={() => select()}>\n              {defaultAllLabel}\n            </button>\n            {list.tags.map((tag) => (\n              <button key={tag} type=\"button\" aria-pressed={value === tag} onClick={() => select(tag)}>\n                {renderTag ? renderTag(tag, list.tagCounts[tag] ?? 0, value === tag) : tag}\n                <span> ({list.tagCounts[tag] ?? 0})</span>\n              </button>\n            ))}\n          </fieldset>\n        ));\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...rootProps, className },\n    body,\n    \"KeepTagFilter\",\n  );\n}\n\nexport type KeepNoteEditorState<TMeta = Record<string, unknown>> = {\n  item: KeepItem<TMeta>;\n  note: string;\n  setNote: (note: string) => void;\n  isDirty: boolean;\n  isSaving: boolean;\n  error: unknown | null;\n  save: () => Promise<void>;\n};\n\nexport type KeepNoteEditorProps<TMeta = Record<string, unknown>> = Omit<\n  FormHTMLAttributes<HTMLFormElement>,\n  \"children\" | \"onSubmit\"\n> & {\n  item: KeepItem<TMeta>;\n  label?: ReactNode;\n  saveLabel?: ReactNode;\n  placeholder?: string;\n  onSaved?: (note?: string) => void;\n  onSaveError?: (error: unknown) => void;\n  render?: RenderProp<KeepNoteEditorState<TMeta>>;\n  children?: ReactNode | RenderProp<KeepNoteEditorState<TMeta>>;\n  asChild?: boolean;\n};\n\n/** A controlled-by-default note editor that persists through useKeepItem. */\nexport function KeepNoteEditor<TMeta = Record<string, unknown>>({\n  item,\n  label,\n  saveLabel,\n  placeholder,\n  onSaved,\n  onSaveError,\n  render,\n  children,\n  asChild = false,\n  className,\n  ...formProps\n}: KeepNoteEditorProps<TMeta>) {\n  const defaultLabel = useUiLabel(\"note\");\n  const defaultSaveLabel = useUiLabel(\"saveNote\");\n  const itemState = useKeepItem<TMeta>(item.id);\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const [note, setNote] = useState(item.note ?? \"\");\n  useEffect(() => setNote(itemState.item?.note ?? item.note ?? \"\"), [item.note, itemState.item?.note]);\n  const save = useCallback(async () => {\n    const nextNote = note.trim() || undefined;\n    try {\n      await itemState.updateNote(nextNote);\n      onSaved?.(nextNote);\n    } catch (error) {\n      onSaveError?.(error);\n      throw error;\n    }\n  }, [itemState, note, onSaveError, onSaved]);\n  const state: KeepNoteEditorState<TMeta> = {\n    item,\n    note,\n    setNote,\n    isDirty: note !== (itemState.item?.note ?? item.note ?? \"\"),\n    isSaving: itemState.isMutating,\n    error: itemState.error,\n    save,\n  };\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? (\n          <>\n            <label>\n              {label ?? defaultLabel}\n              <textarea\n                value={note}\n                onChange={(event) => setNote(event.currentTarget.value)}\n                placeholder={placeholder}\n                disabled={itemState.isMutating}\n              />\n            </label>\n            <button type=\"submit\" disabled={itemState.isMutating} aria-busy={itemState.isMutating}>\n              {saveLabel ?? defaultSaveLabel}\n            </button>\n          </>\n        ));\n  const handleSubmit: FormHTMLAttributes<HTMLFormElement>[\"onSubmit\"] = (event) => {\n    event.preventDefault();\n    void save().catch(() => undefined);\n  };\n  if (!asChild) {\n    return (\n      <form\n        {...formProps}\n        className={className}\n        onSubmit={handleSubmit}\n        aria-busy={itemState.isMutating || formProps[\"aria-busy\"]}\n      >\n        {body}\n      </form>\n    );\n  }\n  return renderRoot(\n    true,\n    isValidElement(children) ? children : undefined,\n    { ...formProps, className, onSubmit: handleSubmit, \"aria-busy\": itemState.isMutating || formProps[\"aria-busy\"] },\n    body,\n    \"KeepNoteEditor\",\n  );\n}\n\nexport type KeepSearchInputProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  \"value\" | \"defaultValue\" | \"onChange\"\n> & {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n};\n\n/** A controlled/uncontrolled search field for wiring into useKeepList.searchQuery. */\nexport function KeepSearchInput({\n  value: controlledValue,\n  defaultValue = \"\",\n  onValueChange,\n  \"aria-label\": ariaLabel,\n  placeholder,\n  ...props\n}: KeepSearchInputProps) {\n  const label = useUiLabel(\"search\");\n  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);\n  const value = controlledValue ?? uncontrolledValue;\n  return (\n    <input\n      {...props}\n      type=\"search\"\n      value={value}\n      aria-label={ariaLabel ?? label}\n      placeholder={placeholder ?? label}\n      onChange={(event) => {\n        const nextValue = event.currentTarget.value;\n        if (controlledValue === undefined) setUncontrolledValue(nextValue);\n        onValueChange?.(nextValue);\n      }}\n    />\n  );\n}\n\nexport type KeepSortValue = \"savedAt:desc\" | \"savedAt:asc\" | \"updatedAt:desc\" | \"updatedAt:asc\";\n\nexport type KeepSortSelectProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  \"value\" | \"defaultValue\" | \"onChange\"\n> & {\n  value?: KeepSortValue;\n  defaultValue?: KeepSortValue;\n  onValueChange?: (value: KeepSortValue, sort: NonNullable<KeepListOptions[\"sort\"]>) => void;\n};\n\n/** Emits a normalized sort descriptor that can be passed directly to useKeepList. */\nexport function KeepSortSelect({\n  value: controlledValue,\n  defaultValue = \"updatedAt:desc\",\n  onValueChange,\n  \"aria-label\": ariaLabel,\n  children,\n  ...props\n}: KeepSortSelectProps) {\n  const label = useUiLabel(\"sort\");\n  const newestLabel = useUiLabel(\"newest\");\n  const savedLabel = useUiLabel(\"saved\");\n  const oldestLabel = useUiLabel(\"oldest\");\n  const [uncontrolledValue, setUncontrolledValue] = useState<KeepSortValue>(defaultValue);\n  const value = controlledValue ?? uncontrolledValue;\n  const options = children ?? (\n    <>\n      <option value=\"updatedAt:desc\">{newestLabel}</option>\n      <option value=\"savedAt:desc\">{savedLabel}</option>\n      <option value=\"updatedAt:asc\">{oldestLabel}</option>\n      <option value=\"savedAt:asc\">{oldestLabel}</option>\n    </>\n  );\n  return (\n    <select\n      {...props}\n      value={value}\n      aria-label={ariaLabel ?? label}\n      onChange={(event) => {\n        const nextValue = event.currentTarget.value as KeepSortValue;\n        if (controlledValue === undefined) setUncontrolledValue(nextValue);\n        const [by, direction] = nextValue.split(\":\") as [\"savedAt\" | \"updatedAt\", \"asc\" | \"desc\"];\n        onValueChange?.(nextValue, { by, direction });\n      }}\n    >\n      {options}\n    </select>\n  );\n}\n\nexport type KeepPaginationProps = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  totalCount: number;\n  pageSize: number;\n  page?: number;\n  onPageChange?: (page: number, offset: number) => void;\n  render?: RenderProp<{ page: number; pageCount: number; goToPage: (page: number) => void }>;\n};\n\n/** A small accessible pagination control using one-based pages and zero-based offsets. */\nexport function KeepPagination({\n  totalCount,\n  pageSize,\n  page = 1,\n  onPageChange,\n  render,\n  ...props\n}: KeepPaginationProps) {\n  const previousPageLabel = useUiLabel(\"previousPage\");\n  const nextPageLabel = useUiLabel(\"nextPage\");\n  const pageLabel = useUiLabel(\"page\");\n  const paginationLabel = useUiLabel(\"pagination\");\n  const pageCount = Math.max(1, Math.ceil(totalCount / Math.max(1, pageSize)));\n  const currentPage = Math.min(Math.max(1, page), pageCount);\n  const goToPage = (nextPage: number) => {\n    const next = Math.min(Math.max(1, nextPage), pageCount);\n    onPageChange?.(next, (next - 1) * pageSize);\n  };\n  if (render) return <nav {...props}>{render({ page: currentPage, pageCount, goToPage })}</nav>;\n  return (\n    <nav {...props} aria-label={props[\"aria-label\"] ?? paginationLabel}>\n      <button type=\"button\" onClick={() => goToPage(currentPage - 1)} disabled={currentPage <= 1}>\n        {previousPageLabel}\n      </button>\n      <span aria-current=\"page\">\n        {pageLabel} {currentPage} / {pageCount}\n      </span>\n      <button type=\"button\" onClick={() => goToPage(currentPage + 1)} disabled={currentPage >= pageCount}>\n        {nextPageLabel}\n      </button>\n    </nav>\n  );\n}\n\nexport type KeepTagEditorProps<TMeta = Record<string, unknown>> = Omit<\n  FormHTMLAttributes<HTMLFormElement>,\n  \"children\" | \"onSubmit\"\n> & {\n  item: KeepItem<TMeta>;\n  availableTags?: string[];\n  onSaved?: (tags?: string[]) => void;\n  onSaveError?: (error: unknown) => void;\n  render?: RenderProp<{\n    tags: string[];\n    setTags: (tags: string[]) => void;\n    save: () => Promise<void>;\n    isSaving: boolean;\n  }>;\n};\n\n/** Edits one item's normalized tag set and exposes a render-prop escape hatch. */\nexport function KeepTagEditor<TMeta = Record<string, unknown>>({\n  item,\n  availableTags = [],\n  onSaved,\n  onSaveError,\n  render,\n  ...props\n}: KeepTagEditorProps<TMeta>) {\n  const tagsLabel = useUiLabel(\"tagsToApply\");\n  const removeLabel = useUiLabel(\"remove\");\n  const applyTagsLabel = useUiLabel(\"applyTags\");\n  const itemState = useKeepItem<TMeta>(item.id);\n  const [tags, setTags] = useState(item.tags ?? []);\n  const [input, setInput] = useState(\"\");\n  useEffect(() => setTags(itemState.item?.tags ?? item.tags ?? []), [item.tags, itemState.item?.tags]);\n  const save = useCallback(async () => {\n    const nextTags = normalizeUiTags(tags);\n    try {\n      await itemState.updateTags(nextTags);\n      setTags(nextTags);\n      onSaved?.(nextTags);\n    } catch (error) {\n      onSaveError?.(error);\n      throw error;\n    }\n  }, [itemState, onSaveError, onSaved, tags]);\n  const addTag = (tag: string) => {\n    const next = normalizeUiTags([...tags, tag]);\n    setTags(next);\n    setInput(\"\");\n  };\n  const body = render ? (\n    render({ tags, setTags, save, isSaving: itemState.isMutating })\n  ) : (\n    <>\n      <label>\n        {tagsLabel}\n        <input\n          value={input}\n          list={availableTags.length > 0 ? `keep-tags-${item.id}` : undefined}\n          onChange={(event) => setInput(event.currentTarget.value)}\n          onKeyDown={(event) => {\n            if (event.key === \"Enter\") {\n              event.preventDefault();\n              if (input.trim()) addTag(input);\n            }\n          }}\n        />\n      </label>\n      {availableTags.length > 0 ? (\n        <datalist id={`keep-tags-${item.id}`}>\n          {availableTags.map((tag) => (\n            <option key={tag} value={tag} />\n          ))}\n        </datalist>\n      ) : null}\n      <ul aria-label={tagsLabel}>\n        {tags.map((tag) => (\n          <li key={tag}>\n            {tag}\n            <button type=\"button\" onClick={() => setTags(tags.filter((current) => current !== tag))}>\n              {removeLabel}\n            </button>\n          </li>\n        ))}\n      </ul>\n      <button type=\"submit\" disabled={itemState.isMutating} aria-busy={itemState.isMutating}>\n        {applyTagsLabel}\n      </button>\n    </>\n  );\n  return (\n    <form\n      {...props}\n      onSubmit={(event) => {\n        event.preventDefault();\n        void save().catch(() => undefined);\n      }}\n      aria-busy={itemState.isMutating || props[\"aria-busy\"]}\n    >\n      {body}\n    </form>\n  );\n}\n\nexport type KeepBulkActionsProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  listOptions?: KeepListOptions<TMeta>;\n  selectedIds?: string[];\n  defaultSelectedIds?: string[];\n  onSelectedIdsChange?: (ids: string[]) => void;\n  renderItem?: (item: KeepItem<TMeta>, selected: boolean) => ReactNode;\n  onCompleted?: (action: \"remove\" | \"tags\", ids: string[]) => void;\n};\n\n/** Selects visible items and performs one storage operation for the whole selection. */\nexport function KeepBulkActions<TMeta = Record<string, unknown>>({\n  listOptions,\n  selectedIds: controlledSelectedIds,\n  defaultSelectedIds = [],\n  onSelectedIdsChange,\n  renderItem,\n  onCompleted,\n  ...props\n}: KeepBulkActionsProps<TMeta>) {\n  const selectItemsLabel = useUiLabel(\"selectItems\");\n  const selectedCountLabel = useUiLabel(\"selectedCount\");\n  const deleteSelectedLabel = useUiLabel(\"deleteSelected\");\n  const tagsLabel = useUiLabel(\"tagsToApply\");\n  const applyTagsLabel = useUiLabel(\"applyTags\");\n  const list = useKeepList<TMeta>(listOptions);\n  const [uncontrolledSelectedIds, setUncontrolledSelectedIds] = useState(defaultSelectedIds);\n  const selectedIds = controlledSelectedIds ?? uncontrolledSelectedIds;\n  const selected = new Set(selectedIds);\n  const [tagsInput, setTagsInput] = useState(\"\");\n  const setSelectedIds = (ids: string[]) => {\n    if (controlledSelectedIds === undefined) setUncontrolledSelectedIds(ids);\n    onSelectedIdsChange?.(ids);\n  };\n  const toggle = (id: string) =>\n    setSelectedIds(selected.has(id) ? selectedIds.filter((current) => current !== id) : [...selectedIds, id]);\n  const allSelected = list.items.length > 0 && list.items.every((item) => selected.has(item.id));\n  const toggleAll = () => setSelectedIds(allSelected ? [] : list.items.map((item) => item.id));\n  const remove = async () => {\n    await list.removeBatch(selectedIds);\n    onCompleted?.(\"remove\", selectedIds);\n    setSelectedIds([]);\n  };\n  const updateTags = async () => {\n    const tags = normalizeUiTags(tagsInput.split(\",\"));\n    await list.updateTagsBatch(selectedIds, tags);\n    onCompleted?.(\"tags\", selectedIds);\n    setSelectedIds([]);\n  };\n  return (\n    <section {...props} aria-busy={list.isMutating || props[\"aria-busy\"]}>\n      <fieldset>\n        <legend>{selectItemsLabel}</legend>\n        <label>\n          <input type=\"checkbox\" checked={allSelected} onChange={toggleAll} />\n          {selectedIds.length} {selectedCountLabel}\n        </label>\n        {list.items.map((item) => (\n          <label key={item.id}>\n            <input type=\"checkbox\" checked={selected.has(item.id)} onChange={() => toggle(item.id)} />\n            {renderItem ? renderItem(item, selected.has(item.id)) : (getMetaTitle(item.meta) ?? item.id)}\n          </label>\n        ))}\n      </fieldset>\n      <button type=\"button\" onClick={() => void remove()} disabled={selectedIds.length === 0 || list.isMutating}>\n        {deleteSelectedLabel}\n      </button>\n      <label>\n        {tagsLabel}\n        <input value={tagsInput} onChange={(event) => setTagsInput(event.currentTarget.value)} />\n      </label>\n      <button type=\"button\" onClick={() => void updateTags()} disabled={selectedIds.length === 0 || list.isMutating}>\n        {applyTagsLabel}\n      </button>\n    </section>\n  );\n}\n\nexport type KeepEmptyStateProps = Omit<HTMLAttributes<HTMLElement>, \"children\" | \"title\"> & {\n  title?: ReactNode;\n  description?: ReactNode;\n  action?: ReactNode;\n  children?: ReactNode;\n  asChild?: boolean;\n};\n\n/** A style-free, reusable empty collection state. */\nexport function KeepEmptyState({\n  title,\n  description,\n  action,\n  children,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepEmptyStateProps) {\n  const defaultTitle = useUiLabel(\"noItems\").replace(/\\.$/, \"\");\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const body = contentChildren ?? (\n    <>\n      <h2>{title ?? defaultTitle}</h2>\n      {description ? <p>{description}</p> : null}\n      {action}\n    </>\n  );\n  return renderRoot(asChild, children, { ...rootProps, className }, body, \"KeepEmptyState\");\n}\n\nexport type KeepStatusValue = \"idle\" | \"empty\" | \"loading\" | \"saving\" | \"syncing\" | \"error\";\n\nexport type KeepStatusLabels = Partial<Record<KeepStatusValue, ReactNode>>;\n\nexport type KeepStatusState<TMeta = Record<string, unknown>> = {\n  status: KeepStatusValue;\n  error: unknown | null;\n  pendingCount: number;\n  items: KeepItem<TMeta>[];\n};\n\nexport type KeepStatusProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  status?: KeepStatusValue;\n  labels?: KeepStatusLabels;\n  children?: ReactNode | RenderProp<KeepStatusState<TMeta>>;\n  render?: RenderProp<KeepStatusState<TMeta>>;\n  asChild?: boolean;\n};\n\n/** Presents provider loading, mutation, synchronization, empty, and error states accessibly. */\nexport function KeepStatus<TMeta = Record<string, unknown>>({\n  status,\n  labels,\n  children,\n  render,\n  asChild = false,\n  className,\n  ...rootProps\n}: KeepStatusProps<TMeta>) {\n  const context = useKeepContext<TMeta>();\n  const contentChildren = asChild && isValidElement(children) ? undefined : children;\n  const resolvedStatus = status ?? getDerivedStatus(context);\n  const defaultLabel = useUiLabel(getStatusLabelKey(resolvedStatus));\n  const state: KeepStatusState<TMeta> = {\n    status: resolvedStatus,\n    error: context.error,\n    pendingCount: context.syncState.pendingCount,\n    items: context.items,\n  };\n  const body = render\n    ? render(state)\n    : typeof contentChildren === \"function\"\n      ? contentChildren(state)\n      : (contentChildren ?? labels?.[resolvedStatus] ?? defaultLabel);\n  const role = rootProps.role ?? (resolvedStatus === \"error\" ? \"alert\" : \"status\");\n  return renderRoot(\n    asChild,\n    isValidElement(children) ? children : undefined,\n    { ...rootProps, className, role, \"aria-live\": rootProps[\"aria-live\"] ?? \"polite\" },\n    body,\n    \"KeepStatus\",\n  );\n}\n\nexport type KeepAnnouncementsProps = Omit<HTMLAttributes<HTMLElement>, \"children\"> & {\n  messages?: Partial<Record<\"save\" | \"remove\" | \"note\", string>>;\n};\n\n/** Announces successful save, remove, and note operations in a polite live region. */\nexport function KeepAnnouncements<TMeta = Record<string, unknown>>({ messages, ...props }: KeepAnnouncementsProps) {\n  const context = useKeepContext<TMeta>();\n  const savedMessage = useUiLabel(\"savedMessage\", messages?.save);\n  const removedMessage = useUiLabel(\"removedMessage\", messages?.remove);\n  const noteSavedMessage = useUiLabel(\"noteSavedMessage\", messages?.note);\n  const [message, setMessage] = useState(\"\");\n  const lastChangeRef = useRef<KeepChangeContext<TMeta> | undefined>(undefined);\n  useEffect(() => {\n    const change = context.lastChange;\n    if (!change || change === lastChangeRef.current) return;\n    lastChangeRef.current = change;\n    if (change.action === \"save\") setMessage(savedMessage);\n    else if (change.action === \"remove\" || change.action === \"removeBatch\") setMessage(removedMessage);\n    else if (change.action === \"updateNote\") setMessage(noteSavedMessage);\n  }, [context.lastChange, noteSavedMessage, removedMessage, savedMessage]);\n  return (\n    <div {...props} role={props.role ?? \"status\"} aria-live={props[\"aria-live\"] ?? \"polite\"} aria-atomic=\"true\">\n      {message}\n    </div>\n  );\n}\n\nfunction getDerivedStatus<TMeta>(context: ReturnType<typeof useKeepContext<TMeta>>): KeepStatusValue {\n  if (context.error) return \"error\";\n  if (context.syncState.status === \"pending\" || context.syncState.status === \"syncing\") return \"syncing\";\n  if (context.isMutating) return \"saving\";\n  if (context.isLoading && !context.isHydrated) return \"loading\";\n  if (context.isHydrated && context.items.length === 0) return \"empty\";\n  return \"idle\";\n}\n\nfunction getStatusLabelKey(status: KeepStatusValue): KeepUiLabelKey {\n  if (status === \"empty\") return \"noItems\";\n  if (status === \"loading\") return \"loadingItems\";\n  if (status === \"error\") return \"error\";\n  if (status === \"saving\") return \"saving\";\n  if (status === \"syncing\") return \"syncing\";\n  return \"saved\";\n}\n\nfunction resolveContent<TState>(content: ReactNode | RenderProp<TState>, state: TState): ReactNode {\n  return typeof content === \"function\" ? content(state) : content;\n}\n\nfunction toKeepButtonItem<TMeta>(item: KeepItem<TMeta>): KeepItemInput<TMeta> & { id: string } {\n  return {\n    id: item.id,\n    meta: item.meta,\n    targetType: item.targetType,\n    note: item.note,\n    tags: item.tags,\n  };\n}\n\nfunction getMetaTitle<TMeta>(meta: TMeta): string | undefined {\n  if (typeof meta !== \"object\" || meta === null || !(\"title\" in meta)) return undefined;\n  const title = (meta as { title?: unknown }).title;\n  return typeof title === \"string\" && title.trim() ? title.trim() : undefined;\n}\n\nfunction normalizeUiTags(tags: string[]): string[] {\n  return [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];\n}\n\nfunction renderRoot(\n  asChild: boolean,\n  child: ReactNode,\n  props: HTMLAttributes<HTMLElement> & Record<string, unknown>,\n  body: ReactNode,\n  componentName: string,\n): ReactElement {\n  if (asChild) {\n    if (!isValidElement(child)) throw new Error(`${componentName} with asChild requires a single React element child.`);\n    return cloneElement(child as ReactElement<Record<string, unknown>>, { ...props, children: body });\n  }\n  return <div {...props}>{body}</div>;\n}\n"],"mappings":"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","names":["useKeepContext","useKeepItem","useKeepList","sharedProps","statefulProps"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepkit/ui",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Headless, accessible React UI components for KeepKit.",
   "type": "module",
   "license": "MIT",
@@ -27,11 +27,11 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@keepkit/core": ">=0.2.0",
+    "@keepkit/core": ">=0.4.0",
     "react": ">=18"
   },
   "devDependencies": {
-    "@keepkit/core": "0.3.0",
+    "@keepkit/core": "0.4.0",
     "@types/react": "^19.2.18",
     "react": "^19.2.8",
     "tsup": "^8.5.1",