@keepkit/ui 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nitta-a
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @keepkit/ui
+
+[日本語](#日本語) | [English](#english)
+
+## 日本語
+
+`@keepkit/core` の保存状態を、アプリ固有のCSSやUIライブラリに接続するための、低依存・スタイルレスなReact UIパーツです。Tailwind CSS、shadcn/ui、その他のデザインシステムには依存しません。
+
+```bash
+pnpm add @keepkit/core @keepkit/ui
+```
+
+```tsx
+import { KeepList, KeepProvider, KeepTagFilter } from "@keepkit/ui";
+
+function SavedItems() {
+  return (
+    <KeepProvider>
+      <KeepTagFilter value={selectedTag} onValueChange={setSelectedTag} />
+      <KeepList options={{ tag: selectedTag }} />
+    </KeepProvider>
+  );
+}
+```
+
+提供するコンポーネントは次のとおりです。
+
+- `KeepButton`: 保存済み状態、`aria-pressed`、ローディング・エラー状態、`asChild`、render props。`labels` または既存の `savedAriaLabel` / `unsavedAriaLabel` で翻訳できます。
+- `KeepList`: 保存一覧、読み込み中・空・エラー状態、標準カード、削除操作。`renderItem` で行単位を置き換えられます。
+- `KeepItemCard`: タイトル、画像、保存ボタン、削除ボタン。`getImageUrl` とrender propsで表示を差し替えられます。
+- `KeepTagFilter`: タグと件数を表示するキーボード操作可能なフィルター。`value` / `onValueChange` のcontrolled APIに対応します。
+- `KeepNoteEditor`: ノートの編集・保存フォーム。`render` で完全なカスタムUIにできます。
+- `KeepEmptyState` / `KeepStatus`: 空、読み込み中、保存中、同期中、エラー状態の表示。
+
+すべてのルート要素で `className` を利用でき、対応コンポーネントでは `asChild` で既存要素をルートとして利用できます。コンポーネントの標準HTMLは意味的な要素、ネイティブボタン、フォーム、`aria-live` を利用します。
+
+## 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.
+
+```bash
+pnpm add @keepkit/core @keepkit/ui
+```
+
+```tsx
+import { KeepList, KeepProvider, KeepTagFilter } from "@keepkit/ui";
+
+function SavedItems() {
+  return (
+    <KeepProvider>
+      <KeepTagFilter value={selectedTag} onValueChange={setSelectedTag} />
+      <KeepList options={{ tag: selectedTag }} />
+    </KeepProvider>
+  );
+}
+```
+
+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.

package/dist/index.d.ts

@@ -0,0 +1,128 @@
+import * as react from 'react';
+import { ReactNode, HTMLAttributes, ReactElement, FormHTMLAttributes } from 'react';
+import { KeepItem, KeepListOptions } 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 RenderProp<TState> = (state: TState) => ReactNode;
+type KeepButtonLabels = {
+    saved?: ReactNode;
+    unsaved?: ReactNode;
+    loading?: ReactNode;
+    error?: ReactNode;
+    savedAriaLabel?: string;
+    unsavedAriaLabel?: string;
+};
+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;
+    isMutating: boolean;
+    error: unknown | null;
+    remove: () => Promise<void>;
+};
+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;
+    imageAlt?: string;
+    render?: RenderProp<KeepItemCardState<TMeta>>;
+    children?: ReactNode | RenderProp<KeepItemCardState<TMeta>>;
+    removeLabel?: string;
+    onRemoveError?: (error: unknown) => void;
+    onRemoved?: (item: KeepItem<TMeta>) => void;
+    showSaveButton?: boolean;
+    saveButtonLabels?: KeepButtonLabels;
+    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>>;
+type KeepListState<TMeta = Record<string, unknown>> = UseKeepListResult<TMeta>;
+type KeepListProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    options?: KeepListOptions<TMeta>;
+    children?: ReactNode | RenderProp<KeepListState<TMeta>>;
+    renderItem?: (item: KeepItem<TMeta>, state: KeepListState<TMeta>) => ReactNode;
+    loading?: ReactNode | RenderProp<KeepListState<TMeta>>;
+    empty?: ReactNode | RenderProp<KeepListState<TMeta>>;
+    error?: ReactNode | RenderProp<KeepListState<TMeta>>;
+    itemCardProps?: Omit<KeepItemCardProps<TMeta>, "item" | "children" | "render">;
+    asChild?: boolean;
+};
+/** A list primitive with built-in loading, empty, error, and removal states. */
+declare function KeepList<TMeta = Record<string, unknown>>({ options, children, renderItem, loading, empty, error: errorContent, itemCardProps, asChild, className, ...rootProps }: KeepListProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+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"> & {
+    listOptions?: KeepListOptions<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;
+};
+/** An ARIA button group for tag filtering; consumers can connect value to KeepList options. */
+declare function KeepTagFilter<TMeta = Record<string, unknown>>({ listOptions, value: controlledValue, defaultValue, onChange, onValueChange, allLabel, ariaLabel, renderTag, render, children, asChild, className, ...rootProps }: KeepTagFilterProps<TMeta>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+type KeepNoteEditorState<TMeta = Record<string, unknown>> = {
+    item: KeepItem<TMeta>;
+    note: string;
+    setNote: (note: string) => void;
+    isDirty: boolean;
+    isSaving: boolean;
+    error: unknown | null;
+    save: () => Promise<void>;
+};
+type KeepNoteEditorProps<TMeta = Record<string, unknown>> = Omit<FormHTMLAttributes<HTMLFormElement>, "children" | "onSubmit"> & {
+    item: KeepItem<TMeta>;
+    label?: ReactNode;
+    saveLabel?: ReactNode;
+    placeholder?: string;
+    onSaved?: (note?: string) => void;
+    onSaveError?: (error: unknown) => void;
+    render?: RenderProp<KeepNoteEditorState<TMeta>>;
+    children?: ReactNode | RenderProp<KeepNoteEditorState<TMeta>>;
+    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>>;
+type KeepEmptyStateProps = Omit<HTMLAttributes<HTMLElement>, "children" | "title"> & {
+    title?: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    children?: ReactNode;
+    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>>;
+type KeepStatusValue = "idle" | "empty" | "loading" | "saving" | "syncing" | "error";
+type KeepStatusLabels = Partial<Record<KeepStatusValue, ReactNode>>;
+type KeepStatusState<TMeta = Record<string, unknown>> = {
+    status: KeepStatusValue;
+    error: unknown | null;
+    pendingCount: number;
+    items: KeepItem<TMeta>[];
+};
+type KeepStatusProps<TMeta = Record<string, unknown>> = Omit<HTMLAttributes<HTMLElement>, "children"> & {
+    status?: KeepStatusValue;
+    labels?: KeepStatusLabels;
+    children?: ReactNode | RenderProp<KeepStatusState<TMeta>>;
+    render?: RenderProp<KeepStatusState<TMeta>>;
+    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>>;
+
+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 };

package/dist/index.js

@@ -0,0 +1,365 @@
+"use client";
+
+// src/index.tsx
+import {
+  KeepButton as CoreKeepButton,
+  useKeepContext,
+  useKeepItem,
+  useKeepList
+} from "@keepkit/core/react";
+import {
+  cloneElement,
+  isValidElement,
+  useCallback,
+  useEffect,
+  useMemo,
+  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";
+function KeepButton({ labels, ...props }) {
+  const buttonState = useKeepItem(props.item.id, {
+    meta: props.item.meta,
+    targetType: props.item.targetType,
+    note: props.item.note,
+    tags: props.item.tags
+  });
+  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 (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";
+  };
+  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,
+      savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,
+      unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel
+    };
+    if (!customStateLabel) return /* @__PURE__ */ jsx(CoreKeepButton, { ...sharedProps2 });
+    const statefulProps2 = {
+      ...sharedProps2,
+      children: (state) => /* @__PURE__ */ jsx(Fragment, { children: getStateContent(state) })
+    };
+    return /* @__PURE__ */ jsx(CoreKeepButton, { ...statefulProps2 });
+  }
+  const sharedProps = {
+    ...props,
+    "aria-busy": props["aria-busy"] ?? (buttonState.isLoading || buttonState.isMutating),
+    savedLabel: labels?.saved ?? props.savedLabel,
+    unsavedLabel: labels?.unsaved ?? props.unsavedLabel,
+    savedAriaLabel: labels?.savedAriaLabel ?? props.savedAriaLabel,
+    unsavedAriaLabel: labels?.unsavedAriaLabel ?? props.unsavedAriaLabel
+  };
+  if (!customStateLabel) return /* @__PURE__ */ jsx(CoreKeepButton, { ...sharedProps });
+  const statefulProps = { ...sharedProps, children: (state) => getStateContent(state) };
+  return /* @__PURE__ */ jsx(CoreKeepButton, { ...statefulProps });
+}
+function KeepItemCard({
+  item,
+  title,
+  getImageUrl,
+  imageAlt,
+  render,
+  children,
+  removeLabel = "Remove",
+  onRemoveError,
+  onRemoved,
+  showSaveButton = true,
+  saveButtonLabels,
+  asChild = false,
+  className,
+  ...rootProps
+}) {
+  const itemState = useKeepItem(item.id);
+  const contentChildren = asChild && isValidElement(children) ? void 0 : children;
+  const state = {
+    item,
+    isSaved: itemState.isSaved,
+    isMutating: itemState.isMutating,
+    error: itemState.error,
+    remove: itemState.remove
+  };
+  const resolvedTitle = typeof title === "function" ? title(item) : title ?? getMetaTitle(item.meta) ?? item.id;
+  const imageUrl = getImageUrl?.(item);
+  async function handleRemove() {
+    try {
+      await itemState.remove();
+      onRemoved?.(item);
+    } catch (error) {
+      onRemoveError?.(error);
+    }
+  }
+  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,
+    /* @__PURE__ */ jsx("h3", { children: resolvedTitle }),
+    showSaveButton ? /* @__PURE__ */ jsx(
+      KeepButton,
+      {
+        item: toKeepButtonItem(item),
+        labels: saveButtonLabels,
+        getAriaLabel: (buttonState) => `${buttonState.isSaved ? "Remove" : "Save"} ${String(resolvedTitle)}`
+      }
+    ) : null,
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void handleRemove(), disabled: itemState.isMutating, children: removeLabel })
+  ] });
+  return renderRoot(
+    asChild,
+    isValidElement(children) ? children : void 0,
+    { ...rootProps, className, "aria-busy": itemState.isMutating || rootProps["aria-busy"] },
+    body,
+    "KeepItemCard"
+  );
+}
+function KeepList({
+  options,
+  children,
+  renderItem,
+  loading = "Loading saved items\u2026",
+  empty = "No saved items.",
+  error: errorContent = "Could not load saved items.",
+  itemCardProps,
+  asChild = false,
+  className,
+  ...rootProps
+}) {
+  const state = useKeepList(options);
+  const body = getListBody(state, { children, renderItem, loading, empty, error: errorContent, itemCardProps });
+  const root = asChild && isValidElement(children) ? children : void 0;
+  return renderRoot(
+    asChild,
+    root,
+    { ...rootProps, className, "aria-busy": state.isLoading || rootProps["aria-busy"] },
+    body,
+    "KeepList"
+  );
+}
+function getListBody(state, options) {
+  if (state.error && state.items.length === 0) return resolveContent(options.error, state);
+  if (state.isLoading && !state.isHydrated) return resolveContent(options.loading, state);
+  if (state.isHydrated && state.items.length === 0) return resolveContent(options.empty, state);
+  if (typeof options.children === "function") return options.children(state);
+  if (options.children !== void 0 && !isValidElement(options.children)) return options.children;
+  const items = state.items.map(
+    (item) => options.renderItem ? options.renderItem(item, state) : /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(KeepItemCard, { item, ...options.itemCardProps }) }, item.id)
+  );
+  return /* @__PURE__ */ jsx("ul", { children: items });
+}
+function KeepTagFilter({
+  listOptions,
+  value: controlledValue,
+  defaultValue,
+  onChange,
+  onValueChange,
+  allLabel = "All",
+  ariaLabel = "Filter saved items by tag",
+  renderTag,
+  render,
+  children,
+  asChild = false,
+  className,
+  ...rootProps
+}) {
+  const list = useKeepList(listOptions);
+  const contentChildren = asChild && isValidElement(children) ? void 0 : children;
+  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue);
+  const value = controlledValue ?? uncontrolledValue;
+  const select = useCallback(
+    (tag) => {
+      if (controlledValue === void 0) setUncontrolledValue(tag);
+      onChange?.(tag);
+      onValueChange?.(tag);
+    },
+    [controlledValue, onChange, onValueChange]
+  );
+  const state = useMemo(
+    () => ({ tags: list.tags, tagCounts: list.tagCounts, value, select }),
+    [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 }),
+    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: [
+        " (",
+        list.tagCounts[tag] ?? 0,
+        ")"
+      ] })
+    ] }, tag))
+  ] });
+  return renderRoot(
+    asChild,
+    isValidElement(children) ? children : void 0,
+    { ...rootProps, className },
+    body,
+    "KeepTagFilter"
+  );
+}
+function KeepNoteEditor({
+  item,
+  label = "Note",
+  saveLabel = "Save note",
+  placeholder,
+  onSaved,
+  onSaveError,
+  render,
+  children,
+  asChild = false,
+  className,
+  ...formProps
+}) {
+  const itemState = useKeepItem(item.id);
+  const contentChildren = asChild && isValidElement(children) ? void 0 : children;
+  const [note, setNote] = useState(item.note ?? "");
+  useEffect(() => setNote(itemState.item?.note ?? item.note ?? ""), [item.note, itemState.item?.note]);
+  const save = useCallback(async () => {
+    const nextNote = note.trim() || void 0;
+    try {
+      await itemState.updateNote(nextNote);
+      onSaved?.(nextNote);
+    } catch (error) {
+      onSaveError?.(error);
+      throw error;
+    }
+  }, [itemState, note, onSaveError, onSaved]);
+  const state = {
+    item,
+    note,
+    setNote,
+    isDirty: note !== (itemState.item?.note ?? item.note ?? ""),
+    isSaving: itemState.isMutating,
+    error: itemState.error,
+    save
+  };
+  const body = render ? render(state) : typeof contentChildren === "function" ? contentChildren(state) : contentChildren ?? /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("label", { children: [
+      label,
+      /* @__PURE__ */ jsx(
+        "textarea",
+        {
+          value: note,
+          onChange: (event) => setNote(event.currentTarget.value),
+          placeholder,
+          disabled: itemState.isMutating
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx("button", { type: "submit", disabled: itemState.isMutating, "aria-busy": itemState.isMutating, children: saveLabel })
+  ] });
+  const handleSubmit = (event) => {
+    event.preventDefault();
+    void save().catch(() => void 0);
+  };
+  return renderRoot(
+    asChild,
+    isValidElement(children) ? children : void 0,
+    { ...formProps, className, onSubmit: handleSubmit, "aria-busy": itemState.isMutating || formProps["aria-busy"] },
+    body,
+    "KeepNoteEditor"
+  );
+}
+function KeepEmptyState({
+  title = "No saved items",
+  description,
+  action,
+  children,
+  asChild = false,
+  className,
+  ...rootProps
+}) {
+  const contentChildren = asChild && isValidElement(children) ? void 0 : children;
+  const body = contentChildren ?? /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("h2", { children: title }),
+    description ? /* @__PURE__ */ jsx("p", { children: description }) : null,
+    action
+  ] });
+  return renderRoot(asChild, children, { ...rootProps, className }, body, "KeepEmptyState");
+}
+function KeepStatus({
+  status,
+  labels,
+  children,
+  render,
+  asChild = false,
+  className,
+  ...rootProps
+}) {
+  const context = useKeepContext();
+  const contentChildren = asChild && isValidElement(children) ? void 0 : children;
+  const resolvedStatus = status ?? getDerivedStatus(context);
+  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 role = rootProps.role ?? (resolvedStatus === "error" ? "alert" : "status");
+  return renderRoot(
+    asChild,
+    isValidElement(children) ? children : void 0,
+    { ...rootProps, className, role, "aria-live": rootProps["aria-live"] ?? "polite" },
+    body,
+    "KeepStatus"
+  );
+}
+function getDerivedStatus(context) {
+  if (context.error) return "error";
+  if (context.syncState.status === "pending" || context.syncState.status === "syncing") return "syncing";
+  if (context.isMutating) return "saving";
+  if (context.isLoading && !context.isHydrated) return "loading";
+  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 resolveContent(content, state) {
+  return typeof content === "function" ? content(state) : content;
+}
+function toKeepButtonItem(item) {
+  return {
+    id: item.id,
+    meta: item.meta,
+    targetType: item.targetType,
+    note: item.note,
+    tags: item.tags
+  };
+}
+function getMetaTitle(meta) {
+  if (typeof meta !== "object" || meta === null || !("title" in meta)) return void 0;
+  const title = meta.title;
+  return typeof title === "string" && title.trim() ? title.trim() : void 0;
+}
+function renderRoot(asChild, child, props, body, componentName) {
+  if (asChild) {
+    if (!isValidElement(child)) throw new Error(`${componentName} with asChild requires a single React element child.`);
+    return cloneElement(child, { ...props, children: body });
+  }
+  return /* @__PURE__ */ jsx("div", { ...props, children: body });
+}
+export {
+  KeepButton,
+  KeepEmptyState,
+  KeepItemCard,
+  KeepList,
+  KeepNoteEditor,
+  KeepProvider,
+  KeepStatus,
+  KeepTagFilter,
+  useKeepContext2 as useKeepContext,
+  useKeepItem2 as useKeepItem,
+  useKeepList2 as useKeepList
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@keepkit/ui",
+  "version": "0.3.0",
+  "description": "Headless, accessible React UI components for KeepKit.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nitta-a/keepkit.git",
+    "directory": "packages/keepkit-ui"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@keepkit/core": ">=0.2.0",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@keepkit/core": "0.3.0",
+    "@types/react": "^19.2.18",
+    "react": "^19.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "test": "node --experimental-strip-types --test test/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}