@inkbar/react 0.8.0 → 0.10.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { ComponentPropsWithoutRef, ReactNode, Ref } from "react";
-import { Annotation, AnnotationChange, AnnotationDefaults, AnnotationDocument, AnnotationInput, AnnotationPatch, CurrentStyle, DocumentSource, FieldValues, FieldsChange, FormAction, FormField, FormSetResult, ImportOptions, InkDocument, InkError, InkStatus, PageInfo, PdfAssets, PluginHistory, Readable, SignatureLibrary, SignatureStore, SignatureTemplate, StyleGroup, StyleKey, StyleProps, Writable } from "@inkbar/core";
-import { AnnotationDecoration, AnnotationSlotProps, AnnotationSlotProps as AnnotationSlotProps$1, AnnotationState, ColorProperty, DecorateAnnotation, DecorateAnnotation as DecorateAnnotation$1, InkPlugin, InkPlugin as InkPlugin$1, LayoutMode, PageMount, PluginHost, SearchController, SearchState, ThreadPopoverSlotProps, ThreadPopoverSlotProps as ThreadPopoverSlotProps$1, Tool, ToolController, ToolId, ToolOptions, ToolStyle, ViewRotation, ViewerSearch, Viewport, ZoomValue } from "@inkbar/core/dom";
+import { Annotation, AnnotationChange, AnnotationDefaults, AnnotationDocument, AnnotationInput, AnnotationPatch, CurrentStyle, DocumentSource, FieldValues, FieldsChange, FormAction, FormField, FormSetResult, ImportOptions, InkDocument, InkError, InkStatus, PageInfo, PdfAssets, PluginHistory, Readable, RecordBase, SignatureLibrary, SignatureStore, SignatureTemplate, StyleGroup, StyleKey, StyleProps, Writable } from "@inkbar/core";
+import { AnnotationDecoration, AnnotationSlotProps, AnnotationSlotProps as AnnotationSlotProps$1, AnnotationState, CardSpec, CardSpec as CardSpec$1, ColorProperty, DecorateAnnotation, DecorateAnnotation as DecorateAnnotation$1, HostRecords, HostRecords as HostRecords$1, InkPlugin, InkPlugin as InkPlugin$1, LayoutMode, PageMount, PluginHost, RecordListSource, SearchController, SearchState, SidebarLayout, SidebarLayout as SidebarLayout$1, SidebarOpen, SidebarOpen as SidebarOpen$1, SidebarSide, SidebarSide as SidebarSide$1, ThreadPopoverSlotProps, ThreadPopoverSlotProps as ThreadPopoverSlotProps$1, Tool, ToolController, ToolId, ToolOptions, ToolStyle, ViewRotation, ViewerSearch, Viewport, ZoomValue } from "@inkbar/core/dom";
 import { Select, Toolbar } from "radix-ui";
 import { IconNode } from "@inkbar/icons";
 //#region src/context.d.ts
