@magicpages/kalotyp-ui 0.1.0

package/dist/keyboard-shortcuts.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Manifest of every keyboard shortcut. The cheatsheet UI reads this list.
+ * This is a manifest, not a registry — handlers live with the features that own them.
+ * "Ctrl" stands in for Ctrl/Cmd: handlers check `ctrlKey || metaKey`, so one label covers both.
+ */
+export type KeyboardShortcutContext = 'editor' | 'annotate' | 'redact' | 'text';
+export interface KeyboardShortcut {
+    /** Tokens rendered as `<kbd>` pills joined by " + ". Use platform-neutral spelling ("Ctrl", "Esc", "Arrow keys"). */
+    readonly keys: ReadonlyArray<string>;
+    readonly description: string;
+    readonly context: KeyboardShortcutContext;
+}
+export declare const KEYBOARD_SHORTCUTS: ReadonlyArray<KeyboardShortcut>;
+export declare const KEYBOARD_SHORTCUT_CONTEXT_LABELS: Readonly<Record<KeyboardShortcutContext, string>>;
+//# sourceMappingURL=keyboard-shortcuts.d.ts.map

package/dist/keyboard-shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-shortcuts.d.ts","sourceRoot":"","sources":["../src/keyboard-shortcuts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,qHAAqH;IACrH,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C;AAED,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,gBAAgB,CAyF9D,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAK9F,CAAC"}

package/dist/output/popover.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Output popover anchored to the Save-button caret: format, quality, strip-metadata.
+ * State commits immediately to the Store; no apply button. Unsupported formats
+ * (per async runtime probe) are disabled in-place when the probe resolves.
+ */
+import { type OutputState, type Store } from '@magicpages/kalotyp-core';
+export interface OpenOutputPopoverOptions {
+    readonly host: HTMLElement;
+    readonly anchor: HTMLElement;
+    readonly store: Store<OutputState>;
+    /** Click of "Save and close" inside the popover. */
+    readonly onSaveAndClose: () => void;
+    /** Mirrors the editor's Save-enabled state so the in-popover Save button stays in sync. */
+    readonly canSave: () => boolean;
+    readonly onClose: () => void;
+}
+export interface OutputPopoverHandle {
+    close(): void;
+}
+export declare function openOutputPopover(options: OpenOutputPopoverOptions): OutputPopoverHandle;
+//# sourceMappingURL=popover.d.ts.map

package/dist/output/popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../src/output/popover.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,KAAK,EAKX,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,IAAI,CAAC;CACf;AA2CD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,mBAAmB,CA8KxF"}

package/dist/plugins/annotate/coord-inputs.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Per-shape coordinate-input rows for the keyboard placement path
+ *. The inputs are the keyboard-only equivalent
+ * of dragging selection handles: a user types image-space pixel
+ * coordinates, the shape's geometry updates on `change` (blur or
+ * Enter), and the live canvas + selection handles re-paint via the
+ * existing store subscription path.
+ *
+ * Each shape kind exposes a different shape of fields:
+ *
+ *   - rect / ellipse → Left, Top, Width, Height (matches crop's
+ *     dimension-input pattern from Phase 6.2; same semantics).
+ *   - arrow → Start X, Start Y, End X, End Y (the two endpoints).
+ *   - text → X, Y (anchor only; size is driven by the font size
+ *     control, and the inline editor handles the text content).
+ *
+ * One row instance is reused across selections; it rebuilds its
+ * fields when the selected shape's kind changes. The mount layer
+ * subscribes to the selection and calls `updateForShape(shape)` on
+ * each change so the inputs reflect the live geometry.
+ */
+import type { Shape } from '@magicpages/kalotyp-core';
+export interface CoordInputsOptions {
+    /**
+     * Called when a typed value commits (blur or Enter). The handler
+     * receives the new shape; the mount layer writes it to the store
+     * via `replaceShape` and emits a commit. Keeping the helper
+     * store-free means the row's tests don't need to thread a store.
+     */
+    onShapeChanged(shape: Shape): void;
+}
+/**
+ * A single coordinate edit. Discriminated on shape kind so the apply
+ * step can narrow without re-reading the input ids.
+ */
+export type ShapeCoordEdit = {
+    readonly kind: 'rect' | 'ellipse';
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly kind: 'arrow';
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+} | {
+    readonly kind: 'text';
+    readonly x: number;
+    readonly y: number;
+};
+export interface CoordInputsHandle {
+    readonly container: HTMLDivElement;
+    /** Show inputs for the given shape and prefill values. Hides when shape is null. */
+    updateForShape(shape: Shape | null): void;
+    destroy(): void;
+}
+/**
+ * Build a single per-selection coordinate-input row. The row reuses
+ * the same `kalotyp-annotate-coords-*` class set across shape kinds
+ * so styling is one rule set; only the field set changes per shape.
+ */
+export declare function buildCoordInputs(options: CoordInputsOptions): CoordInputsHandle;
+/**
+ * Apply an edit produced by the inputs to the shape it came from.
+ * Exported so the mount layer can compose it with its own clamping
+ * before writing to the store. The function is total over the shape
+ * union so the caller doesn't need to re-narrow.
+ */
+export declare function applyCoordEdit(shape: Shape, edit: ShapeCoordEdit): Shape;
+//# sourceMappingURL=coord-inputs.d.ts.map

