@fieldnotes/core 0.54.0 → 0.55.0

package/dist/index.d.cts

@@ -249,7 +249,7 @@ interface Tool {
     setOptions?(options: object): void;
     onOptionsChange?(listener: () => void): () => void;
 }
-type ToolName = 'hand' | 'select' | 'pencil' | 'eraser' | 'arrow' | 'note' | 'image' | 'text' | 'shape' | 'measure' | 'template' | 'laser';
+type ToolName = 'hand' | 'select' | 'pencil' | 'eraser' | 'arrow' | 'note' | 'image' | 'text' | 'shape' | 'measure' | 'template' | 'laser' | 'ping';
 
 declare function snapPoint(point: Point, gridSize: number): Point;
 declare function snapToHexCenter(point: Point, cellSize: number, orientation: HexOrientation): Point;
@@ -844,6 +844,148 @@ declare class RemoteLaserOverlay {
     private renderTrails;
 }
 
+interface PingToolOptions {
+    name?: string;
+    color?: string;
+    /** Total pulse animation length in milliseconds. */
+    durationMs?: number;
+    /** Maximum ripple radius in world units. */
+    radius?: number;
+    /**
+     * Minimum interval between emitted pings. Taps arriving faster are ignored
+     * entirely (no local pulse, no emission), so rapid-fire pings cannot starve
+     * durable sync traffic.
+     */
+    minIntervalMs?: number;
+}
+/**
+ * One emitted ping — the outgoing side of a shared "look here" marker.
+ * Emissions carry the world position and the tool's current style so a host
+ * can forward them as ephemeral presence without duplicating input handling.
+ */
+interface PingEmission {
+    /** World-space ping position. */
+    readonly x: number;
+    readonly y: number;
+    readonly color: string;
+    readonly durationMs: number;
+    readonly radius: number;
+}
+/**
+ * Tap or click to ping a world position: a short expanding-pulse animation is
+ * rendered locally and one `PingEmission` is delivered to `onPing` listeners
+ * per accepted tap. Pings are ephemeral by contract: they never create
+ * elements, enter undo history, or touch persisted canvas state — hosts
+ * forward emissions as presence only.
+ */
+declare class PingTool implements Tool {
+    readonly name: string;
+    private color;
+    private durationMs;
+    private radius;
+    private minIntervalMs;
+    private pings;
+    private lastEmitAt;
+    private rafId;
+    private optionListeners;
+    private pingListeners;
+    constructor(options?: PingToolOptions);
+    private now;
+    onActivate(ctx: ToolContext): void;
+    onDeactivate(ctx: ToolContext): void;
+    getOptions(): PingToolOptions;
+    setOptions(options: PingToolOptions): void;
+    onOptionsChange(listener: () => void): () => void;
+    /**
+     * Subscribes to accepted pings. Listeners must not throw; a throwing
+     * listener is isolated so it cannot break the tap handling or other
+     * listeners.
+     */
+    onPing(listener: (emission: PingEmission) => void): () => void;
+    onPointerDown(state: PointerState, ctx: ToolContext): void;
+    onPointerMove(_state: PointerState, _ctx: ToolContext): void;
+    onPointerUp(_state: PointerState, _ctx: ToolContext): void;
+    renderOverlay(ctx: CanvasRenderingContext2D): void;
+    private ensureAnimating;
+    private tick;
+    private notifyOptionsChange;
+}
+
+/**
+ * The wire shape of a map-ping presence payload. Presence data is untyped on
+ * the wire, so hosts discriminate on `kind`; `isPingPresence` validates a
+ * received payload before it reaches the overlay. Pings are ephemeral by
+ * contract: they must travel as presence only — never as elements, undo
+ * history, persisted canvas state, or durable operations.
+ */
+interface PingPresence {
+    readonly kind: 'ping';
+    /** World-space ping position. */
+    readonly x: number;
+    readonly y: number;
+    readonly color?: string;
+    readonly durationMs?: number;
+    readonly radius?: number;
+}
+declare const PING_PRESENCE_KIND = "ping";
+declare function isPingPresence(data: unknown): data is PingPresence;
+/** Builds the presence payload for one local `PingTool` emission. */
+declare function toPingPresence(emission: PingEmission): PingPresence;
+/**
+ * The two viewport capabilities the overlay needs; `Viewport` satisfies it.
+ */
+interface RemotePingOverlayHost {
+    registerOverlay(draw: OverlayRenderer): () => void;
+    requestRender(): void;
+}
+interface RemotePingOverlayOptions {
+    /** Style fallbacks when a payload omits them. */
+    color?: string;
+    durationMs?: number;
+    radius?: number;
+    /** Per-sender live-ping cap; oldest pings drop first. Default `8`. */
+    maxPingsPerSender?: number;
+}
+/**
+ * Renders expanding-pulse pings for remote senders through the viewport
+ * overlay registration, independent of the viewer's active tool. Pings are
+ * stamped with local receive time (remote clocks are never trusted),
+ * self-expire when their animation ends, and a sender's pings disappear
+ * immediately on `remove()` — wire that to `presence-leave`/disconnect. The
+ * controller never touches elements, history, or persisted state, and it
+ * never moves the viewer's camera: pings are visual only.
+ */
+declare class RemotePingOverlay {
+    private readonly host;
+    private readonly color;
+    private readonly durationMs;
+    private readonly radius;
+    private readonly maxPingsPerSender;
+    private readonly pings;
+    private unregister;
+    private rafId;
+    private disposed;
+    constructor(host: RemotePingOverlayHost, options?: RemotePingOverlayOptions);
+    private now;
+    /**
+     * Applies a presence payload from `sender` (any opaque per-sender key, e.g.
+     * the envelope `from`). Non-ping or malformed payloads are ignored and
+     * reported as `false`, so hosts can feed every presence frame through.
+     */
+    apply(sender: string, data: unknown): boolean;
+    /** Removes a sender's pings immediately (presence-leave/disconnect). */
+    remove(sender: string): void;
+    /** Removes every ping immediately. */
+    clear(): void;
+    /** Number of senders with a live (unexpired) ping. */
+    get activeSenderCount(): number;
+    /** Unregisters the overlay and stops the animation loop. Idempotent. */
+    dispose(): void;
+    private ensureAnimating;
+    private tick;
+    private renderPings;
+}
+
 interface ActiveFormats {
     bold: boolean;
     italic: boolean;
@@ -1282,6 +1424,6 @@ declare class TemplateTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.54.0";
+declare const VERSION = "0.55.0";
 
-export { type ActiveFormats, type AlignEdge, type ArrowElement, type ArrowStrokeStyle, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, type BackgroundOptions, type BackgroundPattern, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, DEFAULT_NOTE_FONT_SIZE, type DistributeAxis, type ElementChangeMeta, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportAssetError, type ExportAssetErrorReason, type ExportImageOptions, type ExportResourceOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type HtmlExportError, type HtmlExportErrorReason, type HtmlExportOptions, type HtmlExportRenderer, type ImageElement, ImageTool, type ImageToolOptions, IndexedDBAdapter, type IndexedDBAdapterOptions, LASER_TRAIL_PRESENCE_KIND, LaserTool, type LaserToolOptions, type LaserTrailEmission, type LaserTrailPresence, type Layer, LayerManager, LocalStorageAdapter, MeasureTool, type MeasureToolOptions, type Measurement, MemoryAdapter, type NoteElement, NoteTool, type NoteToolOptions, type OverlayRenderer, PencilTool, type PencilToolOptions, type Point, type PointerState, RemoteLaserOverlay, type RemoteLaserOverlayHost, type RemoteLaserOverlayOptions, type RenderStatsSnapshot, type RotateDirection, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StorageAdapter, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateRenderStyle, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, VERSION, Viewport, type ViewportOptions, boundsIntersect, createArrow, createGrid, createHtmlElement, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportSvg, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInRectangle, getHexCellsInSquare, getHexDistance, isLaserTrailPresence, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toLaserTrailPresence, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };
+export { type ActiveFormats, type AlignEdge, type ArrowElement, type ArrowStrokeStyle, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, type BackgroundOptions, type BackgroundPattern, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, DEFAULT_NOTE_FONT_SIZE, type DistributeAxis, type ElementChangeMeta, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportAssetError, type ExportAssetErrorReason, type ExportImageOptions, type ExportResourceOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type HtmlExportError, type HtmlExportErrorReason, type HtmlExportOptions, type HtmlExportRenderer, type ImageElement, ImageTool, type ImageToolOptions, IndexedDBAdapter, type IndexedDBAdapterOptions, LASER_TRAIL_PRESENCE_KIND, LaserTool, type LaserToolOptions, type LaserTrailEmission, type LaserTrailPresence, type Layer, LayerManager, LocalStorageAdapter, MeasureTool, type MeasureToolOptions, type Measurement, MemoryAdapter, type NoteElement, NoteTool, type NoteToolOptions, type OverlayRenderer, PING_PRESENCE_KIND, PencilTool, type PencilToolOptions, type PingEmission, type PingPresence, PingTool, type PingToolOptions, type Point, type PointerState, RemoteLaserOverlay, type RemoteLaserOverlayHost, type RemoteLaserOverlayOptions, RemotePingOverlay, type RemotePingOverlayHost, type RemotePingOverlayOptions, type RenderStatsSnapshot, type RotateDirection, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StorageAdapter, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateRenderStyle, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, VERSION, Viewport, type ViewportOptions, boundsIntersect, createArrow, createGrid, createHtmlElement, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportSvg, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInRectangle, getHexCellsInSquare, getHexDistance, isLaserTrailPresence, isNearBezier, isPingPresence, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toLaserTrailPresence, toPingPresence, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };

package/dist/index.d.ts

@@ -249,7 +249,7 @@ interface Tool {
     setOptions?(options: object): void;
     onOptionsChange?(listener: () => void): () => void;
 }
-type ToolName = 'hand' | 'select' | 'pencil' | 'eraser' | 'arrow' | 'note' | 'image' | 'text' | 'shape' | 'measure' | 'template' | 'laser';
+type ToolName = 'hand' | 'select' | 'pencil' | 'eraser' | 'arrow' | 'note' | 'image' | 'text' | 'shape' | 'measure' | 'template' | 'laser' | 'ping';
 
 declare function snapPoint(point: Point, gridSize: number): Point;
 declare function snapToHexCenter(point: Point, cellSize: number, orientation: HexOrientation): Point;
@@ -844,6 +844,148 @@ declare class RemoteLaserOverlay {
     private renderTrails;
 }
 
+interface PingToolOptions {
+    name?: string;
+    color?: string;
+    /** Total pulse animation length in milliseconds. */
+    durationMs?: number;
+    /** Maximum ripple radius in world units. */
+    radius?: number;
+    /**
+     * Minimum interval between emitted pings. Taps arriving faster are ignored
+     * entirely (no local pulse, no emission), so rapid-fire pings cannot starve
+     * durable sync traffic.
+     */
+    minIntervalMs?: number;
+}
+/**
+ * One emitted ping — the outgoing side of a shared "look here" marker.
+ * Emissions carry the world position and the tool's current style so a host
+ * can forward them as ephemeral presence without duplicating input handling.
+ */
+interface PingEmission {
+    /** World-space ping position. */
+    readonly x: number;
+    readonly y: number;
+    readonly color: string;
+    readonly durationMs: number;
+    readonly radius: number;
+}
+/**
+ * Tap or click to ping a world position: a short expanding-pulse animation is
+ * rendered locally and one `PingEmission` is delivered to `onPing` listeners
+ * per accepted tap. Pings are ephemeral by contract: they never create
+ * elements, enter undo history, or touch persisted canvas state — hosts
+ * forward emissions as presence only.
+ */
+declare class PingTool implements Tool {
+    readonly name: string;
+    private color;
+    private durationMs;
+    private radius;
+    private minIntervalMs;
+    private pings;
+    private lastEmitAt;
+    private rafId;
+    private optionListeners;
+    private pingListeners;
+    constructor(options?: PingToolOptions);
+    private now;
+    onActivate(ctx: ToolContext): void;
+    onDeactivate(ctx: ToolContext): void;
+    getOptions(): PingToolOptions;
+    setOptions(options: PingToolOptions): void;
+    onOptionsChange(listener: () => void): () => void;
+    /**
+     * Subscribes to accepted pings. Listeners must not throw; a throwing
+     * listener is isolated so it cannot break the tap handling or other
+     * listeners.
+     */
+    onPing(listener: (emission: PingEmission) => void): () => void;
+    onPointerDown(state: PointerState, ctx: ToolContext): void;
+    onPointerMove(_state: PointerState, _ctx: ToolContext): void;
+    onPointerUp(_state: PointerState, _ctx: ToolContext): void;
+    renderOverlay(ctx: CanvasRenderingContext2D): void;
+    private ensureAnimating;
+    private tick;
+    private notifyOptionsChange;
+}
+
+/**
+ * The wire shape of a map-ping presence payload. Presence data is untyped on
+ * the wire, so hosts discriminate on `kind`; `isPingPresence` validates a
+ * received payload before it reaches the overlay. Pings are ephemeral by
+ * contract: they must travel as presence only — never as elements, undo
+ * history, persisted canvas state, or durable operations.
+ */
+interface PingPresence {
+    readonly kind: 'ping';
+    /** World-space ping position. */
+    readonly x: number;
+    readonly y: number;
+    readonly color?: string;
+    readonly durationMs?: number;
+    readonly radius?: number;
+}
+declare const PING_PRESENCE_KIND = "ping";
+declare function isPingPresence(data: unknown): data is PingPresence;
+/** Builds the presence payload for one local `PingTool` emission. */
+declare function toPingPresence(emission: PingEmission): PingPresence;
+/**
+ * The two viewport capabilities the overlay needs; `Viewport` satisfies it.
+ */
+interface RemotePingOverlayHost {
+    registerOverlay(draw: OverlayRenderer): () => void;
+    requestRender(): void;
+}
+interface RemotePingOverlayOptions {
+    /** Style fallbacks when a payload omits them. */
+    color?: string;
+    durationMs?: number;
+    radius?: number;
+    /** Per-sender live-ping cap; oldest pings drop first. Default `8`. */
+    maxPingsPerSender?: number;
+}
+/**
+ * Renders expanding-pulse pings for remote senders through the viewport
+ * overlay registration, independent of the viewer's active tool. Pings are
+ * stamped with local receive time (remote clocks are never trusted),
+ * self-expire when their animation ends, and a sender's pings disappear
+ * immediately on `remove()` — wire that to `presence-leave`/disconnect. The
+ * controller never touches elements, history, or persisted state, and it
+ * never moves the viewer's camera: pings are visual only.
+ */
+declare class RemotePingOverlay {
+    private readonly host;
+    private readonly color;
+    private readonly durationMs;
+    private readonly radius;
+    private readonly maxPingsPerSender;
+    private readonly pings;
+    private unregister;
+    private rafId;
+    private disposed;
+    constructor(host: RemotePingOverlayHost, options?: RemotePingOverlayOptions);
+    private now;
+    /**
+     * Applies a presence payload from `sender` (any opaque per-sender key, e.g.
+     * the envelope `from`). Non-ping or malformed payloads are ignored and
+     * reported as `false`, so hosts can feed every presence frame through.
+     */
+    apply(sender: string, data: unknown): boolean;
+    /** Removes a sender's pings immediately (presence-leave/disconnect). */
+    remove(sender: string): void;
+    /** Removes every ping immediately. */
+    clear(): void;
+    /** Number of senders with a live (unexpired) ping. */
+    get activeSenderCount(): number;
+    /** Unregisters the overlay and stops the animation loop. Idempotent. */
+    dispose(): void;
+    private ensureAnimating;
+    private tick;
+    private renderPings;
+}
+
 interface ActiveFormats {
     bold: boolean;
     italic: boolean;
@@ -1282,6 +1424,6 @@ declare class TemplateTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.54.0";
+declare const VERSION = "0.55.0";
 
-export { type ActiveFormats, type AlignEdge, type ArrowElement, type ArrowStrokeStyle, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, type BackgroundOptions, type BackgroundPattern, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, DEFAULT_NOTE_FONT_SIZE, type DistributeAxis, type ElementChangeMeta, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportAssetError, type ExportAssetErrorReason, type ExportImageOptions, type ExportResourceOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type HtmlExportError, type HtmlExportErrorReason, type HtmlExportOptions, type HtmlExportRenderer, type ImageElement, ImageTool, type ImageToolOptions, IndexedDBAdapter, type IndexedDBAdapterOptions, LASER_TRAIL_PRESENCE_KIND, LaserTool, type LaserToolOptions, type LaserTrailEmission, type LaserTrailPresence, type Layer, LayerManager, LocalStorageAdapter, MeasureTool, type MeasureToolOptions, type Measurement, MemoryAdapter, type NoteElement, NoteTool, type NoteToolOptions, type OverlayRenderer, PencilTool, type PencilToolOptions, type Point, type PointerState, RemoteLaserOverlay, type RemoteLaserOverlayHost, type RemoteLaserOverlayOptions, type RenderStatsSnapshot, type RotateDirection, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StorageAdapter, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateRenderStyle, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, VERSION, Viewport, type ViewportOptions, boundsIntersect, createArrow, createGrid, createHtmlElement, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportSvg, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInRectangle, getHexCellsInSquare, getHexDistance, isLaserTrailPresence, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toLaserTrailPresence, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };
+export { type ActiveFormats, type AlignEdge, type ArrowElement, type ArrowStrokeStyle, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, type BackgroundOptions, type BackgroundPattern, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, DEFAULT_NOTE_FONT_SIZE, type DistributeAxis, type ElementChangeMeta, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportAssetError, type ExportAssetErrorReason, type ExportImageOptions, type ExportResourceOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type HtmlExportError, type HtmlExportErrorReason, type HtmlExportOptions, type HtmlExportRenderer, type ImageElement, ImageTool, type ImageToolOptions, IndexedDBAdapter, type IndexedDBAdapterOptions, LASER_TRAIL_PRESENCE_KIND, LaserTool, type LaserToolOptions, type LaserTrailEmission, type LaserTrailPresence, type Layer, LayerManager, LocalStorageAdapter, MeasureTool, type MeasureToolOptions, type Measurement, MemoryAdapter, type NoteElement, NoteTool, type NoteToolOptions, type OverlayRenderer, PING_PRESENCE_KIND, PencilTool, type PencilToolOptions, type PingEmission, type PingPresence, PingTool, type PingToolOptions, type Point, type PointerState, RemoteLaserOverlay, type RemoteLaserOverlayHost, type RemoteLaserOverlayOptions, RemotePingOverlay, type RemotePingOverlayHost, type RemotePingOverlayOptions, type RenderStatsSnapshot, type RotateDirection, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StorageAdapter, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateRenderStyle, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, VERSION, Viewport, type ViewportOptions, boundsIntersect, createArrow, createGrid, createHtmlElement, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportSvg, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInRectangle, getHexCellsInSquare, getHexDistance, isLaserTrailPresence, isNearBezier, isPingPresence, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toLaserTrailPresence, toPingPresence, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };