@keepkit/ui 0.6.0 → 0.8.0

package/README.md

@@ -32,7 +32,7 @@ function SavedArticles() {
 }
 ```
 
-`keep.Collection`は検索、ソート、ページング、loading / empty / error、ARIA live通知を標準で提供します。検索は既定で300msデバウンスされます。`features={{ tagFilter: true, bulkActions: true }}`でタグフィルターと一括操作も有効にできます。個別の`KeepList`、`KeepSearchInput`、`KeepSortSelect`、`KeepPagination`、`KeepItemCheckbox`、`KeepTagEditor`などは高度なレイアウト用に利用できます。`KeepBulkActions`はrender propsで操作UIを差し替えられます。
+`keep.Collection`は検索、ソート、ページング、loading / empty / error、ARIA live通知を標準で提供します。検索は既定で300msデバウンスされます。`features={{ tagFilter: true, bulkActions: true }}`でタグフィルターと一括操作も有効にできます。個別の`KeepList`、`KeepSearchInput`、`KeepSortSelect`、`KeepPagination`、`KeepItemCheckbox`、`KeepTagEditor`などは高度なレイアウト用に利用できます。`KeepBulkActions`はrender propsで操作UIを差し替えられ、`isAllSelected` / `toggleSelectAll`で表示中アイテムを一括操作できます。`KeepNoteEditor`は既定300msのデバウンス保存に対応し、`debounceMs={0}`でフォーム送信のみへ戻せます。通知領域だけを明示的に置く場合は`KeepAnnouncer`（`KeepAnnouncements`のalias）を使えます。
 
 一覧のqueryは次の形式に統一されています。
 
@@ -81,7 +81,7 @@ function SavedArticles() {
 }
 ```
 
-`keep.Collection` includes search, sorting, pagination, loading/empty/error states, and polite live announcements. Search is debounced by 300ms by default. Enable `features={{ tagFilter: true, bulkActions: true }}` for tag filtering and bulk operations. Use the individual `KeepList`, `KeepSearchInput`, `KeepSortSelect`, `KeepPagination`, `KeepItemCheckbox`, and `KeepTagEditor` primitives when you need a custom layout. `KeepBulkActions` supports render props for replacing its operation UI.
+`keep.Collection` includes search, sorting, pagination, loading/empty/error states, and polite live announcements. Search is debounced by 300ms by default. Enable `features={{ tagFilter: true, bulkActions: true }}` for tag filtering and bulk operations. Use the individual `KeepList`, `KeepSearchInput`, `KeepSortSelect`, `KeepPagination`, `KeepItemCheckbox`, and `KeepTagEditor` primitives when you need a custom layout. `KeepBulkActions` supports render props and exposes `isAllSelected` / `toggleSelectAll` for visible-item selection. `KeepNoteEditor` auto-saves dirty notes after 300ms by default; set `debounceMs={0}` to use form submission only. Mount `KeepAnnouncer` (`KeepAnnouncements` alias) when you need the live region explicitly.
 
 Collection queries use one canonical shape: `targetType`, `tags`, `search`, `sort`, `pagination`, `filter`, and `savedBetween`. Saved item inputs contain only `id`, `meta`, `targetType`, `note`, and `tags`; KeepKit owns persistence timestamps.
 

package/dist/index.d.ts

@@ -1,93 +1,11 @@
 import * as react from 'react';
-import { InputHTMLAttributes, ReactNode, SelectHTMLAttributes, ImgHTMLAttributes, HTMLAttributes, ComponentType, ReactElement, FormHTMLAttributes } from 'react';
-import { KeepItem, KeepListQuery, KeepItemInput } from '@keepkit/core/core';
+import { ReactNode, HTMLAttributes, ImgHTMLAttributes, ComponentType, InputHTMLAttributes, FormHTMLAttributes, SelectHTMLAttributes } from 'react';
+import { KeepListQuery, KeepItem, KeepItemInput } from '@keepkit/core/core';
 export { KeepItem, KeepItemInput, KeepListQuery, KeepSyncStatus } from '@keepkit/core/core';
