@triiiceratops/plugin-annotation-editor 1.0.0-rc.7 → 1.0.0

package/dist/AnnotationManager.svelte.d.ts

@@ -1,260 +0,0 @@
-import type { AnnotationEditorConfig, AnnotationPersistenceOp, DrawingTool } from './types';
-import { AnnotationStore } from './AnnotationStore.svelte';
-import type { ViewerState } from 'triiiceratops';
-/** Every tool the plugin knows how to draw, in default button order. */
-export declare const ALL_TOOLS: DrawingTool[];
-/**
- * Resolve the effective tool set and default tool from config so the manager
- * and controller share one source of truth (F8). An empty/absent `tools` list
- * means "all tools"; `defaultTool` is honored only when it's within `tools`,
- * otherwise the first available tool wins.
- */
-export declare function resolveTools(config: {
-    tools?: DrawingTool[];
-    defaultTool?: DrawingTool;
-}): {
-    tools: DrawingTool[];
-    defaultTool: DrawingTool;
-};
-/**
- * Manages the Annotorious instance and annotation CRUD operations.
- * Instantiated within the controller component.
- */
-export declare class AnnotationManager {
-    private static readonly ACTIVE_EDIT_ID_EVENT;
-    private static readonly DEFAULT_POINT_FILL;
-    private static readonly DEFAULT_POINT_STROKE;
-    private static readonly DEFAULT_POINT_STROKE_WIDTH;
-    private static readonly DEFAULT_DRAWING_STYLE;
-    private config;
-    private store;
-    private readonly ownsStore;
-    private readonly viewerState;
-    private annotorious;
-    private osdViewer;
-    private openHandler;
-    private canvasClickHandler;
-    private createOSDAnnotator;
-    private W3CImageFormat;
-    private OSD;
-    private editingPointOrigin;
-    private get currentManifestId();
-    private get currentCanvasId();
-    private activeEditingAnnotationId;
-    private lastHandledCanvasKey;
-    private suppressedEchoIds;
-    private isDrawingEnabled;
-    private activeTool;
-    private selectedAnnotation;
-    private readonly resolvedTools;
-    readonly resolvedDefaultTool: DrawingTool;
-    onSelectionChange?: (annotation: any | null) => void;
-    onAnnotationCreated?: (annotation: any) => void;
-    onAnnotationHydrationChange?: (isHydrating: boolean) => void;
-    onActiveEditingAnnotationChange?: (annotationId: string | null) => void;
-    constructor(config: AnnotationEditorConfig, store?: AnnotationStore, viewerState?: ViewerState);
-    init(viewer: any, canvasId: string | null): void;
-    private initAnnotorious;
-    /**
-     * Create a true IIIF `PointSelector` annotation at the exact click point
-     * (F17). The click is converted click → viewport → image coords → canvas
-     * coords and rounded once to integer canvas pixels (D2) — no synthetic
-     * fragment rectangle, no zoom-dependent geometry, no `point-` id heuristic.
-     * The annotation goes through the same store create path as drawn shapes
-     * (prepareDraft, stamping, display sync); it is already canvas-space, so the
-     * image→canvas transform is skipped. It is then opened for body editing.
-     */
-    private handlePointClick;
-    setEditing(enabled: boolean): void;
-    private updateDrawingMode;
-    /**
-     * A point annotation is one whose target carries a `PointSelector` (F17).
-     * Recurses one level into `selector.item` for wrapped selectors, matching
-     * `annotationAdapter.ts`. No `point-` id heuristic — geometry, not id, is
-     * authoritative.
-     */
-    private isPointAnnotation;
-    private getPointCoordinates;
-    private toPointSelectorTarget;
-    /**
-     * Convert a cached (canvas-space) annotation into the image-space shape
-     * Annotorious edits. Non-points scale straight to image space. A point has
-     * no Annotorious tool, so it becomes a small fragment rectangle centred on
-     * the point and sized in **screen pixels at selection time** (§3.2): the
-     * marker keeps a constant visual size regardless of image resolution or
-     * zoom. The exact point is recorded separately (`editingPointOrigin`) so the
-     * reverse conversion never re-derives it from the rect centre.
-     */
-    private toAnnotoriousTarget;
-    /**
-     * Reverse of {@link toAnnotoriousTarget} for a point being edited: turn the
-     * image-space fragment rect Annotorious holds back into a canvas-space
-     * `PointSelector`. If the rect's centre still maps to the recorded origin
-     * (integer canvas px, D2), the point wasn't dragged and the origin is emitted
-     * verbatim — a bit-identical round-trip. If it moved, the new rect centre is
-     * used (§3.2).
-     */
-    private pointFromEditingRect;
-    private parseFragmentRect;
-    /**
-     * The point editing rectangle's side length in **image units**, derived from
-     * the configured marker diameter (screen px) and the current
-     * image-units-per-screen-pixel. Falls back to treating the diameter as
-     * canvas units (scaled to image space) when the viewport can't be measured
-     * yet — e.g. before the viewer's first render.
-     */
-    private pointEditRectImageSize;
-    /**
-     * Image units spanned by one screen pixel at the current zoom, measured the
-     * way the old point-authoring code did: convert two 1px-apart screen points
-     * to image coordinates and take the delta. Returns null when the viewport
-     * isn't available.
-     */
-    private imageUnitsPerScreenPixel;
-    /**
-     * Annotorious `style` callback: points get the configured marker colours,
-     * every other shape gets the host's drawing style (F9). A point is
-     * identified by having an editing origin recorded for its id.
-     */
-    private styleForAnnotation;
-    private getCurrentCanvasImageDimensions;
-    setTool(tool: DrawingTool): void;
-    get availableTools(): DrawingTool[];
-    /**
-     * The store's current unhandled persistence error for the panel's default
-     * error line, or `null` when there's nothing to show (F20).
-     */
-    get persistenceError(): {
-        op: AnnotationPersistenceOp;
-        annotationId?: string;
-    } | null;
-    /** Dismiss the panel's persistence error line. */
-    dismissPersistenceError(): void;
-    /** Whether an undo is available (reactive; drives the panel button — F6). */
-    get canUndo(): boolean;
-    /** Whether a redo is available (reactive; drives the panel button — F6). */
-    get canRedo(): boolean;
-    /**
-     * Reverse the most recent persisted operation through the store's op stack,
-     * replaying its inverse against the adapter so storage and display stay in
-     * agreement (F6).
-     */
-    undo(): Promise<void>;
-    /** Re-apply the most recently undone operation (F6). */
-    redo(): Promise<void>;
-    private setupEvents;
-    private setActiveEditingAnnotationId;
-    /**
-     * Reset the manager's Annotorious-facing selection fields. Shared by the two
-     * teardown paths: `clearSelectionState()` (also notifies the host, leaves
-     * Annotorious untouched) and `clearAnnotoriousEditingAnnotation()` (also
-     * clears Annotorious's annotation set).
-     */
-    private resetSelectionFields;
-    /**
-     * Tear down the current selection and tell the host it's gone, without
-     * touching Annotorious's own annotation set. Used on the create/delete/
-     * rollback paths where Annotorious's shape is managed separately.
-     */
-    private clearSelectionState;
-    private clearAnnotoriousEditingAnnotation;
-    /**
-     * Clear all annotations from Annotorious, marking each so the resulting
-     * (async) `deleteAnnotation` echo is consumed by handleDeleteAnnotation and
-     * never mistaken for a user-originated deletion (F27). Only ids actually
-     * present are marked, so no stale marks accrue.
-     */
-    private clearAnnotationsSuppressed;
-    handleCanvasChange(manifestId: string | null, canvasId: string | null): Promise<void>;
-    private loadAnnotations;
-    /**
-     * Handles Annotorious's (async) `createAnnotation` lifecycle event. Persists
-     * exactly what the host's prepareDraft/prepareAnnotation produced — not the
-     * raw event payload — so draft enrichment survives create (F2).
-     */
-    private handleCreateAnnotation;
-    /**
-     * Handles Annotorious's (async) `updateAnnotation` lifecycle event. Echoes
-     * we triggered ourselves (e.g. pushing edited bodies back into Annotorious)
-     * are consumed here so they don't double-persist (F3).
-     */
-    private handleUpdateAnnotation;
-    /**
-     * Handles Annotorious's (async) `deleteAnnotation` lifecycle event. Echoes
-     * from our own `clearAnnotations()` teardown are marked and consumed here so
-     * they never reach the adapter. A genuine Annotorious-originated deletion of
-     * a persisted annotation syncs the adapter, cache, and selection state (F27).
-     */
-    private handleDeleteAnnotation;
-    /**
-     * Persist an annotation that arrived in **image space** (Annotorious event
-     * payloads, geometry edits). Transforms to canvas space, forces the target
-     * source, applies beforeSave, then persists.
-     */
-    saveAnnotation(annotation: any): Promise<boolean>;
-    /**
-     * Convert an image-space annotation from Annotorious into canvas space for
-     * the cache/panel/store. An actively-edited point takes the lossless
-     * origin-aware path (§3.2); everything else scales normally, with legacy
-     * fragment-centre read-compat via `toPointSelectorTarget` (D3).
-     */
-    private annotationToCanvasSpace;
-    /**
-     * Persist a freshly created annotation that is already in **canvas space**
-     * (the output of prepareAnnotation). Skips the image→canvas re-transform;
-     * beforeSave still runs last. Returns whether the write succeeded.
-     */
-    private persistCreate;
-    /**
-     * Run a store mutation whose resulting (asynchronous) Annotorious lifecycle
-     * echo for `annotationId` must not be re-persisted.
-     *
-     * NOTE: Annotorious v3 dispatches lifecycle events via `setTimeout(…, 1)`
-     * (verified in @annotorious/core@3.7.19), so a synchronous boolean guard as
-     * originally planned would already be reset by the time the echo fires. We
-     * mark the id and let the echo consume the mark instead. A body-change
-     * update emits exactly one echo, so one mark == one consumed echo.
-     */
-    private withSuppressedEcho;
-    /** Record one more expected self-triggered echo for this id. */
-    private markSuppressedEcho;
-    /**
-     * Consume one expected echo for this id. Returns true (and decrements the
-     * count, deleting the entry at zero) while echoes remain outstanding, so two
-     * concurrent echoes — e.g. a body-save update echo and a teardown delete echo
-     * for the same id — are each matched and neither leaks (F3/F27).
-     */
-    private consumeSuppressedEcho;
-    /**
-     * Always overwrite `target.source` with the current canvas id. Within this
-     * plugin the target is by definition the canvas the user is annotating, so
-     * overwriting is safe regardless of what the Annotorious W3C serializer
-     * stamped at init time (see F1). All other target fields are preserved.
-     */
-    private forceTargetSource;
-    private prepareAnnotation;
-    private applyBeforeSave;
-    private getRuntimeContext;
-    private notifyExtensionSelectionChange;
-    private hydrateAnnotation;
-    deleteAnnotation(annotationId: string): Promise<boolean>;
-    updateAnnotationBodies(annotationId: string, bodies: unknown[] | unknown): Promise<boolean>;
-    /**
-     * React to the store swapping a freshly-created annotation onto its
-     * server-assigned id (F5). If that annotation is the one currently open for
-     * editing, re-open it under the canonical id: this re-adds it to Annotorious,
-     * reselects it, and re-emits the active-edit-id signal with the new id.
-     */
-    private handleIdReconciled;
-    /**
-     * Reconcile the open Annotorious editing session with an undo/redo replay
-     * (F6). Only the annotation currently open is affected: if the replay left
-     * it in storage, re-open it so its geometry and body reflect the restored
-     * state; if the replay removed it (e.g. undoing the create of the annotation
-     * being edited), tear the editing session down.
-     */
-    private handleReplay;
-    selectAnnotationById(annotationId: string): Promise<void>;
-    cancelSelection(): void;
-    destroy(): void;
-}

package/dist/styles.d.ts

@@ -1,11 +0,0 @@
-/**
- * The combined stylesheet (base Annotorious sheet + layer fixes) installed under
- * the `annotorious` id at activation, shaped by {@link definePluginStyles} into
- * the `STYLES` / `STYLE_ID` exports.
- *
- * No plugin chrome CSS lives here anymore: core owns the toolbar button and the
- * docked-panel / anchored-flyout surface (epic restore-plugin-toolbar-chrome),
- * so the plugin ships only the Annotorious annotation-layer styles. The panel's
- * own presentation is scoped component CSS rendered inside `view.mount`.
- */
-export declare const STYLES: string, STYLE_ID: string;