package/dist/plugins/annotate/coord-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coord-inputs.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/coord-inputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAIV,KAAK,EAEN,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,oFAAoF;IACpF,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC;CACjB;AA4BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAsK/E;AAcD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,GAAG,KAAK,CAqCxE"}

package/dist/plugins/annotate/mount.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Mount the annotation plugin's stage UI and wire up:
+ *   - the three layered canvases (image / shapes / live);
+ *   - the bottom panel (tool toolbar + style controls);
+ *   - pointer dispatch (drawing tools vs select tool);
+ *   - selection handles + per-handle resize gestures;
+ *   - the inline text editor;
+ *   - keyboard shortcuts (Delete/Backspace to remove the selected
+ *     shape; Esc to deselect).
+ *
+ * The mount keeps two pieces of derived state at module scope:
+ *
+ *   - `viewport` — the current letterbox of the upstream-baked source
+ *     into the stage. Recomputed on every stage resize.
+ *   - `liveShape` — the in-progress shape during a draw or move
+ *     gesture. `null` when no gesture is active.
+ */
+import { type AnnotateState, type SourceImage, type Store, type ViewportController } from '@magicpages/kalotyp-core';
+export interface MountAnnotateOptions {
+    readonly stageHost: HTMLElement;
+    readonly utilHost: HTMLElement;
+    readonly source: SourceImage;
+    readonly store: Store<AnnotateState>;
+    /** Editor-level zoom + pan controller. Optional in jsdom tests. */
+    readonly viewport?: ViewportController;
+    /** Called after each user-meaningful annotation mutation. */
+    readonly onCommit?: () => void;
+    /**
+     * Optional live-region announcer. The annotate plugin
+     * uses it for state changes that don't move keyboard focus —
+     * notably Esc-deselect, where the screen reader would otherwise
+     * have no cue that the selection went away.
+     */
+    readonly onAnnounce?: (message: string) => void;
+}
+export interface MountAnnotateHandle {
+    destroy(): void;
+}
+export declare function mountAnnotateUtility(options: MountAnnotateOptions): MountAnnotateHandle;
+//# sourceMappingURL=mount.d.ts.map

package/dist/plugins/annotate/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,KAAK,aAAa,EAIlB,KAAK,WAAW,EAChB,KAAK,KAAK,EAIV,KAAK,kBAAkB,EAexB,MAAM,0BAA0B,CAAC;AAmBlC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAucvF"}