-import { CreateKeepKitOptions as CreateKeepKitOptions$1, KeepButtonProps as KeepButtonProps$1, UseKeepListResult, KeepProviderProps, useKeepContext, useKeepItem, KeepShortcutOptions } from '@keepkit/core/react';
-export { KeepContextValue, KeepProvider, KeepProviderProps, KeepShortcutOptions, useKeepContext, useKeepItem, useKeepList, useKeepShortcut } from '@keepkit/core/react';
+import { KeepButtonProps as KeepButtonProps$1, UseKeepListResult, CreateKeepKitOptions as CreateKeepKitOptions$1, KeepProviderProps, useKeepContext, useKeepItem, useKeepList, KeepShortcutOptions } from '@keepkit/core/react';
+export { KeepButtonState, KeepContextValue, KeepProvider, KeepProviderProps, KeepShortcutOptions, useKeepContext, useKeepItem, useKeepList, useKeepShortcut } from '@keepkit/core/react';
 export { FallbackStorageAdapter, IndexedDBAdapter, IndexedDBSyncQueueAdapter, LocalStorageAdapter, LocalStorageSyncQueueAdapter, SyncStorageAdapter, createBrowserStorageAdapter, createStorageAdapter } from '@keepkit/core/storage';
 
-type KeepItemCheckboxProps<TMeta = Record<string, unknown>> = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "checked" | "defaultChecked" | "onChange"> & {
-    item: KeepItem<TMeta>;
-    checked?: boolean;
-    label?: ReactNode;
-    onCheckedChange?: (checked: boolean) => void;
-};
-/** A reusable accessible selection checkbox for a saved item. */
-declare function KeepItemCheckbox<TMeta = Record<string, unknown>>({ item, checked, label, onCheckedChange, "aria-label": ariaLabel, ...props }: KeepItemCheckboxProps<TMeta>): react.JSX.Element;
-
-type KeepSearchInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange"> & {
-    value?: string;
-    defaultValue?: string;
-    /** Delay before notifying consumers; set to 0 to disable debouncing. */
-    debounceMs?: number;
-    onValueChange?: (value: string) => void;
-};
-/** A controlled/uncontrolled search field with a small built-in debounce. */
-declare function KeepSearchInput({ value: controlledValue, defaultValue, debounceMs, 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<KeepListQuery["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 KeepPaginationState = {
-    page: number;
-    pageCount: number;
-    goToPage: (page: number) => void;
-};
-type KeepPaginationProps = Omit<React.HTMLAttributes<HTMLElement>, "children"> & {
-    totalCount: number;
-    pageSize: number;
-    page?: number;
-    maxPageButtons?: number;
-    onPageChange?: (page: number, offset: number) => void;
-    render?: (state: KeepPaginationState) => ReactNode;
-};
-/** Accessible pagination with previous/next controls and numbered page buttons. */
-declare function KeepPagination({ totalCount, pageSize, page, maxPageButtons, onPageChange, render, ...props }: KeepPaginationProps): react.JSX.Element;
-
-type KeepUiLabelKey = "save" | "saved" | "remove" | "loading" | "saving" | "syncing" | "error" | "allTags" | "filterTags" | "note" | "saveNote" | "noItems" | "loadingItems" | "errorItems" | "search" | "sort" | "newest" | "oldest" | "savedNewest" | "savedOldest" | "updatedNewest" | "updatedOldest" | "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 KeepKitProviderProps<TMeta = Record<string, unknown>> = Omit<KeepProviderProps<TMeta>, "children"> & Omit<KeepUiProviderProps, "children"> & {
-    children?: ReactNode;
-};
-/** Combines the core store and UI labels into the default application provider. */
-declare function KeepKitProvider<TMeta = Record<string, unknown>>({ labels, locale, labelResolver, children, ...providerProps }: KeepKitProviderProps<TMeta>): react.JSX.Element;
-
-type CreateKeepKitOptions<TMeta = Record<string, unknown>> = CreateKeepKitOptions$1<TMeta> & Omit<KeepUiProviderProps, "children"> & {
-    getTitle?: (item: KeepItem<TMeta>) => ReactNode;
-    getImageProps?: (item: KeepItem<TMeta>, title: ReactNode) => KeepImageProps | undefined;
-};
-type KeepKit<TMeta = Record<string, unknown>> = {
-    Provider: ComponentType<KeepKitProviderProps<TMeta>>;
-    Button: ComponentType<KeepButtonProps<TMeta>>;
-    Collection: ComponentType<KeepCollectionProps<TMeta>>;
-    useContext: () => ReturnType<typeof useKeepContext<TMeta>>;
-    useItem: (item?: KeepItemInput<TMeta>) => ReturnType<typeof useKeepItem<TMeta>>;
-    useList: (query?: KeepListQuery<TMeta>) => UseKeepListResult<TMeta>;
-    useShortcut: (options: KeepShortcutOptions<TMeta>) => void;
-};
-/** Create one typed application API for the core and the standard UI layer. */
-declare function createKeepKit<TMeta = Record<string, unknown>>(options?: CreateKeepKitOptions<TMeta>): KeepKit<TMeta>;
 type RenderProp<TState> = (state: TState) => ReactNode;
 type KeepButtonLabels = {
     saved?: ReactNode;
@@ -97,11 +15,45 @@ type KeepButtonLabels = {
     savedAriaLabel?: string;
     unsavedAriaLabel?: string;
 };
+
+type KeepBulkActionsState<TMeta = Record<string, unknown>> = {
+    items: KeepItem<TMeta>[];
+    selectedIds: string[];
+    selectedCount: number;
+    isAllSelected: boolean;
+    allSelected: boolean;
+    tagsInput: string;
+    setTagsInput: (value: string) => void;
+    toggle: (id: string) => void;
+    toggleSelectAll: () => void;
+    toggleAll: () => void;
+    remove: () => Promise<void>;
+    updateTags: () => Promise<void>;
+    isMutating: boolean;
+};
+/** Returns whether every visible item is selected. Empty lists are never all selected. */
+declare function isAllSelected<TMeta>(items: readonly Pick<KeepItem<TMeta>, "id">[], selectedIds: readonly string[]): boolean;
+/** Toggles only the visible items, preserving selections outside the current query or page. */
+declare function toggleSelectAll<TMeta>(items: readonly Pick<KeepItem<TMeta>, "id">[], selectedIds: readonly string[]): string[];
+type KeepBulkActionsProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    query?: KeepListQuery<TMeta>;
+    selectedIds?: string[];
+    defaultSelectedIds?: string[];
+    onSelectedIdsChange?: (ids: string[]) => void;
+    renderItem?: (item: KeepItem<TMeta>, selected: boolean) => ReactNode;
+    onCompleted?: (action: "remove" | "tags", ids: string[]) => void;
+    render?: RenderProp<KeepBulkActionsState<TMeta>>;
+    children?: ReactNode | RenderProp<KeepBulkActionsState<TMeta>>;
+};
+/** Selects visible items and performs one storage operation for the whole selection. */
+declare function KeepBulkActions<TMeta = Record<string, unknown>>({ query, selectedIds: controlledSelectedIds, defaultSelectedIds, onSelectedIdsChange, renderItem, onCompleted, render, children, ...props }: KeepBulkActionsProps<TMeta>): react.JSX.Element;
+
 type KeepButtonProps<TMeta = Record<string, unknown>> = KeepButtonProps$1<TMeta> & {
     labels?: KeepButtonLabels;
 };
 /** A style-free save toggle with localized labels and the core button's ARIA/asChild behavior. */
 declare function KeepButton<TMeta = Record<string, unknown>>({ labels, ...props }: KeepButtonProps<TMeta>): react.JSX.Element;
+
 type KeepItemCardState<TMeta = Record<string, unknown>> = {
     item: KeepItem<TMeta>;
     isSaved: boolean;
@@ -131,7 +83,8 @@ 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, getTitle, getImageProps, imageComponent: ImageComponent, renderImage, 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, getTitle, getImageProps, imageComponent: ImageComponent, renderImage, imageAlt, render, children, removeLabel, onRemoveError, onRemoved, showSaveButton, saveButtonLabels, asChild, className, ...rootProps }: KeepItemCardProps<TMeta>): react.ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
 type KeepListState<TMeta = Record<string, unknown>> = UseKeepListResult<TMeta>;
 type KeepListProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
     query?: KeepListQuery<TMeta>;
