@q1travel/design-system 0.7.3 → 0.9.0

package/contracts/overlay-foundation.md

@@ -1,6 +1,6 @@
 # Overlay Foundation Contract
 
-> 状态：Accepted（O1–O7 已确认；仅允许进入 Foundation RED 阶段，未授权 GREEN 或生产实现）。
+> 状态：Accepted（O1–O7 已确认；Foundation GREEN 与首批组件接入已落地；D7 Web migration 与实际 ticket/blocking graph 仍 pending）。
 > Issue：[#27](https://github.com/q1travel/q1travel-design-system/issues/27)
 > 日期：2026-08-06
 > 所有者：`@q1travel/design-system`
@@ -19,9 +19,9 @@
 
 ## 2. 决策边界
 
-### 2.1 本稿确认
+### 2.1 D0/RED 阶段确认（历史边界）
 
-本稿已按 O1–O7 完成 ADR review，可作为 Foundation RED 阶段的行为约束。以下边界仍然有效：
+本稿已按 O1–O7 完成 ADR review，可作为 Foundation RED 阶段的行为约束。以下边界记录的是 D0/RED 阶段的授权范围；当前实现与 provenance 状态以 §7.1 为准：
 
 - 不修改现有 overlay 组件实现；
 - 不新增公开 `OverlayHost`、stack 或 hook API；
@@ -189,6 +189,19 @@ D7  q1travel-web adoption/migration
 - D6 不等于 npm publish；source、PR、CI/review、merge、registry/release、consumer adoption 和 production/smoke 是独立 gates。
 - D7 不属于本仓库 #27 的实现 PR；Web 只能在 package contract、发布和 consumer evidence 都满足后另行授权。
 
+### 7.1 当前实现与 acceptance/provenance closeout（2026-08-06）
+
+本节把 D0–D7 的当前事实与原始 ADR 边界分开记录，不把 package implementation、release、Web adoption 或 issue tracker 状态混为同一个 gate：
+
+- **D0 — ADR/contract：已完成。** O1–O7 已确认，本文件是当前 canonical contract。
+- **D1/D2 — Foundation RED/GREEN：已完成。** `9d0d56da527e66f3d2e793364bf0b2c9e2ebd828` 引入 shared `overlayCore`、`useOverlay` 与 Foundation runtime；当前 targeted runtime/browser contract `node --test scripts/check-overlay-foundation-red.test.mjs` 通过（2/2）。
+- **D3–D5 — 首批组件接入：实现已进入 main。** `Modal`、`DestructiveActionModal`、`Sheet`、`Drawer` 均通过 `useOverlay` 接入；Sheet 保持 `blocking=true/outsidePointer=false`，DestructiveActionModal 的 loading policy 保留。实现证据不等于已建立对应的独立 GitHub blocking tickets。
+- **D6 — package/release provenance：已完成。** 0.7.3 exact package source 为 `224f723f3a4e7bb3d5256ae2364783362b2f8eaf`，`v0.7.3` 已解析到该 source，registry provenance 已由 `b40a3b5ad49156c3d8b0409b226c15b37468f8c7` 写入 remote `main`。
+- **D7 — q1travel-web adoption/migration：pending。** 本次没有修改 Web，也没有把 Web migration 伪装成 package acceptance；Web 仍需独立 ticket、consumer evidence 与单独授权。
+- **Ticket graph：pending。** 当前 GitHub 中没有 Foundation、Modal、Sheet、Drawer、Web migration 的独立 blocking ticket 记录；本 contract 的 D3–D7 图是交付边界，不是 GitHub tracker 已建立的 blocking edges。
+
+因此，#27 的 package-side implementation/provenance evidence 已具备；issue acceptance 仍不能在缺少独立 ticket graph、contract 状态同步与 D7 Web gate 的情况下被解释为全链路完成。
+
 ## 8. 已确认的 ADR decisions
 
 以下结论已在本次 #27 review 中确认。它们定义 RED 阶段的边界，不授权生产实现：
@@ -205,7 +218,7 @@ D7  q1travel-web adoption/migration
 
 ## 9. 非目标
 
-- 不在本票中修复 Modal、Sheet、Drawer、DestructiveActionModal 的现有实现差异。
+- D0/RED 阶段不在本票中修复 Modal、Sheet、Drawer、DestructiveActionModal 的现有实现差异；当前 D2–D5 实现状态以 §7.1 为准。
 - 不在本票中新增动画、视觉 redesign、尺寸/radius/color token 或组件 API。
 - 不在本票中迁移 Web，也不以 Web PR、Web 测试通过或本地浏览器结果替代 package contract acceptance。
 - 不以关闭 #27、创建 PR、merge、publish 或 release 作为本 contract 的隐含后续动作。

package/contracts/pagination-migration.md

@@ -0,0 +1,97 @@
+# Pagination 公共 API 迁移合同
+
+Status: accepted locally
+
+Decision date: 2026-08-07
+
+Related: q1travel-design-system#26, #108, #109
+
+Published baseline: `@q1travel/design-system@0.7.3`
+
+Planned breaking release: `0.8.0`
+
+## Public naming decision
+
+`Pagination` → `DocsPagination` is the accepted documentation-navigation replacement.
+
+The published `Pagination` component in `0.7.3` is the documentation previous/next navigation rail. Its replacement is `DocsPagination`. The new product data-set component owns the public name `Pagination`.
+
+| Boundary | Public meaning | Consumer boundary |
+| --- | --- | --- |
+| `0.7.3` and earlier | `Pagination` means documentation previous/next navigation | Existing consumers remain on the published baseline. |
+| `0.8.0` candidate | `DocsPagination` means documentation previous/next navigation; `Pagination` means controlled product pagination | Consumers migrate their old documentation import to `DocsPagination`. |
+
+This is a breaking public API boundary. The candidate does not add a same-name compatibility alias or a fallback that makes one `Pagination` export mean two different contracts.
+
+## Pagination models
+
+The `0.8.0` candidate freezes two independent product models:
+
+- Known-total: controlled `page` and `onChange`, with either `total` or `totalPages`; numeric page controls and range summary are allowed.
+- Unknown-tail: controlled `page` and `onChange`, with `hasNextPage`; it does not fabricate `total`, a last page, or numeric page-window controls.
+- `true-cursor` remains deferred until a real consumer supplies the cursor ownership, request boundary, and acceptance evidence. It is not inferred from `total`, `page`, or `hasNextPage`.
+
+TypeScript is the public input boundary for the mutually exclusive models. The package does not own q1travel-web data fetching, query-string state, router navigation, or cursor token parsing.
+
+## #111 Shared slots and loading accessibility
+
+Status: accepted locally
+
+Decision date: 2026-08-07
+
+This contract applies to the current known-total and unknown-tail models. A future true-cursor model must reuse these shared semantics, but this decision does not add a cursor prop or infer cursor ownership before #110 supplies a real consumer and request boundary.
+
+### Shared public types
+
+`PaginationCommonProps` is the named public type for props shared by every product-pagination model. `PaginationSummaryArgs` remains the public callback input type. The model-specific types extend the common type and remain mutually exclusive.
+
+### Summary
+
+- The summary is rendered before the controls inside the named pagination `nav`.
+- The summary uses `aria-live="polite"` and `aria-atomic="true"`. Page changes and loading completion may update this region; consumer-provided text must be concise and stable enough to announce.
+- A summary callback receives `page`, `pageSize`, `total`, `totalPages`, `start`, and `end`. Unknown-tail supplies no fabricated `total` or `totalPages` and uses `start: 0` and `end: 0` unless the consumer supplies a different summary node.
+- The package owns the default summary formatting, but does not own data-fetching status or consumer-specific result wording.
+
+### `pageSizeSlot`
+
+- `pageSizeSlot` is a consumer-owned `ReactNode`, rendered before the pagination buttons in the controls region.
+- The package positions the node but does not create, control, label, or synchronize a page-size control.
+- If the slot contains an interactive control, the consumer must provide a programmatic label association, such as a `label`/`htmlFor` pair or `aria-label`/`aria-labelledby`. A bare text wrapper is not an accessible label contract.
+- The slot may wrap in compact or narrow layouts; the consumer remains responsible for the control's value, state, and update handling.
+
+### Loading, focus, and completion
+
+- While `loading` is true, the pagination `nav` exposes `aria-busy="true"` and the existing Spinner exposes the polite status text `加载中…`.
+- Structural boundary controls and empty-state controls remain natively disabled.
+- Actionable pagination controls remain focusable while loading and expose `aria-disabled="true"`. Their click and keyboard handlers are inert until loading ends. This preserves the user's current focus rather than moving focus to a newly rendered control.
+- The current-page marker and `aria-current="page"` remain stable while loading.
+- After a real loading-to-idle transition, a separate polite, atomic completion region announces `分页已更新`. The summary may additionally announce the new range or page.
+
+### Responsive and unavailable states
+
+- `compact` and the existing tokenized responsive layout own dense and narrow presentation; the shared semantics do not change at smaller widths.
+- `total={0}` exposes the existing `暂无数据` summary and does not fabricate page numbers.
+- Error or unavailable presentation is consumer-owned composition around `Pagination` (for example, an adjacent alert and a disabled/empty pagination state); #111 does not add an `error` or `unavailable` prop.
+
+### Required evidence
+
+The package contract must be backed by generated public declarations, a TypeScript consumer fixture, static markup assertions for summary/slot/busy semantics, and browser assertions for native keyboard activation, visible focus, loading `aria-disabled`, focus retention, completion announcement, empty state, and labelled page-size controls. Web migration, true-cursor adoption, publication, and issue closure remain independent gates.
+
+## Route and link ownership
+
+The documentation route `/components/pagination` is retained. It documents both the product `Pagination` boundary and the separate `DocsPagination` sequence-navigation boundary.
+
+`DocsPagination` accepts consumer-owned real `href` values and renders native links. It does not import a q1travel-web router or decide URL construction.
+
+## Compatibility, removal, and rollback
+
+- The compatibility window is the published `0.7.3` baseline: existing documentation-navigation consumers can remain on `Pagination` at that version while they migrate to `DocsPagination`.
+- The old documentation-navigation API is removed from the `Pagination` name only in the planned breaking `0.8.0` release. No same-version alias is added to the candidate.
+- Before publishing `0.8.0`, the release gate must verify the exact package tarball, generated declarations, known q1travel consumer migration, and a rollback path that pins the consumer to `0.7.3`.
+- Unknown third-party consumers cannot be enumerated from q1travel repositories; that limitation is part of the release risk and is not evidence that migration is complete.
+
+## Web migration gate
+
+q1travel-web migration remains a separate gate. This package candidate does not modify q1travel-web, does not claim consumer adoption, and does not publish or deploy. Web migration may start only after a verified published package release and a separately authorized consumer change.
+
+This contract records the public boundary; it does not perform the `0.8.0` version bump, npm publish, Web migration, issue closure, or production validation.

package/contracts/table-migration.md

@@ -0,0 +1,168 @@
+# Table 公共合同
+
+Status: accepted locally
+
+Decision date: 2026-08-08
+
+Related: q1travel-design-system#25
+
+This contract freezes the first public boundary for a shared `Table`. It records
+the behavior and ownership decisions needed before implementation; it does not
+implement the component, change q1travel-web, create migration tickets, or
+claim consumer adoption.
+
+## Public boundary
+
+`Table` is a consumer-controlled, native-semantic table. It renders the rows and
+columns supplied by the consumer, but it does not fetch data, own router state,
+infer a data-set selection, or implement pagination.
+
+The first implementation is split into three responsibilities:
+
+| Responsibility | Frozen public boundary | Ownership |
+| --- | --- | --- |
+| Core | `columns`, `data`, stable `rowKey`, native `table` / `thead` / `tbody` / `th` semantics, composed rows, and consumer-owned loading/empty/error content | Table owns structure and semantics; the consumer owns data and state content |
+| Interaction | Controlled selection, current-page select-all, bulk actions, action columns, and keyboard-operable row activation | The consumer owns selected state and action effects; Table owns selection wiring and accessible interaction states |
+| Layout and data behavior | Controlled sorting with `aria-sort`, `stickyHeader`, `maxBodyHeight`, explicit density, `minWidth`, column-group composition, `renderRow`, and `showHeader` | Table owns layout wiring and state attributes; the consumer owns sort state, render decisions, and data ordering |
+
+The public component must not require a business-specific workflow, request
+library, router, or product-side data model.
+
+## Core contract
+
+- `columns` and `data` are consumer-owned inputs. A column identifies its
+  heading and cell rendering without requiring Table to know the domain model.
+- `rowKey` is a stable consumer-owned key. Table must not use the array index as
+  the identity for selection, updates, or row activation.
+- The default structure uses native table elements and `th scope="col"`.
+  Table does not promote the surface to `role="grid"` or add arrow-key grid
+  navigation in this contract.
+- `renderRow` and composed cells may extend row presentation, but they must
+  preserve the table's heading, cell, focus, and selection semantics.
+- Loading, empty, and error states are explicit consumer-owned surfaces. Table
+  must not invent fetch status, error copy, recovery actions, or business
+  permissions. An empty result may be rendered as an adjacent Empty State
+  rather than as an artificial table row.
+- `showHeader` is a presentation option, not permission to remove the
+  accessible relationship between cells and their column headings. A consumer
+  that hides the visual header remains responsible for an accessible table
+  name and header semantics.
+
+The current documentation-only `striped`, `bordered`, `divided`, `interactive`,
+and virtualized specimens do not automatically become public variant props.
+They remain evidence and comparison material until a consumer-backed contract
+requires each capability.
+
+## Controlled interaction contract
+
+### Selection
+
+- Selection is controlled by the consumer. Table receives the selected row keys
+  and reports the next selected-key collection through its change callback; it
+  does not keep an independent authoritative selection store.
+- A row is selectable only when the consumer exposes it as selectable. Selection
+  controls use native checkboxes with accessible names and a visible
+  `:focus-visible` state.
+- The header select-all control operates on the currently rendered/selectable
+  page only.
+- Selecting all adds the selectable keys visible on the current page to the
+  consumer's existing selected keys. Clearing all removes only those current
+  page keys. Keys belonging to other pages are preserved in both operations.
+- The header state is derived from current-page selectable rows: unchecked when
+  none are selected, mixed when only some are selected, and checked when all
+  current-page selectable rows are selected.
+- Table must not infer that the entire data set is selected, emit a hidden
+  "select all pages" sentinel, fetch other pages, or rewrite keys it cannot see.
+- Bulk actions and action-column content are consumer-provided. Table may
+  expose the current selection boundary to the action surface, but it does not
+  execute business mutations or decide confirmation, retry, or success copy.
+
+### Row activation
+
+- A consumer may provide row activation. The activation target must be
+  keyboard-operable with the same outcome as pointer activation and must expose
+  a visible focus state.
+- Enter and Space activation must not be implemented by turning the entire
+  table into a grid. Arrow-key row navigation, roving focus, and cell editing
+  are outside this first contract.
+- A row action must not conflict with a nested native link, button, checkbox,
+  or other interactive cell control; nested controls retain their native
+  behavior.
+
+### Sorting
+
+- Sorting is controlled: the consumer owns the active sort key and direction,
+  receives the sort-change event, and owns data ordering or server requests.
+- A sortable heading is a native button inside the heading cell. The heading
+  exposes `aria-sort` with the applicable `none`, `ascending`, or `descending`
+  value. The sort icon is decorative and is not the only state cue.
+- Table does not silently sort data, fetch a new page, mutate URL/query state,
+  or fabricate a total while sorting.
+
+## Layout and responsive contract
+
+- `density` is explicit consumer input; Table must not infer density from a
+  parent page or from being rendered inside a data surface.
+- `stickyHeader` and `maxBodyHeight` are layout capabilities. When they create a
+  scroll region, the region must remain usable with keyboard focus and must not
+  create an unnecessary second scrollbar.
+- `minWidth` and column-group composition are consumer-visible layout inputs;
+  intrinsic table sizing remains the default and JavaScript measurement is not
+  required for normal layout.
+- The implementation must remain usable at small, laptop, desktop, and wide
+  widths, with horizontal overflow owned by the table surface when columns
+  cannot fit.
+- Light and dark themes use canonical q1travel tokens. No Web page-local
+  `--ds-*` token becomes a new public Table token.
+
+## Accessibility and state evidence
+
+The component follows the existing native-semantic accessibility bar:
+
+- native table structure and column-heading relationships;
+- native buttons, links, and checkboxes for interactive cells;
+- visible focus for every focusable control;
+- accessible names for select-all, row, and action controls;
+- redundant selected, sorted, loading, empty, and error cues;
+- consumer-owned async announcements and recovery actions where state changes.
+
+The implementation gate must add generated public declarations, a TypeScript
+consumer fixture, package-level markup assertions, and browser evidence for:
+
+1. controlled selection and current-page select-all while preserving off-page
+   keys;
+2. indeterminate and checked header states;
+3. sortable headings and `aria-sort` transitions through native keyboard input;
+4. row activation, nested-control isolation, focus visibility, and disabled
+   rows/controls where applicable;
+5. loading, empty, error, dense, narrow, light, and dark states; and
+6. sticky/max-height behavior without losing focus or introducing an unwanted
+   scroll trap.
+
+The existing Table documentation page and its browser checks prove only the
+page-local specimen. They are not package or consumer evidence for this
+contract.
+
+## Pagination and migration boundary
+
+- `Table` receives the visible data it must render and does not own `page`,
+  `pageSize`, `total`, cursor tokens, query-string state, or data fetching.
+- Dataset pagination is composed with the public `Pagination` component;
+  documentation sequence navigation remains the separate `DocsPagination`
+  boundary.
+- The current-page select-all rule remains valid when the consumer changes
+  pages: off-page selected keys stay in the consumer's controlled collection,
+  while the header state is recalculated from the newly visible page.
+- q1travel-web migration is a separate gate. It may begin only after the
+  package export, generated types, focused tests, published package identity,
+  and consumer adoption have each been independently verified.
+- This contract does not modify q1travel-web, publish the package, migrate a
+  consumer, close #25, or create implementation issues.
+
+## Implementation sequence
+
+`Table core` → `Interaction` → `Layout` → `export/types/tests` → `published
+package verification` → `q1travel-web migration`
+
+Each arrow is a separate acceptance gate. A passing documentation specimen,
+local package build, or source-level assertion does not establish the next gate.

package/dist-pkg/design-system.d.ts

@@ -1,6 +1,7 @@
 import { AnchorHTMLAttributes } from 'react';
 import { ButtonHTMLAttributes } from 'react';
 import { ComponentPropsWithoutRef } from 'react';
+import { CSSProperties } from 'react';
 import { FocusEventHandler } from 'react';
 import { HTMLAttributes } from 'react';
 import { InputHTMLAttributes } from 'react';
@@ -12,6 +13,7 @@ import { ReactNode } from 'react';
 import { Ref } from 'react';
 import { RefObject } from 'react';
 import { SelectHTMLAttributes } from 'react';
+import { TableHTMLAttributes } from 'react';
 import { TextareaHTMLAttributes } from 'react';
 
 export declare function addDays(date: Date, amount: number): Date;
@@ -637,6 +639,18 @@ export declare function DestructiveActionModal({ open, onClose, title, descripti
     onConfirm: () => string | null;
 }): ReactNode;
 
+export declare type DocsPageLink = {
+    title: string;
+    href: string;
+};
+
+export declare function DocsPagination({ previous, next }: DocsPaginationProps): JSX.Element;
+
+export declare type DocsPaginationProps = {
+    previous?: DocsPageLink;
+    next?: DocsPageLink;
+};
+
 export declare function DotsMenu({ entries, size, disabled, align, }: {
     entries: DotsMenuEntry[];
     size?: 'sm' | 'md' | 'lg';
@@ -829,6 +843,18 @@ export declare function Kbd({ meta, shift, alt, ctrl, small, children, }: {
     children?: ReactNode;
 }): JSX.Element;
 
+export declare type KnownTotalPaginationProps = PaginationCommonProps & ({
+    total: number;
+    totalPages?: never;
+    hasNextPage?: never;
+    showPageNumbers?: boolean;
+} | {
+    total?: never;
+    totalPages: number;
+    hasNextPage?: never;
+    showPageNumbers?: boolean;
+});
+
 export declare function Label({ htmlFor, required, children, }: {
     htmlFor?: string;
     required?: boolean;
@@ -997,14 +1023,31 @@ declare type NoteSize = 'small' | 'default' | 'large';
 
 export declare type NoteTone = 'info' | 'success' | 'warning' | 'error' | 'secondary';
 
-declare type PageLink = {
-    title: string;
+export declare function Pagination({ page, pageSize: pageSizeProp, total, totalPages: totalPagesProp, hasNextPage, onChange, loading, showPageNumbers, summary, pageSizeSlot, prevLabel, nextLabel, compact, className, }: PaginationProps): JSX.Element;
+
+export declare type PaginationCommonProps = {
+    page: number;
+    pageSize?: number;
+    onChange: (page: number) => void;
+    loading?: boolean;
+    summary?: ReactNode | ((args: PaginationSummaryArgs) => ReactNode);
+    pageSizeSlot?: ReactNode;
+    prevLabel?: string;
+    nextLabel?: string;
+    compact?: boolean;
+    className?: string;
 };
 
-export declare function Pagination({ previous, next }: {
-    previous?: PageLink;
-    next?: PageLink;
-}): JSX.Element;
+export declare type PaginationProps = KnownTotalPaginationProps | UnknownTailPaginationProps;
+
+export declare type PaginationSummaryArgs = {
+    page: number;
+    totalPages?: number;
+    total?: number;
+    pageSize: number;
+    start: number;
+    end: number;
+};
 
 export declare function PeriodCombobox({ presets, activeLabel, onPick, }: {
     presets: CalendarPreset[];
@@ -1318,6 +1361,70 @@ export declare type TabItem = {
     tooltip?: string;
 };
 
+export declare function Table<T>({ data, columns, rowKey, caption, density, stickyHeader, maxBodyHeight, minWidth, colGroup, renderRow, showHeader, sortKey, sortDirection, onSortChange, selection, actions, bulkActions, bulkActionsLabel, rowActivation, className: consumerClassName, style: consumerStyle, ...nativeProps }: TableProps<T>): JSX.Element;
+
+export declare type TableActions<T> = {
+    header: ReactNode;
+    render: (row: T, rowIndex: number) => ReactNode;
+};
+
+export declare type TableColumn<T> = {
+    key: string;
+    header: ReactNode;
+    render: (row: T, rowIndex: number) => ReactNode;
+    sortable?: boolean;
+    sortLabel?: string;
+};
+
+export declare type TableDensity = 'comfortable' | 'compact';
+
+export declare type TableProps<T> = {
+    data: readonly T[];
+    columns: readonly TableColumn<T>[];
+    rowKey: (row: T, rowIndex: number) => TableRowKey;
+    caption?: ReactNode;
+    density?: TableDensity;
+    stickyHeader?: boolean;
+    maxBodyHeight?: CSSProperties['maxHeight'];
+    minWidth?: CSSProperties['minWidth'];
+    colGroup?: ReactNode;
+    renderRow?: (row: T, context: TableRowRenderContext<T>) => ReactNode;
+    showHeader?: boolean;
+    sortKey?: string;
+    sortDirection?: TableSortDirection;
+    onSortChange?: (key: string, direction: TableSortDirection) => void;
+    selection?: TableSelection<T>;
+    actions?: TableActions<T>;
+    bulkActions?: ReactNode;
+    bulkActionsLabel?: string;
+    rowActivation?: TableRowActivation<T>;
+} & Omit<TableHTMLAttributes<HTMLTableElement>, 'children'>;
+
+export declare type TableRowActivation<T> = {
+    getRowLabel: (row: T, rowIndex: number) => string;
+    onActivate: (row: T, rowIndex: number) => void;
+};
+
+export declare type TableRowKey = string | number;
+
+export declare type TableRowRenderContext<T> = {
+    row: T;
+    rowIndex: number;
+    rowKey: TableRowKey;
+    rowProps: TableHTMLAttributes<HTMLTableRowElement>;
+    cells: ReactNode;
+};
+
+export declare type TableSelection<T> = {
+    selectedKeys: readonly TableRowKey[];
+    onSelectionChange: (selectedKeys: TableRowKey[]) => void;
+    getRowLabel: (row: T, rowIndex: number) => string;
+    getRowDisabled?: (row: T, rowIndex: number) => boolean;
+    selectAllLabel?: string;
+};
+
+export declare type TableSortDirection = 'asc' | 'desc';
+
 export declare function Tabs({ tabs, ariaLabel, variant, }: {
     tabs: TabItem[];
     ariaLabel: string;
@@ -1424,6 +1531,13 @@ declare type TooltipTriggerProps = {
 
 export declare type TriggerKind = 'default' | 'compact';
 
+export declare type UnknownTailPaginationProps = PaginationCommonProps & {
+    total?: never;
+    totalPages?: never;
+    hasNextPage: boolean;
+    showPageNumbers?: false;
+};
+
 export declare function useCopy(): {
     copied: boolean;
     copy: (value: string, successMessage?: string) => Promise<void>;