@inkbar/react 0.9.0 → 0.11.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
@@ -163,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;
@@ -186,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;
@@ -234,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;
@@ -259,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;
@@ -286,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;
@@ -319,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;
@@ -349,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;
@@ -382,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;
@@ -412,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;
@@ -436,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;
@@ -461,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;
@@ -485,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;
@@ -526,6 +538,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -568,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;
@@ -591,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;
@@ -639,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;
@@ -664,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;
@@ -691,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;
@@ -724,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;
@@ -754,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;
@@ -787,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;
@@ -817,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;
@@ -841,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;
@@ -866,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;
@@ -890,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;
@@ -931,6 +956,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -975,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;
@@ -998,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;
@@ -1046,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;
@@ -1071,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;
@@ -1098,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;
@@ -1131,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;
@@ -1161,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;
@@ -1194,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;
@@ -1224,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;
@@ -1248,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;
@@ -1273,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;
@@ -1297,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;
@@ -1338,6 +1376,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1381,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;
@@ -1404,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;
@@ -1452,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;
@@ -1477,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;
@@ -1504,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;
@@ -1537,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;
@@ -1567,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;
@@ -1600,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;
@@ -1630,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;
@@ -1654,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;
@@ -1679,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;
@@ -1703,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;
@@ -1744,6 +1795,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -1786,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;
@@ -1809,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;
@@ -1857,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;
@@ -1882,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;
@@ -1909,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;
@@ -1942,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;
@@ -1972,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;
@@ -2005,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;
@@ -2035,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;
@@ -2059,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;
@@ -2084,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;
@@ -2108,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;
@@ -2149,6 +2213,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2192,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;
@@ -2215,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;
@@ -2263,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;
@@ -2288,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;
@@ -2315,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;
@@ -2348,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;
@@ -2378,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;
@@ -2411,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;
@@ -2441,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;
@@ -2465,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;
@@ -2490,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;
@@ -2514,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;
@@ -2555,6 +2632,7 @@ export declare function useAnnotations(): {
       };
     }[] | undefined;
     locked?: boolean | undefined;
+    hasAppearance?: boolean | undefined;
     overlayText?: string | undefined;
     author?: string | undefined;
     contents?: string | undefined;
@@ -2700,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;
@@ -2807,6 +2909,8 @@ interface InkViewportProps extends ComponentPropsWithoutRef<'div'> {
   gap?: number;
   /** Pages kept mounted either side of the visible ones. */
   buffer?: number;
+  /** Pinch to zoom the pages. Off leaves the browser's own touch handling alone. */
+  pinchZoom?: boolean;
   loading?: ReactNode;
   empty?: ReactNode;
   error?: ReactNode | ((props: {
@@ -2819,7 +2923,7 @@ interface InkViewportProps extends ComponentPropsWithoutRef<'div'> {
     page: number;
   }) => ReactNode) | undefined;
 }
-export declare function InkViewport({ mode, rotation, gap, buffer, loading, empty, error, renderAnnotation, renderPageError, className, ...rest }: InkViewportProps): import("react").JSX.Element;
+export declare function InkViewport({ mode, rotation, gap, buffer, pinchZoom, loading, empty, error, renderAnnotation, renderPageError, className, ...rest }: InkViewportProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/InkPage.d.ts
 interface InkPageProps {
@@ -2915,6 +3019,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
@@ -3066,5 +3194,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, InkToolbarButtonProps, 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