@@ -144,7 +97,8 @@ type KeepListProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLEl
     asChild?: boolean;
 };
 /** A list primitive with built-in loading, empty, error, and removal states. */
-declare function KeepList<TMeta = Record<string, unknown>>({ query, children, renderItem, loading, empty, error: errorContent, itemCardProps, asChild, className, ...rootProps }: KeepListProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+declare function KeepList<TMeta = Record<string, unknown>>({ query, children, renderItem, loading, empty, error: errorContent, itemCardProps, asChild, className, ...rootProps }: KeepListProps<TMeta>): react.ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
 type KeepCollectionFeature = "search" | "sort" | "pagination" | "tagFilter" | "bulkActions";
 type KeepCollectionProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
     query?: KeepListQuery<TMeta>;
@@ -158,27 +112,16 @@ type KeepCollectionProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<
 };
 /** A batteries-included collection with query controls and accessible status feedback. */
 declare function KeepCollection<TMeta = Record<string, unknown>>({ query, pageSize, features, renderItem, itemCardProps, loading, empty, error, className, ...rootProps }: KeepCollectionProps<TMeta>): react.JSX.Element;
-type KeepTagFilterState = {
-    tags: string[];
-    tagCounts: Record<string, number>;
-    value?: string;
-    select: (tag?: string) => void;
-};
-type KeepTagFilterProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children" | "onChange"> & {
-    query?: KeepListQuery<TMeta>;
-    value?: string;
-    defaultValue?: string;
-    onChange?: (tag?: string) => void;
-    onValueChange?: (tag?: string) => void;
-    allLabel?: ReactNode;
-    ariaLabel?: string;
-    renderTag?: (tag: string, count: number, selected: boolean) => ReactNode;
-    render?: RenderProp<KeepTagFilterState>;
-    children?: ReactNode | RenderProp<KeepTagFilterState>;
-    asChild?: boolean;
+
+type KeepItemCheckboxProps<TMeta = Record<string, unknown>> = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "checked" | "defaultChecked" | "onChange"> & {
+    item: KeepItem<TMeta>;
+    checked?: boolean;
+    label?: ReactNode;
+    onCheckedChange?: (checked: boolean) => void;
 };