package/dist/plugins/annotate/panel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Build the annotation panel: tool toolbar on the left, style
+ * controls on the right. Mirrors the layout-rhythm conventions the
+ * other Phase 2 panels (rotate, flip, resize) established — flat
+ * row(s) of controls under `.kalotyp-util-main`.
+ */
+import { type AnnotateTool, type StylePalette } from '@magicpages/kalotyp-core';
+export interface AnnotatePanelOptions {
+    readonly initialTool: AnnotateTool;
+    readonly initialStyle: StylePalette;
+    readonly canDelete: boolean;
+    /**
+     * Where the per-selection coordinate-input row mounts. The mount layer owns the row's lifecycle and just
+     * needs the panel to expose the slot so the inputs render in the
+     * panel rhythm rather than as a free-floating bar.
+     */
+    readonly coordInputs: HTMLElement;
+    onSelectTool(tool: AnnotateTool): void;
+    onColorChange(color: string): void;
+    onStrokeWidthChange(width: number): void;
+    onDeleteSelected(): void;
+    /**
+     * Insert the active drawing tool's default shape at image centre
+     * (Phase 6.3). The panel disables the button when the active tool
+     * is `select`, `freehand`, or `highlight` — see
+     * `isKeyboardPlaceableKind` in core.
+     */
+    onInsertAtCenter(): void;
+}
+export interface AnnotatePanel {
+    readonly container: HTMLDivElement;
+    readonly toolButtons: ReadonlyMap<AnnotateTool, HTMLButtonElement>;
+    readonly hexInput: HTMLInputElement;
+    readonly colorSwatches: ReadonlyArray<HTMLButtonElement>;
+    readonly strokeRange: HTMLInputElement;
+    readonly deleteButton: HTMLButtonElement;
+    readonly insertButton: HTMLButtonElement;
+    setActiveTool(tool: AnnotateTool): void;
+    setStyle(style: StylePalette): void;
+    setCanDelete(canDelete: boolean): void;
+}
+export declare function buildAnnotatePanel(options: AnnotatePanelOptions): AnnotatePanel;
+//# sourceMappingURL=panel.d.ts.map

package/dist/plugins/annotate/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/panel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,gBAAgB,IAAI,IAAI,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAsCD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAoL/E"}

package/dist/plugins/annotate/plugin.d.ts

@@ -0,0 +1,20 @@
+import { type AnnotateState, type UtilityPlugin } from '@magicpages/kalotyp-core';
+export interface AnnotatePluginOptions {
+    /**
+     * Where the plugin's panel UI mounts. The plugin's stage UI is
+     * mounted into the `host` argument of the standard plugin `mount()`
+     * call. Same panel-host-as-closure pattern the other plugins use
+     * (see `crop/plugin.ts`).
+     */
+    readonly panelHost: HTMLElement;
+}
+/**
+ * Build the annotation `UtilityPlugin` instance for one editor
+ * session. Each `openDefaultEditor` call gets a fresh plugin closing
+ * over its own panel host.
+ *
+ * The chain position (annotate before resize) is the editor's
+ * concern; this factory just supplies the bake.
+ */
+export declare function createAnnotatePlugin(options: AnnotatePluginOptions): UtilityPlugin<AnnotateState>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/annotate/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAGnB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAAC,aAAa,CAAC,CAmBjG"}

package/dist/plugins/annotate/pointer-drag.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pointer-drag helper. Same shape as the crop plugin's
+ * `attachPointerDrag` (interaction.ts), kept local here so the
+ * annotation tool gestures can layer their own per-gesture state on
+ * top without coupling to the crop module.
+ *
+ * The factory is invoked on `pointerdown`. It must return a
+ * `DragHandlers` object whose three callbacks describe the gesture's
+ * lifecycle: `onMove(point)` per coalesced animation frame,
+ * `onCommit()` once on `pointerup` (after a final drained move), and
+ * `onCancel()` once on `pointercancel`.
+ *
+ * The factory may return `null` to refuse the gesture — useful when
+ * a hit-area pointerdown only sometimes starts a drag (e.g. the
+ * select tool doesn't drag if no shape is under the pointer).
+ */
+/**
+ * Per-frame point payload. Includes `shiftKey` so tool gestures can
+ * apply axis / square / circle constraints while the modifier is
+ * held — the standard image-editor convention (Figma, Sketch,
+ * Photoshop). The flag reflects shift-state at the most
+ * recent pointer event, so releasing/re-pressing shift mid-drag
+ * toggles the constraint live.
+ */
+export interface DragPoint {
+    readonly clientX: number;
+    readonly clientY: number;
+    readonly shiftKey: boolean;
+}
+export interface DragHandlers {
+    onMove(point: DragPoint): void;
+    onCommit(): void;
+    onCancel(): void;
+}
+export declare function attachPointerDrag(element: HTMLElement, factory: (start: PointerEvent) => DragHandlers | null): () => void;
+/** Convert a client-space point to the bounding-rect-local coords of `element`. */
+export declare function clientToElement(element: HTMLElement, clientX: number, clientY: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=pointer-drag.d.ts.map

package/dist/plugins/annotate/pointer-drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-drag.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/pointer-drag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,QAAQ,IAAI,IAAI,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,GAAG,IAAI,GACpD,MAAM,IAAI,CAsGZ;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAG1B"}

package/dist/plugins/annotate/render.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Render helpers for the annotation plugin's three canvas layers.
+ *
+ *  - `paintImageLayer`: paints the upstream-baked source onto the
+ *    bottom canvas. Called once on mount and on stage resize.
+ *  - `paintShapesLayer`: paints every committed shape onto the middle
+ *    canvas. Called when the shape list, selection, or viewport
+ *    changes.
+ *  - `paintLiveLayer`: paints whatever the in-progress gesture wants
+ *    on top — a draft shape during a drag, a marquee, etc. Called
+ *    per frame during a gesture.
+ *
+ * All three reuse the same DPR-aware canvas-sizing helper to keep the
+ * pixel grids consistent. Shapes are rendered through `paintShape`
+ * from the core `bake.ts` module so the live preview is byte-equal to
+ * the bake output (per shape).
+ */
+import { type Shape, type SourceImage, type Viewport } from '@magicpages/kalotyp-core';
+export declare function paintImageLayer(canvas: HTMLCanvasElement, source: SourceImage, stageWidth: number, stageHeight: number, viewport: Viewport): void;
+/**
+ * Paint a list of shapes by setting up an image-space coordinate
+ * frame and calling the shared `paintShape` for each. The image-space
+ * frame is established by translating to the displayRect's origin and
+ * scaling by the viewport scale; the shapes' image-space coordinates
+ * then land at the right display pixels for free.
+ */
+export declare function paintShapesLayer(canvas: HTMLCanvasElement, shapes: ReadonlyArray<Shape>, stageWidth: number, stageHeight: number, viewport: Viewport): void;
+/**
+ * Paint a single in-progress shape on the live canvas. Same
+ * coordinate setup as the shapes layer; passing `null` clears the
+ * canvas without drawing — useful when a gesture ends.
+ */
+export declare function paintLiveLayer(canvas: HTMLCanvasElement, shape: Shape | null, stageWidth: number, stageHeight: number, viewport: Viewport): void;
+/**
+ * Paint a selection-marquee rectangle (image-space) on the live
+ * canvas. Distinct from `paintLiveLayer` because the marquee uses
+ * dashed strokes + a faint fill — visual conventions for "I am
+ * marquee-selecting" — that don't belong to any committed shape.
+ */
+export declare function paintMarqueeLayer(canvas: HTMLCanvasElement, marqueeImage: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | null, stageWidth: number, stageHeight: number, viewport: Viewport): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/plugins/annotate/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAc,MAAM,0BAA0B,CAAC;AA0BnG,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAYN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,EAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CASN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5E,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CA+BN"}

package/dist/plugins/annotate/selection.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Selection rendering and per-handle resize gesture for annotation
+ * shapes. The selection layer is responsible for:
+ *
+ *  - Rendering the bounding-box outline + 8 corner/edge handles when
+ *    a shape is selected. Arrows render with two endpoint handles
+ *    instead (no orthogonal extent to resize).
+ *  - Wiring each handle's pointerdown to a per-handle resize gesture
+ *    that mutates the shape's geometry as the user drags.
+ *  - Cleaning up handles when the selection clears.
+ *
+ * Handles are positioned in stage CSS pixels using the shared
+ * `position-handles` helper that crop already uses for its 8
+ * manipulators. Reusing that helper keeps the handle DOM consistent
+ * with crop's so future styling can target both with a single rule.
+ */
+import { type AnnotateState, type Shape, type Viewport } from '@magicpages/kalotyp-core';
+import type { ToolGestureContext } from './tools.js';
+/**
+ * Build and own the selection-handle DOM. The returned object exposes
+ * `update(shape, viewport)` so the caller can re-render handles after
+ * any state change without rebuilding the DOM.
+ */
+export interface SelectionLayerOptions {
+    readonly host: HTMLDivElement;
+    readonly stageElement: HTMLElement;
+    readonly toolContext: ToolGestureContext;
+    /** Read the current letterbox viewport at gesture-start time. */
+    getViewport(): Viewport;
+}
+export interface SelectionLayer {
+    /** Update the rendered handles to reflect the selected shape (or clear). */
+    update(shape: Shape | null, viewport: Viewport): void;
+    destroy(): void;
+}
+export declare function buildSelectionLayer(options: SelectionLayerOptions): SelectionLayer;
+/**
+ * Helper for the mount layer: which shape (if any) is selected, given
+ * the current state? Keeps the lookup logic in one place — most
+ * callers in `mount.ts` need it via the store subscription.
+ */
+export declare function selectedShapeOf(state: AnnotateState): Shape | null;
+//# sourceMappingURL=selection.d.ts.map

package/dist/plugins/annotate/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,KAAK,aAAa,EAIlB,KAAK,KAAK,EACV,KAAK,QAAQ,EAKd,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,iEAAiE;IACjE,WAAW,IAAI,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAwElF;AA8ID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,GAAG,IAAI,CAGlE"}

package/dist/plugins/annotate/stage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Build the layered DOM for the annotation plugin's stage. Three
+ * canvases (image, committed shapes, live in-progress) plus three DOM
+ * layers (a hit-area for pointer input, a handles layer for selection
+ * resize handles, and a text-edit overlay) — / Phase 3
+ * brief on stacked canvases.
+ *
+ * The element ordering follows the z-stack: image at the bottom,
+ * shapes and live canvases above it, then the pointer hit-area, then
+ * the handles layer (so handles can intercept pointerdowns before the
+ * hit-area sees them), then the text overlay on top.
+ *
+ * The hit-area is the surface the tool / selection layer attaches its
+ * pointerdown handlers to. It carries `touch-action: none` so the
+ * browser doesn't hijack drags for scroll/pinch on touch devices.
+ */
+export interface AnnotateStageElements {
+    readonly container: HTMLDivElement;
+    readonly imageCanvas: HTMLCanvasElement;
+    readonly shapesCanvas: HTMLCanvasElement;
+    readonly liveCanvas: HTMLCanvasElement;
+    readonly hitArea: HTMLDivElement;
+    /** Holds selection handles (DOM buttons) when a shape is selected. */
+    readonly handlesLayer: HTMLDivElement;
+    /** Holds the inline text editor when text is being edited. */
+    readonly textOverlay: HTMLDivElement;
+}
+export declare function buildAnnotateStage(): AnnotateStageElements;
+//# sourceMappingURL=stage.d.ts.map

package/dist/plugins/annotate/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;CACtC;AAED,wBAAgB,kBAAkB,IAAI,qBAAqB,CA4C1D"}

package/dist/plugins/annotate/text-editor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Inline text editor for the text annotation tool.
+ *
+ * The editor renders a contenteditable `<div>` overlaid on the
+ * annotation's image-space anchor. Using a `<div>` instead of a
+ * `<textarea>` lets us match the canvas-side font and size precisely
+ * (textareas restrict the visible padding/size combination on some
+ * browsers). The element keeps a fixed width by default and grows
+ * vertically with line breaks.
+ *
+ * Lifecycle:
+ *   - `open(shape, viewport)`: position the editor over the shape,
+ *     prefill its text, focus it. Each input event reports the new
+ *     text via `onInput`. Pressing Enter (without Shift) commits;
+ *     pressing Escape cancels.
+ *   - `close()`: hide the editor and blur it.
+ *
+ * The caller is responsible for committing the shape into the store
+ * when the editor closes; the editor is presentational.
+ */
+import { type SourceImage, type TextShape, type Viewport } from '@magicpages/kalotyp-core';
+export interface TextEditorOptions {
+    readonly host: HTMLDivElement;
+    onInput(text: string): void;
+    onCommit(): void;
+    onCancel(): void;
+}
+export interface TextEditorHandle {
+    open(shape: TextShape, viewport: Viewport, source: SourceImage): void;
+    close(): void;
+    destroy(): void;
+}
+export declare function buildTextEditor(options: TextEditorOptions): TextEditorHandle;
+//# sourceMappingURL=text-editor.d.ts.map

package/dist/plugins/annotate/text-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-editor.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/text-editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,IAAI,IAAI,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACtE,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAuG5E"}

package/dist/plugins/annotate/tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Drawing-tool gesture factories. Each function builds the
+ * pointer-drag handlers for one tool (rect, ellipse, arrow, freehand,
+ * highlight, plus body-move for the select tool). Text and select
+ * dispatch are handled in `mount.ts` because they don't fit the
+ * "drag-to-create" shape these factories codify.
+ *
+ * Each gesture:
+ *   1. Mints a fresh shape id and creates an in-progress shape.
+ *   2. On every coalesced pointermove, the shape's geometry is
+ *      updated and rendered into the live canvas (caller-supplied).
+ *   3. On commit (`pointerup`), the shape is added to the store and
+ *      a `commit` event is emitted so the editor history snapshots.
+ *      A degenerate shape (zero-extent rect, single-tap freehand) is
+ *      dropped instead of committed — the user obviously didn't mean
+ *      to draw anything.
+ */
+import { type AnnotateState, type Point, type Shape, type Store } from '@magicpages/kalotyp-core';
+import type { DragHandlers } from './pointer-drag.js';
+export interface ToolGestureContext {
+    readonly store: Store<AnnotateState>;
+    /** Project a raw client-space pointer to image-space pixels. */
+    toImageSpace(clientPoint: {
+        clientX: number;
+        clientY: number;
+    }): Point;
+    /** Update the live canvas with the in-progress shape. */
+    setLiveShape(shape: Shape | null): void;
+    /** Emit the editor's history-commit signal. */
+    commit(): void;
+}
+export declare function startRectGesture(ctx: ToolGestureContext, origin: PointerEvent): DragHandlers;
+export declare function startEllipseGesture(ctx: ToolGestureContext, origin: PointerEvent): DragHandlers;
+export declare function startArrowGesture(ctx: ToolGestureContext, origin: PointerEvent): DragHandlers;
+export declare function startFreehandGesture(ctx: ToolGestureContext, origin: PointerEvent, options: {
+    kind: 'freehand' | 'highlight';
+}): DragHandlers;
+/**
+ * Body-drag (move) gesture used by the select tool when the user
+ * presses on an already-selected shape and drags. Translates the
+ * shape by the per-frame delta; commits on pointerup. The caller
+ * supplies the `translate` and `replace` closures so this stays
+ * decoupled from the store-write specifics.
+ */
+export declare function startBodyMoveGesture(ctx: ToolGestureContext, origin: PointerEvent, shapeId: string, initialShape: Shape, translate: (shape: Shape, dx: number, dy: number) => Shape, replace: (shape: Shape) => void): DragHandlers;
+//# sourceMappingURL=tools.d.ts.map

package/dist/plugins/annotate/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/plugins/annotate/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,KAAK,aAAa,EAOlB,KAAK,KAAK,EAEV,KAAK,KAAK,EACV,KAAK,KAAK,EAMX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6CtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,gEAAgE;IAChE,YAAY,CAAC,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACvE,yDAAyD;IACzD,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,+CAA+C;IAC/C,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAiD5F;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAgD/F;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CA+C7F;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE;IAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAC1C,YAAY,CAiFd;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,KAAK,EAC1D,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC9B,YAAY,CAgBd"}

package/dist/plugins/crop/interaction.d.ts

@@ -0,0 +1,17 @@
+import { type CropState, type HandleDirection, type Store, type Viewport } from '@magicpages/kalotyp-core';
+export interface CropInteractionElements {
+    readonly stageElement: HTMLElement;
+    readonly handles: Readonly<Record<HandleDirection, HTMLElement>>;
+    readonly bodyHitArea: HTMLElement;
+}
+export interface CropInteractionContext {
+    getViewport(): Viewport;
+    /** Called once on pointerup so editor history can snapshot. Optional for tests. */
+    onCommit?: () => void;
+}
+export interface CropInteractionHandle {
+    destroy(): void;
+}
+/** Wire eight-handle resize + body translate onto the crop rect. Per-frame rAF-coalesced. */
+export declare function bindCropInteractions(elements: CropInteractionElements, store: Store<CropState>, ctx: CropInteractionContext): CropInteractionHandle;
+//# sourceMappingURL=interaction.d.ts.map

package/dist/plugins/crop/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../src/plugins/crop/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EAEpB,KAAK,KAAK,EACV,KAAK,QAAQ,EAId,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,IAAI,QAAQ,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EACvB,GAAG,EAAE,sBAAsB,GAC1B,qBAAqB,CAcvB"}

package/dist/plugins/crop/mount.d.ts

@@ -0,0 +1,19 @@
+import { type CropPreset, type CropPresetFilter, type CropState, type SourceImage, type Store, type ViewportController, initialCropState } from '@magicpages/kalotyp-core';
+export interface MountCropOptions {
+    readonly stageHost: HTMLElement;
+    readonly utilHost: HTMLElement;
+    readonly source: SourceImage;
+    readonly presets: readonly CropPreset[];
+    readonly presetFilter: CropPresetFilter | undefined;
+    readonly store: Store<CropState>;
+    /** Editor-level zoom + pan. Optional — falls back to fit-only viewports when absent. */
+    readonly viewport?: ViewportController;
+    readonly onCommit?: () => void;
+}
+export interface MountCropHandle {
+    destroy(): void;
+}
+/** Mount the crop UI. Expects the store pre-initialised via `initialCropState`. */
+export declare function mountCropUtility(options: MountCropOptions): MountCropHandle;
+export { initialCropState };
+//# sourceMappingURL=mount.d.ts.map

package/dist/plugins/crop/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/plugins/crop/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,KAAK,EAEV,KAAK,kBAAkB,EAKvB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAQlC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAID,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAmJ3E;AAuFD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/plugins/crop/plugin.d.ts

@@ -0,0 +1,11 @@
+import { type CropPreset, type CropPresetFilter, type CropState, type UtilityPlugin } from '@magicpages/kalotyp-core';
+export interface CropPluginOptions {
+    /** The 12 presets Ghost passes (or any caller-supplied subset). */
+    readonly presets: readonly CropPreset[];
+    /** Orientation filter (Ghost always passes 'landscape'). */
+    readonly presetFilter: CropPresetFilter | undefined;
+    /** Panel host (closed-over); stage host is the `mount()` argument. */
+    readonly panelHost: HTMLElement;
+}
+export declare function createCropPlugin(options: CropPluginOptions): UtilityPlugin<CropState>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/crop/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/crop/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAGnB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA2BrF"}

package/dist/plugins/filter/mount.d.ts

@@ -0,0 +1,16 @@
+import { type FinetuneState, type SourceImage, type Store, type ViewportController } from '@magicpages/kalotyp-core';
+export interface MountFilterOptions {
+    readonly stageHost: HTMLElement;
+    readonly utilHost: HTMLElement;
+    /** Upstream-baked source (same input as the finetune tab — filter shares finetune's slot). */
+    readonly source: SourceImage;
+    /** Shared store with finetune; clicking a thumbnail writes here. */
+    readonly store: Store<FinetuneState>;
+    readonly viewport?: ViewportController;
+    readonly onCommit?: () => void;
+}
+export interface MountFilterHandle {
+    destroy(): void;
+}
+export declare function mountFilterUtility(options: MountFilterOptions): MountFilterHandle;
+//# sourceMappingURL=mount.d.ts.map

package/dist/plugins/filter/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/plugins/filter/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAgHjF"}

package/dist/plugins/filter/plugin.d.ts

@@ -0,0 +1,10 @@
+import { type FinetuneState, type UtilityPlugin } from '@magicpages/kalotyp-core';
+export interface FilterPluginOptions {
+    readonly panelHost: HTMLElement;
+}
+/**
+ * Filter plugin. Shares the finetune slot's store; `init`/`bake` here are synthetic
+ * (filter isn't in CHAIN_ORDER and the editor registers the slot manually with the shared store).
+ */
+export declare function createFilterPlugin(options: FilterPluginOptions): UtilityPlugin<FinetuneState>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/filter/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/filter/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAAC,aAAa,CAAC,CAiB7F"}