@@ -51,6 +51,13 @@ interface InkContext {
   setTool: (id: ToolId) => void;
   /** Host tools from InkRoot's `tools` prop; InkViewport registers them. */
   hostTools: Tool[] | undefined;
+  /**
+   * The ids of the tools the current viewer was built with, set by InkViewport through
+   * `setOpenedToolIds`; `null` while there is none. A tool added to `tools` later is
+   * registered from the next build.
+   */
+  openedToolIds: readonly ToolId[] | null;
+  setOpenedToolIds: (ids: readonly ToolId[] | null) => void;
   /**
    * Calls InkRoot's current `decorateAnnotation` prop. The function itself stays the same
    * across renders, so a new prop does not re-render the context's consumers.
@@ -156,6 +163,7 @@ export declare function useAnnotations(): {
     id: string;
     page: number;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -179,6 +187,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "text";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -227,6 +236,7 @@ export declare function useAnnotations(): {
     fontSize?: undefined;
     align?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     cornerRadius?: number | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -252,6 +262,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "square";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     cornerRadius?: number | undefined;
@@ -279,6 +290,7 @@ export declare function useAnnotations(): {
     type: "circle";
     cornerRadius?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -312,6 +324,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "line";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
     tail?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -342,6 +355,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "polyline";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -375,6 +389,7 @@ export declare function useAnnotations(): {
     head?: undefined;
     tail?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -405,6 +420,7 @@ export declare function useAnnotations(): {
     type: "ink";
     pressure?: number[][] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -429,6 +445,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "stamp";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     rotation?: 0 | 90 | 180 | 270 | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -454,6 +471,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "loupe";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -478,6 +496,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "mask";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -519,6 +538,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -561,6 +581,7 @@ export declare function useAnnotations(): {
     id: string;
     page: number;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -584,6 +605,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "text";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -632,6 +654,7 @@ export declare function useAnnotations(): {
     fontSize?: undefined;
     align?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     cornerRadius?: number | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -657,6 +680,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "square";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     cornerRadius?: number | undefined;
@@ -684,6 +708,7 @@ export declare function useAnnotations(): {
     type: "circle";
     cornerRadius?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -717,6 +742,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "line";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
     tail?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -747,6 +773,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "polyline";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -780,6 +807,7 @@ export declare function useAnnotations(): {
     head?: undefined;
     tail?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -810,6 +838,7 @@ export declare function useAnnotations(): {
     type: "ink";
     pressure?: number[][] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -834,6 +863,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "stamp";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     rotation?: 0 | 90 | 180 | 270 | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -859,6 +889,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "loupe";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -883,6 +914,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "mask";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -924,6 +956,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -968,6 +1001,7 @@ export declare function useAnnotations(): {
     id: string;
     page: number;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -991,6 +1025,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "text";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1039,6 +1074,7 @@ export declare function useAnnotations(): {
     fontSize?: undefined;
     align?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     cornerRadius?: number | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1064,6 +1100,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "square";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     cornerRadius?: number | undefined;
@@ -1091,6 +1128,7 @@ export declare function useAnnotations(): {
     type: "circle";
     cornerRadius?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -1124,6 +1162,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "line";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
     tail?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1154,6 +1193,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "polyline";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1187,6 +1227,7 @@ export declare function useAnnotations(): {
     head?: undefined;
     tail?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -1217,6 +1258,7 @@ export declare function useAnnotations(): {
     type: "ink";
     pressure?: number[][] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1241,6 +1283,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "stamp";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     rotation?: 0 | 90 | 180 | 270 | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1266,6 +1309,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "loupe";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1290,6 +1334,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "mask";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1331,6 +1376,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1374,6 +1420,7 @@ export declare function useAnnotations(): {
     id: string;
     page: number;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1397,6 +1444,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "text";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1445,6 +1493,7 @@ export declare function useAnnotations(): {
     fontSize?: undefined;
     align?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     cornerRadius?: number | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1470,6 +1519,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "square";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     cornerRadius?: number | undefined;
@@ -1497,6 +1547,7 @@ export declare function useAnnotations(): {
     type: "circle";
     cornerRadius?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -1530,6 +1581,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "line";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
     tail?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1560,6 +1612,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "polyline";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1593,6 +1646,7 @@ export declare function useAnnotations(): {
     head?: undefined;
     tail?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -1623,6 +1677,7 @@ export declare function useAnnotations(): {
     type: "ink";
     pressure?: number[][] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1647,6 +1702,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "stamp";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     rotation?: 0 | 90 | 180 | 270 | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1672,6 +1728,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "loupe";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1696,6 +1753,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "mask";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1737,6 +1795,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1779,6 +1838,7 @@ export declare function useAnnotations(): {
     id: string;
     page: number;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1802,6 +1862,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "text";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -1850,6 +1911,7 @@ export declare function useAnnotations(): {
     fontSize?: undefined;
     align?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     cornerRadius?: number | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1875,6 +1937,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "square";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     cornerRadius?: number | undefined;
@@ -1902,6 +1965,7 @@ export declare function useAnnotations(): {
     type: "circle";
     cornerRadius?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -1935,6 +1999,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "line";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
     tail?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1965,6 +2030,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "polyline";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -1998,6 +2064,7 @@ export declare function useAnnotations(): {
     head?: undefined;
     tail?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -2028,6 +2095,7 @@ export declare function useAnnotations(): {
     type: "ink";
     pressure?: number[][] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2052,6 +2120,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "stamp";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     rotation?: 0 | 90 | 180 | 270 | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2077,6 +2146,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "loupe";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -2101,6 +2171,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "mask";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -2142,6 +2213,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2185,6 +2257,7 @@ export declare function useAnnotations(): {
     id: string;
     page: number;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -2208,6 +2281,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "text";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -2256,6 +2330,7 @@ export declare function useAnnotations(): {
     fontSize?: undefined;
     align?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     cornerRadius?: number | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -2281,6 +2356,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "square";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     cornerRadius?: number | undefined;
@@ -2308,6 +2384,7 @@ export declare function useAnnotations(): {
     type: "circle";
     cornerRadius?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -2341,6 +2418,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "line";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
     tail?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -2371,6 +2449,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "polyline";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     head?: (string & {}) | "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash" | undefined;
@@ -2404,6 +2483,7 @@ export declare function useAnnotations(): {
     head?: undefined;
     tail?: undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     interiorColor?: string | undefined;
     author?: string | undefined;
@@ -2434,6 +2514,7 @@ export declare function useAnnotations(): {
     type: "ink";
     pressure?: number[][] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     dashes?: number[] | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2458,6 +2539,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "stamp";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     rotation?: 0 | 90 | 180 | 270 | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2483,6 +2565,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "loupe";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -2507,6 +2590,7 @@ export declare function useAnnotations(): {
     page: number;
     type: "mask";
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     author?: string | undefined;
     contents?: string | undefined;
     inReplyTo?: string | undefined;
@@ -2548,6 +2632,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2693,6 +2778,30 @@ interface FormHandle {
 /** The open document's form: its fields, their values, and `set` and `reset`. */
 export declare function useForm(): FormHandle;
 //#endregion
+//#region src/hooks/useRecords.d.ts
+/**
+ * The records a plugin keeps under `key` (`<plugin>.<name>`), for host components: the live list
+ * for the open document, and the handle to read and write them, each write one undo step.
+ * Plugins are set up once InkRoot has mounted, so until then (and on the server) `handle` is
+ * null and `records` is empty. `T` is the plugin's record type.
+ */
+export declare function useRecords<T extends RecordBase>(key: string): {
+  records: readonly T[];
+  handle: HostRecords$1<T> | null;
+};
+//#endregion
+//#region src/hooks/useRecordSelection.d.ts
+/**
+ * The selected record under `key` (`<plugin>.<name>`): the one selection the marks and every
+ * record list over those records share. `select` takes an id, or null to clear; an id that has
+ * no mark changes nothing. Until InkRoot has mounted (and on the server) nothing is selected
+ * and `select` does nothing.
+ */
+export declare function useRecordSelection(key: string): {
+  selected: string | null;
+  select: (id: string | null) => void;
+};
+//#endregion
 //#region src/components/InkRoot.d.ts
 interface InkRootHandle {
   readonly document: InkDocument | null;
@@ -2733,8 +2842,13 @@ interface InkRootProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'
   tool?: ToolId | undefined;
   onToolChange?: ((tool: ToolId) => void) | undefined;
   /**
-   * Host tools, added to the built-ins; one with a built-in's id replaces it. Read when a
-   * document opens.
+   * The creation tools, such as `allTools()` or a pick of the tool factories. `select-text`
+   * and `select` are always present; a tool with either id replaces it. They are read when a
+   * document opens: a tool added later is usable from the next open, one removed stops at
+   * once. When the active tool goes, the viewer switches to `select-text` and calls
+   * `onToolChange`. A controlled `tool` naming a missing tool is reported back as
+   * `select-text` and is not applied again when the tool appears later. Each mounted control
+   * for a missing tool logs its own `UnknownTool`.
    */
   tools?: Tool[] | undefined;
   /**
@@ -2876,6 +2990,16 @@ interface InkCommandProps extends Omit<ComponentPropsWithoutRef<'button'>, 'id'
 }
 export declare function InkCommand({ id, asChild, children, disabled, onClick, ...rest }: InkCommandProps): import("react").JSX.Element;
 //#endregion
+//#region src/components/InkToolbarButton.d.ts
+interface InkToolbarButtonProps extends ComponentPropsWithoutRef<'button'> {
+  asChild?: boolean;
+}
+/**
+ * Your own button in an `InkToolbar`. It joins the toolbar's arrow-key focus and takes the
+ * theme's toolbar button styles; what it shows and does is up to you.
+ */
+export declare function InkToolbarButton({ asChild, type, className, ...rest }: InkToolbarButtonProps): import("react").JSX.Element;
+//#endregion
 //#region src/components/InkToolbarSeparator.d.ts
 type InkToolbarSeparatorProps = ComponentPropsWithoutRef<'div'>;
 /**
@@ -2893,6 +3017,30 @@ interface InkHistoryButtonProps extends ComponentPropsWithoutRef<'button'> {
 //#region src/components/InkUndo.d.ts
 export declare function InkUndo({ asChild, className, children, disabled, onClick, ...rest }: InkHistoryButtonProps): import("react").JSX.Element;
 //#endregion
+//#region src/components/InkDownloadButton.d.ts
+interface InkDownloadButtonProps extends ComponentPropsWithoutRef<'button'> {
+  asChild?: boolean;
+  /** The name to save under. Default: the document's `fileName`. */
+  filename?: string | undefined;
+}
+/**
+ * Saves the open document's file through the browser's download, under its `fileName` or
+ * `filename`. Disabled until the document is ready. Today that is the file as it was opened,
+ * without this session's annotations.
+ */
+export declare function InkDownloadButton({ asChild, filename, className, children, disabled, onClick, ...rest }: InkDownloadButtonProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/InkPrintButton.d.ts
+interface InkPrintButtonProps extends ComponentPropsWithoutRef<'button'> {
+  asChild?: boolean;
+}
+/**
+ * Prints the open document's file with the browser's own PDF viewer (on iOS, in a new tab).
+ * Disabled until the document is ready. Today that is the file as it was opened, without this
+ * session's annotations.
+ */
+export declare function InkPrintButton({ asChild, className, children, disabled, onClick, ...rest }: InkPrintButtonProps): import("react").JSX.Element;
+//#endregion
 //#region src/components/InkRedo.d.ts
 export declare function InkRedo({ asChild, className, children, disabled, onClick, ...rest }: InkHistoryButtonProps): import("react").JSX.Element;
 //#endregion
@@ -2985,7 +3133,8 @@ interface InkShapeMenuProps extends Omit<ComponentPropsWithoutRef<'div'>, 'child
   /** Replaces the main button's icon. */
   children?: ReactNode;
 }
-export declare function InkShapeMenu({ className, children, ...rest }: InkShapeMenuProps): import("react").JSX.Element;
+/** Renders nothing while no `shape` tool is registered. */
+export declare function InkShapeMenu(props: InkShapeMenuProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/components/InkSignatureMenu.d.ts
 interface InkSignatureMenuProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
@@ -2994,7 +3143,8 @@ interface InkSignatureMenuProps extends Omit<ComponentPropsWithoutRef<'div'>, 'c
   /** The fonts the dialog's Type tab offers. Default: InkRoot's `signatureFonts`. */
   fonts?: readonly string[] | undefined;
 }
-export declare function InkSignatureMenu({ className, children, fonts, ...rest }: InkSignatureMenuProps): import("react").JSX.Element;
+/** Renders nothing while no `signature` tool is registered. */
+export declare function InkSignatureMenu(props: InkSignatureMenuProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/components/InkSignatureDialog.d.ts
 interface InkSignatureDialogProps {
@@ -3003,8 +3153,9 @@ interface InkSignatureDialogProps {
   /** The fonts the Type tab offers. Default: InkRoot's `signatureFonts`. */
   fonts?: readonly string[] | undefined;
   /**
-   * Whether saving selects the new signature for the `signature` tool. Default true. False
-   * leaves the tool alone, for a dialog that signs a field with it through `onSave`.
+   * Whether saving selects the new signature for the `signature` tool, when one is registered.
+   * Default true. False leaves the tool alone, for a dialog that signs a field with it through
+   * `onSave`.
    */
   select?: boolean | undefined;
   /** Called with the new template once it is saved (and selected, with `select`). */
@@ -3020,7 +3171,8 @@ interface InkHighlightMenuProps extends Omit<ComponentPropsWithoutRef<'div'>, 'c
   /** Replaces the main button's icon. */
   children?: ReactNode;
 }
-export declare function InkHighlightMenu({ className, children, ...rest }: InkHighlightMenuProps): import("react").JSX.Element;
+/** Renders nothing while no `highlight` tool is registered. */
+export declare function InkHighlightMenu(props: InkHighlightMenuProps): import("react").JSX.Element | null;
 //#endregion
 //#region src/components/InkTextStyleMenu.d.ts
 interface InkTextStyleMenuProps extends Omit<ComponentPropsWithoutRef<'button'>, 'children'> {
@@ -3040,5 +3192,168 @@ interface InkThreadPopoverProps {
 }
 export declare function InkThreadPopover({ children }: InkThreadPopoverProps): import("react").JSX.Element;
 //#endregion
-export type { AnnotationDecoration, AnnotationSlotProps, AnnotationState, CommandHandle, DecorateAnnotation, FormHandle, InkAnnotationProps, InkColorMenuProps, InkCommandProps, InkContext, InkFindBarProps, InkHighlightMenuProps, InkHistory, InkHistoryButtonProps, InkIconProps, InkLineStyleMenuProps, InkPageButtonProps, InkPageInputProps, InkPageProps, InkPlugin, InkRootHandle, InkRootProps, InkSearchButtonProps, InkShapeMenuProps, InkSignatureDialogProps, InkSignatureMenuProps, InkStatus, InkTextStyleMenuProps, InkThreadPopoverProps, InkToolButtonProps, InkToolbarProps, InkToolbarSeparatorProps, InkViewportProps, InkZoomButtonProps, InkZoomSelectProps, ScopedToolStyleHandle, ThreadPopoverSlotProps, ToolStyleHandle };
+//#region src/components/InkSidebar.d.ts
+interface InkSidebarProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+  /** Which edge the rail and border sit on. Default `'left'`. */
+  side?: SidebarSide$1 | undefined;
+  /** `'rail'` (default), `'tabs'` or `'stack'`. */
+  layout?: SidebarLayout$1 | undefined;
+  /** Default true. False hides the whole sidebar and keeps its open panel, content and scroll for when it shows again. */
+  visible?: boolean | undefined;
+  /**
+   * Controlled: the open panel's id (or null) for rail and tabs, the expanded ids for stack.
+   * Leave it out for an uncontrolled sidebar.
+   */
+  open?: SidebarOpen$1 | undefined;
+  /** Uncontrolled: what starts open. Left out, the first panel does. */
+  defaultOpen?: SidebarOpen$1 | undefined;
+  /** Called with the new value when a trigger is activated or the open panel goes. */
+  onOpenChange?: ((open: SidebarOpen$1) => void) | undefined;
+  /** The `InkPanel`s. */
+  children?: ReactNode;
+}
+/**
+ * A sidebar of `InkPanel`s: `createSidebar`'s markup on core's sidebar controller, which holds
+ * the open state, the ARIA, the keys and the clicks. Rail and tabs render their triggers here;
+ * in a stack each panel renders its own header. Panels take their place in DOM order, so a
+ * panel rendered later slots in where it stands. A closed panel stays mounted and hidden, and
+ * the panels' content stays in place across layouts, so its state survives switching.
+ *
+ * `open` with `onOpenChange` controls it; `defaultOpen` starts it uncontrolled; with neither,
+ * the first panel starts open. It needs no document, so it works outside `InkRoot`. The server
+ * renders the root, the panels (the open one shown) and the stack headers; rail and tab
+ * buttons follow once mounted.
+ */
+export declare function InkSidebar({ side, layout, visible, open, defaultOpen, onOpenChange, className, children, ...rest }: InkSidebarProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/InkPanel.d.ts
+interface InkPanelProps {
+  /** Names the panel in the sidebar's `open`. */
+  id: string;
+  /** Names its trigger. */
+  label: string;
+  /** An `@inkbar/icons` node, shown on the rail. */
+  icon?: IconNode | undefined;
+  /** A count or short text beside it, hidden when empty or 0. */
+  badge?: string | number | undefined;
+  children?: ReactNode;
+}
+/**
+ * One panel of an `InkSidebar`, holding `children` as its content. Closed, the panel stays
+ * mounted and hidden. In a stack it renders its own header above its content.
+ */
+export declare function InkPanel({ id, label, icon, badge, children }: InkPanelProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/InkThumbnail.d.ts
+interface InkThumbnailProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+  /** 0-based. */
+  page: number;
+  /** Width in CSS pixels; the height follows the page. Default 120 unless `height` is given. */
+  width?: number | undefined;
+  /** Height in CSS pixels; the width follows the page. */
+  height?: number | undefined;
+  /** Draw the page's annotations. Default true. */
+  annotations?: boolean | undefined;
+  /** Draw plugin marks. Default true. */
+  marks?: boolean | undefined;
+  /** The accessible name. Default "Page N". */
+  label?: string | undefined;
+}
+/**
+ * One page as a static image, with its live annotations and plugin marks: core's thumbnail
+ * painter on this element, which sizes it, names it ("Page N" unless `label` says otherwise)
+ * and draws it once it nears the visible area. It is not focusable and does nothing on click:
+ * wrap it in the control you need. Inside `InkRoot`; it renders empty on the server.
+ */
+export declare function InkThumbnail({ page, width, height, annotations, marks, label, className, ...rest }: InkThumbnailProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/InkThumbnails.d.ts
+interface InkThumbnailsProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+  /** 0-based pages to list, in order. Default: every page. */
+  pages?: readonly number[] | undefined;
+  /** Thumbnail width in CSS pixels. Default: the list's width less a 16px gutter each side. */
+  width?: number | undefined;
+  /** Draw each page's annotations. Default true. */
+  annotations?: boolean | undefined;
+  /** Draw plugin marks. Default true. */
+  marks?: boolean | undefined;
+  /**
+   * Renders inside each item, after its page number. The item's height is fixed from the
+   * page's, so keep what you add out of the flow (position it absolutely) or small.
+   */
+  renderItem?: ((item: {
+    page: number;
+    current: boolean;
+  }) => ReactNode) | undefined;
+}
+/**
+ * The pages as a list of thumbnails: `createThumbnails`' markup on core's thumbnails
+ * controller, which holds the current page, the keys, the clicks, the Tab stop and the window.
+ * Only the items near the visible part are mounted, each placed at its offset over a spacer of
+ * the full height, and each holds an `InkThumbnail`. An item is a button that scrolls the
+ * viewport to its page; the current page's has `aria-current="page"`. Inside `InkRoot`; it
+ * renders empty on the server.
+ */
+export declare function InkThumbnails({ pages, width, annotations, marks, renderItem, className, ...rest }: InkThumbnailsProps): import("react").JSX.Element;
+//#endregion
+//#region src/components/InkRecordList.d.ts
+interface InkRecordListProps<T extends RecordBase & {
+  page: number;
+} = RecordBase & {
+  page: number;
+}> extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+  /** The records to list, as `<plugin>.<name>`. */
+  records?: string | undefined;
+  /**
+   * A host's own source, listed in place of `records` with the same controller and cards.
+   * `card`, `where` and `sort` do not apply to it.
+   */
+  source?: RecordListSource | undefined;
+  /** The card each record shows. Default: its mark's card. */
+  card?: ((record: T) => CardSpec$1) | undefined;
+  /** Which records to list. Default: those that have a mark. */
+  where?: ((record: T) => boolean) | undefined;
+  /** The order. Default: reading order by the marks' rects. */
+  sort?: ((a: T, b: T) => number) | undefined;
+  /** Called with the number listed whenever it changes. */
+  onCountChange?: ((count: number) => void) | undefined;
+  /** Replaces "Nothing here yet."; null shows nothing. */
+  empty?: ReactNode;
+}
+/**
+ * The records a plugin keeps under `records` (`<plugin>.<name>`) as a list of cards, the same
+ * cards their marks open, with the same actions: `createRecordList` on core's record list
+ * controller. The list, the marks and `useRecordSelection` share one selection. `card`, `where`
+ * and `sort` replace the marks' card, filter and reading order; a new function rebuilds the
+ * list, so keep them stable (`useCallback`, or defined outside the component).
+ * `onCountChange` gets the number listed whenever it changes; `empty` replaces "Nothing here
+ * yet.". It fills its parent's height. Inside `InkRoot`; it renders empty on the server.
+ *
+ * In place of `records`, `source` takes a host's own `RecordListSource` and lists it with the
+ * same controller and cards. Give one of the two: with both, `source` wins and a development
+ * build warns.
+ */
+export declare function InkRecordList<T extends RecordBase & {
+  page: number;
+} = RecordBase & {
+  page: number;
+}>({ records, source, card, where, sort, onCountChange, empty, ...rest }: InkRecordListProps<T>): import("react").JSX.Element;
+//#endregion
+//#region src/components/InkSearchResults.d.ts
+interface InkSearchResultsProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+  /** Show the query field. Default true; turn it off when a find bar is on the page. */
+  field?: boolean | undefined;
+}
+/**
+ * The search hits as a list of cards, for a sidebar panel: `createSearchResults` on core's
+ * record list controller over the root's search. One card per hit, with its page and the text
+ * around it. Choosing a card makes its hit current, as the find bar's next and previous do, and
+ * the current hit is the selected card. Above the cards, a query field (`field={false}`
+ * leaves it out when a find bar is on the page); under them, the find bar's match count.
+ * Field and find bar share the search state, so they never disagree. It fills its parent's
+ * height. Inside `InkRoot`; it renders empty on the server.
+ */
+export declare function InkSearchResults({ field, className, ...rest }: InkSearchResultsProps): import("react").JSX.Element;
+//#endregion
+export type { AnnotationDecoration, AnnotationSlotProps, AnnotationState, CardSpec, CommandHandle, DecorateAnnotation, FormHandle, HostRecords, InkAnnotationProps, InkColorMenuProps, InkCommandProps, InkContext, InkDownloadButtonProps, InkFindBarProps, InkHighlightMenuProps, InkHistory, InkHistoryButtonProps, InkIconProps, InkLineStyleMenuProps, InkPageButtonProps, InkPageInputProps, InkPageProps, InkPanelProps, InkPlugin, InkPrintButtonProps, InkRecordListProps, InkRootHandle, InkRootProps, InkSearchButtonProps, InkSearchResultsProps, InkShapeMenuProps, InkSidebarProps, InkSignatureDialogProps, InkSignatureMenuProps, InkStatus, InkTextStyleMenuProps, InkThreadPopoverProps, InkThumbnailProps, InkThumbnailsProps, InkToolButtonProps, InkToolbarButtonProps, InkToolbarProps, InkToolbarSeparatorProps, InkViewportProps, InkZoomButtonProps, InkZoomSelectProps, ScopedToolStyleHandle, SidebarLayout, SidebarOpen, SidebarSide, ThreadPopoverSlotProps, ToolStyleHandle };
 //# sourceMappingURL=index.d.mts.map