-/** An ARIA button group for tag filtering; consumers can connect value to a collection query. */
-declare function KeepTagFilter<TMeta = Record<string, unknown>>({ query, value: controlledValue, defaultValue, onChange, onValueChange, allLabel, ariaLabel, renderTag, render, children, asChild, className, ...rootProps }: KeepTagFilterProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+/** A reusable accessible selection checkbox for a saved item. */
+declare function KeepItemCheckbox<TMeta = Record<string, unknown>>({ item, checked, label, onCheckedChange, "aria-label": ariaLabel, ...props }: KeepItemCheckboxProps<TMeta>): react.JSX.Element;
+
 type KeepNoteEditorState<TMeta = Record<string, unknown>> = {
     item: KeepItem<TMeta>;
     note: string;
@@ -193,6 +136,8 @@ type KeepNoteEditorProps<TMeta = Record<string, unknown>> = Omit<FormHTMLAttribu
     label?: ReactNode;
     saveLabel?: ReactNode;
     placeholder?: string;
+    /** Automatically save dirty notes after this delay; set to 0 to disable auto-save. */
+    debounceMs?: number;
     onSaved?: (note?: string) => void;
     onSaveError?: (error: unknown) => void;
     render?: RenderProp<KeepNoteEditorState<TMeta>>;
@@ -200,46 +145,79 @@ 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>): react.JSX.Element;
+declare function KeepNoteEditor<TMeta = Record<string, unknown>>({ item, label, saveLabel, placeholder, debounceMs, onSaved, onSaveError, render, children, asChild, className, ...formProps }: KeepNoteEditorProps<TMeta>): react.JSX.Element;
+
+type KeepTagEditorState = {
+    tags: string[];
+    setTags: (tags: string[]) => void;
+    save: () => Promise<void>;
+    isSaving: boolean;
+};
 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;
-    }>;
+    render?: RenderProp<KeepTagEditorState>;
 };
-/** Edits one item's normalized tag set and exposes a render-prop escape hatch. */
+/** Edits one item's normalized tag set; Enter adds and Backspace removes the last tag. */
 declare function KeepTagEditor<TMeta = Record<string, unknown>>({ item, availableTags, onSaved, onSaveError, render, ...props }: KeepTagEditorProps<TMeta>): react.JSX.Element;
-type KeepBulkActionsState<TMeta = Record<string, unknown>> = {
-    items: KeepItem<TMeta>[];
-    selectedIds: string[];
-    selectedCount: number;
-    allSelected: boolean;
-    tagsInput: string;
-    setTagsInput: (value: string) => void;
-    toggle: (id: string) => void;
-    toggleAll: () => void;
-    remove: () => Promise<void>;
-    updateTags: () => Promise<void>;
-    isMutating: boolean;
+
+type KeepTagFilterState = {
+    tags: string[];
+    tagCounts: Record<string, number>;
+    value?: string;
+    select: (tag?: string) => void;
 };
-type KeepBulkActionsProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+type KeepTagFilterProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children" | "onChange"> & {
     query?: KeepListQuery<TMeta>;
-    selectedIds?: string[];
-    defaultSelectedIds?: string[];
-    onSelectedIdsChange?: (ids: string[]) => void;
-    renderItem?: (item: KeepItem<TMeta>, selected: boolean) => ReactNode;
-    onCompleted?: (action: "remove" | "tags", ids: string[]) => void;
-    render?: RenderProp<KeepBulkActionsState<TMeta>>;
-    children?: ReactNode | RenderProp<KeepBulkActionsState<TMeta>>;
+    value?: string;
+    defaultValue?: string;
+    onChange?: (tag?: string) => void;
+    onValueChange?: (tag?: string) => void;
+    allLabel?: ReactNode;
+    ariaLabel?: string;
+    renderTag?: (tag: string, count: number, selected: boolean) => ReactNode;
+    render?: RenderProp<KeepTagFilterState>;
+    children?: ReactNode | RenderProp<KeepTagFilterState>;
+    asChild?: boolean;
 };
-/** Selects visible items and performs one storage operation for the whole selection. */
-declare function KeepBulkActions<TMeta = Record<string, unknown>>({ query, selectedIds: controlledSelectedIds, defaultSelectedIds, onSelectedIdsChange, renderItem, onCompleted, render, children, ...props }: KeepBulkActionsProps<TMeta>): react.JSX.Element;
+/** An ARIA button group for tag filtering; consumers can connect value to a collection query. */
+declare function KeepTagFilter<TMeta = Record<string, unknown>>({ query, value: controlledValue, defaultValue, onChange, onValueChange, allLabel, ariaLabel, renderTag, render, children, asChild, className, ...rootProps }: KeepTagFilterProps<TMeta>): react.ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type KeepSearchInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange"> & {
+    value?: string;
+    defaultValue?: string;
+    /** Delay before notifying consumers; set to 0 to disable debouncing. */
+    debounceMs?: number;
+    onValueChange?: (value: string) => void;
+};
+/** A controlled/uncontrolled search field with a small built-in debounce. */
+declare function KeepSearchInput({ value: controlledValue, defaultValue, debounceMs, 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<KeepListQuery["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 KeepPaginationState = {
+    page: number;
+    pageCount: number;
+    goToPage: (page: number) => void;
+};
+type KeepPaginationProps = Omit<React.HTMLAttributes<HTMLElement>, "children"> & {
+    totalCount: number;
+    pageSize: number;
+    page?: number;
+    maxPageButtons?: number;
+    onPageChange?: (page: number, offset: number) => void;
+    render?: (state: KeepPaginationState) => ReactNode;
+};
+/** Accessible pagination with previous/next controls and numbered page buttons. */
+declare function KeepPagination({ totalCount, pageSize, page, maxPageButtons, onPageChange, render, ...props }: KeepPaginationProps): react.JSX.Element;
+
 type KeepEmptyStateProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & {
     title?: ReactNode;
     description?: ReactNode;
@@ -248,7 +226,7 @@ type KeepEmptyStateProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title
     asChild?: boolean;
 };
 /** A style-free, reusable empty collection state. */
-declare function KeepEmptyState({ title, description, action, children, asChild, className, ...rootProps }: KeepEmptyStateProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+declare function KeepEmptyState({ title, description, action, children, asChild, className, ...rootProps }: KeepEmptyStateProps): react.ReactElement<unknown, string | react.JSXElementConstructor<any>>;
 type KeepStatusValue = "idle" | "empty" | "loading" | "saving" | "syncing" | "error";
 type KeepStatusLabels = Partial<Record<KeepStatusValue, ReactNode>>;
 type KeepStatusState<TMeta = Record<string, unknown>> = {
@@ -265,11 +243,54 @@ type KeepStatusProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTML
     asChild?: boolean;
 };
 /** 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>>;
+declare function KeepStatus<TMeta = Record<string, unknown>>({ status, labels, children, render, asChild, className, ...rootProps }: KeepStatusProps<TMeta>): react.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;
+/** Singular alias for applications that mount one announcer explicitly. */
+declare const KeepAnnouncer: typeof KeepAnnouncements;
+
+type KeepUiLabelKey = "save" | "saved" | "remove" | "loading" | "saving" | "syncing" | "error" | "allTags" | "filterTags" | "note" | "saveNote" | "noItems" | "loadingItems" | "errorItems" | "search" | "sort" | "newest" | "oldest" | "savedNewest" | "savedOldest" | "updatedNewest" | "updatedOldest" | "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 KeepKitProviderProps<TMeta = Record<string, unknown>> = Omit<KeepProviderProps<TMeta>, "children"> & Omit<KeepUiProviderProps, "children"> & {
+    children?: ReactNode;
+};
+/** Combines the core store, UI labels, and the global live announcer. */
+declare function KeepKitProvider<TMeta = Record<string, unknown>>({ labels, locale, labelResolver, children, ...providerProps }: KeepKitProviderProps<TMeta>): react.JSX.Element;
+
+type CreateKeepKitOptions<TMeta = Record<string, unknown>> = CreateKeepKitOptions$1<TMeta> & Omit<KeepUiProviderProps, "children"> & {
+    getTitle?: (item: KeepItem<TMeta>) => ReactNode;
+    getImageProps?: (item: KeepItem<TMeta>, title: ReactNode) => KeepImageProps | undefined;
+};
+type KeepKit<TMeta = Record<string, unknown>> = {
+    Provider: ComponentType<KeepKitProviderProps<TMeta>>;
+    Button: ComponentType<KeepButtonProps<TMeta>>;
+    Collection: ComponentType<KeepCollectionProps<TMeta>>;
+    useContext: () => ReturnType<typeof useKeepContext<TMeta>>;
+    useItem: (item?: KeepItemInput<TMeta>) => ReturnType<typeof useKeepItem<TMeta>>;
+    useList: (query?: KeepListQuery<TMeta>) => ReturnType<typeof useKeepList<TMeta>>;
+    useShortcut: (options: KeepShortcutOptions<TMeta>) => void;
+};
+/** Create one typed application API for the core and standard UI layer. */
+declare function createKeepKit<TMeta = Record<string, unknown>>(options?: CreateKeepKitOptions<TMeta>): KeepKit<TMeta>;
 
-export { type CreateKeepKitOptions, KeepAnnouncements, type KeepAnnouncementsProps, KeepBulkActions, type KeepBulkActionsProps, type KeepBulkActionsState, KeepButton, type KeepButtonLabels, type KeepButtonProps, KeepCollection, type KeepCollectionFeature, type KeepCollectionProps, KeepEmptyState, type KeepEmptyStateProps, type KeepImageProps, KeepItemCard, type KeepItemCardProps, type KeepItemCardState, KeepItemCheckbox, type KeepItemCheckboxProps, type KeepKit, KeepKitProvider, type KeepKitProviderProps, KeepList, type KeepListProps, type KeepListState, KeepNoteEditor, type KeepNoteEditorProps, type KeepNoteEditorState, KeepPagination, type KeepPaginationProps, type KeepPaginationState, 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, createKeepKit, useKeepUiLabels };
+export { type CreateKeepKitOptions, KeepAnnouncements, type KeepAnnouncementsProps, KeepAnnouncer, KeepBulkActions, type KeepBulkActionsProps, type KeepBulkActionsState, KeepButton, type KeepButtonLabels, type KeepButtonProps, KeepCollection, type KeepCollectionFeature, type KeepCollectionProps, KeepEmptyState, type KeepEmptyStateProps, type KeepImageProps, KeepItemCard, type KeepItemCardProps, type KeepItemCardState, KeepItemCheckbox, type KeepItemCheckboxProps, type KeepKit, KeepKitProvider, type KeepKitProviderProps, KeepList, type KeepListProps, type KeepListState, KeepNoteEditor, type KeepNoteEditorProps, type KeepNoteEditorState, KeepPagination, type KeepPaginationProps, type KeepPaginationState, KeepSearchInput, type KeepSearchInputProps, KeepSortSelect, type KeepSortSelectProps, type KeepSortValue, KeepStatus, type KeepStatusLabels, type KeepStatusProps, type KeepStatusState, type KeepStatusValue, KeepTagEditor, type KeepTagEditorProps, type KeepTagEditorState, KeepTagFilter, type KeepTagFilterProps, type KeepTagFilterState, type KeepUiLabelContext, type KeepUiLabelKey, type KeepUiLabels, KeepUiProvider, type KeepUiProviderProps, type RenderProp, createKeepKit, isAllSelected, toggleSelectAll, useKeepUiLabels };