@magicpages/kalotyp-ui 0.1.0

package/dist/canvas/position-handles.d.ts

@@ -0,0 +1,18 @@
+import { type CornerHandle, type EdgeHandle, type Rect, type Viewport } from '@magicpages/kalotyp-core';
+/**
+ * Position corner anchors, edge handles, and body hit-area to match the crop rect.
+ *
+ * Corner buttons aren't positioned directly: they live inside an anchor that sits at the
+ * corner point, and host CSS (Ghost's `pintura.css` or our `crop.css`) shifts the button
+ * by `-20px` so its 20×20 bracket pseudo-element aligns with the corner. Edges are inset
+ * by 12px on each end so they don't overlap the corner brackets.
+ */
+export interface PositionHandlesInput {
+    readonly cropRectImage: Rect;
+    readonly viewport: Viewport;
+    readonly cornerAnchors: Readonly<Record<CornerHandle, HTMLElement>>;
+    readonly edgeHandles: Readonly<Record<EdgeHandle, HTMLElement>>;
+    readonly bodyHitArea: HTMLElement;
+}
+export declare function positionHandles(input: PositionHandlesInput): void;
+//# sourceMappingURL=position-handles.d.ts.map

package/dist/canvas/position-handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-handles.d.ts","sourceRoot":"","sources":["../../src/canvas/position-handles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CA+BjE"}

package/dist/canvas/preview-canvas.d.ts

@@ -0,0 +1,21 @@
+import { type SourceImage, type Viewport, type ViewportController } from '@magicpages/kalotyp-core';
+declare const STAGE_PADDING_PX = 32;
+export interface PreviewCanvas {
+    readonly container: HTMLDivElement;
+    readonly canvas: HTMLCanvasElement;
+}
+export declare function buildPreviewCanvas(): PreviewCanvas;
+/** Compute the letterboxed viewport for a preview. Returns `undefined` if the container has no laid-out size yet. */
+export declare function previewViewportFor(container: HTMLElement, intrinsic: {
+    width: number;
+    height: number;
+}, controller?: ViewportController): {
+    viewport: Viewport;
+    stageWidth: number;
+    stageHeight: number;
+} | undefined;
+/** Paint into a preview canvas. The callback receives a DPR-scaled context positioned at (0,0) in stage CSS pixels. */
+export declare function paintPreview(canvas: HTMLCanvasElement, stageWidth: number, stageHeight: number, draw: (ctx: CanvasRenderingContext2D) => void): void;
+export { STAGE_PADDING_PX };
+export type { SourceImage };
+//# sourceMappingURL=preview-canvas.d.ts.map

package/dist/canvas/preview-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-canvas.d.ts","sourceRoot":"","sources":["../../src/canvas/preview-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAElC,QAAA,MAAM,gBAAgB,KAAK,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAUlD;AAED,qHAAqH;AACrH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5C,UAAU,CAAC,EAAE,kBAAkB,GAC9B;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQ7E;AAED,uHAAuH;AACvH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAC5C,IAAI,CAgBN;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/canvas/render-image.d.ts

@@ -0,0 +1,4 @@
+import type { Viewport } from '@magicpages/kalotyp-core';
+/** Paint the source image onto the canvas at the viewport's display size, DPR-scaled. */
+export declare function renderImageCanvas(canvas: HTMLCanvasElement, source: CanvasImageSource, stageWidth: number, stageHeight: number, viewport: Viewport): void;
+//# sourceMappingURL=render-image.d.ts.map

package/dist/canvas/render-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-image.d.ts","sourceRoot":"","sources":["../../src/canvas/render-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,yFAAyF;AACzF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAoBN"}

package/dist/canvas/render-overlay.d.ts

@@ -0,0 +1,4 @@
+import { type Rect, type Viewport } from '@magicpages/kalotyp-core';
+/** Repaint the overlay: dim mask outside the crop rect, outline, and rule-of-thirds grid. */
+export declare function renderOverlayCanvas(canvas: HTMLCanvasElement, cropRectImage: Rect, stageWidth: number, stageHeight: number, viewport: Viewport): void;
+//# sourceMappingURL=render-overlay.d.ts.map

package/dist/canvas/render-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-overlay.d.ts","sourceRoot":"","sources":["../../src/canvas/render-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AAcxF,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,IAAI,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAyCN"}

package/dist/canvas/stage-gestures.d.ts

@@ -0,0 +1,12 @@
+import type { ViewportController } from '@magicpages/kalotyp-core';
+/**
+ * Editor-level wheel + multi-pointer (pinch / two-finger pan) handler driving a `ViewportController`.
+ *
+ * - Wheel: zoom anchored at the cursor (1.0015 per `deltaY` unit).
+ * - Two pointers: pinch + pan applied together each frame (no pinch-vs-pan state machine —
+ *   applying both feels more natural and matches Snapseed / Apple Photos).
+ * - Single pointer: pass-through to plugin gestures.
+ */
+export type StageGestureHandle = () => void;
+export declare function attachStageGestures(stage: HTMLElement, controller: ViewportController): StageGestureHandle;
+//# sourceMappingURL=stage-gestures.d.ts.map

package/dist/canvas/stage-gestures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-gestures.d.ts","sourceRoot":"","sources":["../../src/canvas/stage-gestures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAe5C,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CA0HpB"}

package/dist/cheatsheet/modal.d.ts

@@ -0,0 +1,10 @@
+/** Cheatsheet modal — renders `KEYBOARD_SHORTCUTS` grouped by context. Opened via `?`. */
+export interface OpenCheatsheetOptions {
+    readonly host: HTMLElement;
+    onClose(): void;
+}
+export interface CheatsheetHandle {
+    close(): void;
+}
+export declare function openCheatsheet(options: OpenCheatsheetOptions): CheatsheetHandle;
+//# sourceMappingURL=modal.d.ts.map

package/dist/cheatsheet/modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../src/cheatsheet/modal.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAU1F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,IAAI,CAAC;CACf;AASD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAsB/E"}

package/dist/dom/build-preset-row.d.ts

@@ -0,0 +1,10 @@
+import type { CropPreset } from '@magicpages/kalotyp-core';
+export interface PresetRowElements {
+    readonly container: HTMLDivElement;
+    readonly buttons: readonly HTMLButtonElement[];
+}
+/** Build the aspect-ratio preset row. `activeIndex` indexes into the visible presets passed in. */
+export declare function buildPresetRow(visiblePresets: readonly CropPreset[], activeIndex: number, onSelect: (visibleIndex: number, preset: CropPreset) => void): PresetRowElements;
+/** Update the active state of an existing preset row in place. */
+export declare function setActivePresetButton(buttons: readonly HTMLButtonElement[], activeIndex: number): void;
+//# sourceMappingURL=build-preset-row.d.ts.map

package/dist/dom/build-preset-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-preset-row.d.ts","sourceRoot":"","sources":["../../src/dom/build-preset-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAC5B,cAAc,EAAE,SAAS,UAAU,EAAE,EACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,GAC3D,iBAAiB,CAsBnB;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,WAAW,EAAE,MAAM,GAClB,IAAI,CAIN"}

package/dist/dom/build-shell-dom.d.ts

@@ -0,0 +1,39 @@
+export interface ShellDom {
+    readonly editor: HTMLElement;
+    readonly modal: HTMLElement;
+    readonly root: HTMLElement;
+    readonly main: HTMLElement;
+    readonly stage: HTMLElement;
+    readonly navTools: HTMLElement;
+    readonly utilMain: HTMLElement;
+    readonly utilFooter: HTMLElement;
+    readonly closeButton: HTMLButtonElement;
+    /** Gear icon — opens the Preferences modal. */
+    readonly prefsButton: HTMLButtonElement;
+    readonly exportButton: HTMLButtonElement;
+    /** Caret next to Save — opens the output-format popover; the Save button itself bypasses it. */
+    readonly outputSettingsButton: HTMLButtonElement;
+    /** Visually-hidden polite live region for one-shot announcements. */
+    readonly liveRegion: HTMLElement;
+    readonly titleId: string;
+}
+export interface BuildShellDomOptions {
+    exportLabel: string;
+}
+/**
+ * Build the DOM skeleton for an editor session.
+ *
+ * The editor's own structure is namespaced `kalotyp-*`. Two class tokens are
+ * the exception — `pintura-editor` on the host and `PinturaModal` on the modal
+ * wrapper. Ghost's runtime looks those up by name (the host class scopes Ghost's
+ * theme-variable overrides; the modal class is what Ghost's close-button click
+ * handler selects on), so they exist purely for Ghost compatibility — not as
+ * branding, and implying no affiliation with or endorsement by the editor Ghost
+ * named them after. See `docs/ghost-contract.md`. The integration breaks if
+ * those two tokens change.
+ *
+ * The util-main `aria-labelledby` is updated on tab switch by `setActiveUtilityButton`
+ * to complete the tablist/tab/tabpanel triple.
+ */
+export declare function buildShellDom(options: BuildShellDomOptions): ShellDom;
+//# sourceMappingURL=build-shell-dom.d.ts.map

package/dist/dom/build-shell-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-shell-dom.d.ts","sourceRoot":"","sources":["../../src/dom/build-shell-dom.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,gGAAgG;IAChG,QAAQ,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;IACjD,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,QAAQ,CAgIrE"}

package/dist/dom/build-stage.d.ts

@@ -0,0 +1,19 @@
+import type { CornerHandle, HandleDirection } from '@magicpages/kalotyp-core';
+export interface StageElements {
+    readonly container: HTMLDivElement;
+    readonly imageCanvas: HTMLCanvasElement;
+    readonly overlayCanvas: HTMLCanvasElement;
+    readonly handlesLayer: HTMLDivElement;
+    readonly handles: Readonly<Record<HandleDirection, HTMLButtonElement>>;
+    /**
+     * Per-corner wrapper providing the positioning context Ghost's pintura.css expects:
+     * `[data-direction=tr|bl|br] { left/top: -20px !important }` resolves against this
+     * anchor, not the stage. Without it three corner buttons end up off-screen.
+     */
+    readonly cornerAnchors: Readonly<Record<CornerHandle, HTMLDivElement>>;
+    /** Body drag surface — under handles, above canvases in z-order. */
+    readonly bodyHitArea: HTMLDivElement;
+}
+/** Build the interactive crop UI inside the stage. Class names and data-* come from the Ghost contract. */
+export declare function buildStageElements(): StageElements;
+//# sourceMappingURL=build-stage.d.ts.map

package/dist/dom/build-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stage.d.ts","sourceRoot":"","sources":["../../src/dom/build-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACvE;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;IACvE,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;CACtC;AAKD,2GAA2G;AAC3G,wBAAgB,kBAAkB,IAAI,aAAa,CAqDlD"}

package/dist/dom/build-util-nav.d.ts

@@ -0,0 +1,18 @@
+import type { UtilityId } from '@magicpages/kalotyp-core';
+export interface UtilityNavEntry {
+    readonly id: UtilityId;
+    readonly label: string;
+}
+export interface UtilityNavElements {
+    readonly container: HTMLDivElement;
+    readonly buttons: ReadonlyMap<UtilityId, HTMLButtonElement>;
+}
+export interface BuildUtilityNavOptions {
+    /** Tabpanel id wired into each tab's `aria-controls` to complete the tablist/tab/tabpanel triple. */
+    panelId: string;
+}
+/** Build the utility nav. Roving-tabindex per WAI-ARIA APG: active tab `tabindex=0`, others `-1`; Left/Right/Home/End move active state. */
+export declare function buildUtilityNav(entries: readonly UtilityNavEntry[], initialActive: UtilityId, onSelect: (id: UtilityId) => void, options: BuildUtilityNavOptions): UtilityNavElements;
+/** Update active tab state and scroll the newly-active tab into view (no-op on non-overflowing desktop strips). */
+export declare function setActiveUtilityButton(nav: UtilityNavElements, active: UtilityId, panel?: HTMLElement): void;
+//# sourceMappingURL=build-util-nav.d.ts.map

package/dist/dom/build-util-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-util-nav.d.ts","sourceRoot":"","sources":["../../src/dom/build-util-nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,sBAAsB;IACrC,qGAAqG;IACrG,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4IAA4I;AAC5I,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,aAAa,EAAE,SAAS,EACxB,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,EACjC,OAAO,EAAE,sBAAsB,GAC9B,kBAAkB,CAqDpB;AAED,mHAAmH;AACnH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,WAAW,GAClB,IAAI,CAeN"}

package/dist/dom/focus-trap.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Focus trap + initial-focus + restore-on-release for the editor dialog.
+ *
+ * The Tab keydown path doesn't trap screen readers' virtual cursors — `aria-modal=true`
+ * is what makes content outside the dialog inert for assistive tech. On release, focus
+ * returns to the element that was active before the trap installed (usually the trigger).
+ */
+export interface InstallFocusTrapOptions {
+    readonly host: HTMLElement;
+    /** Element to focus on mount. Defaults to the first focusable descendant of `host`. */
+    readonly initialFocus?: HTMLElement;
+}
+export interface FocusTrapHandle {
+    /** Hook for future use; currently a no-op because focusables are re-queried on every Tab. */
+    refresh(): void;
+    /** Tear down listeners and restore focus to the trigger element. */
+    release(): void;
+}
+/** Install the focus trap and seed initial focus. */
+export declare function installFocusTrap(options: InstallFocusTrapOptions): FocusTrapHandle;
+//# sourceMappingURL=focus-trap.d.ts.map

package/dist/dom/focus-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-trap.d.ts","sourceRoot":"","sources":["../../src/dom/focus-trap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,OAAO,IAAI,IAAI,CAAC;IAChB,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,eAAe,CA2DlF"}

package/dist/dom/nested-modal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Nested overlay (modal or anchored popover) used for the Output popover, Preferences modal,
+ * and Keyboard cheatsheet. Lives inside the editor host so the editor's click-capture scope
+ * and Ghost's modal-service allowlist still cover it. Traps Tab in capture phase so it wins
+ * over the editor's outer trap.
+ */
+export interface NestedModalOptions {
+    readonly host: HTMLElement;
+    /** When supplied, the overlay positions as a popover above this element instead of centred. */
+    readonly anchor?: HTMLElement;
+    readonly title: string;
+    readonly body: HTMLElement;
+    /** CSS class added to the overlay container. */
+    readonly variant?: string;
+    /** Default true; the popover variant typically sets false (Esc / click-outside dismiss). */
+    readonly showCloseButton?: boolean;
+    readonly onClose: () => void;
+}
+export interface NestedModalHandle {
+    readonly element: HTMLElement;
+    close(): void;
+}
+/** Open a nested modal or anchored popover. Caller owns the body content. */
+export declare function openNestedModal(options: NestedModalOptions): NestedModalHandle;
+//# sourceMappingURL=nested-modal.d.ts.map

package/dist/dom/nested-modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-modal.d.ts","sourceRoot":"","sources":["../../src/dom/nested-modal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAiI9E"}

package/dist/icons.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Icon library sourced from Lucide (ISC). Each icon is a named import so the
+ * bundler tree-shakes unused glyphs. We stringify nodes ourselves rather than
+ * use Lucide's `createElement` to avoid pulling its DOM runtime into the bundle.
+ */
+type IconNode = ReadonlyArray<readonly [string, Record<string, string | number>]>;
+/** Stringify a Lucide icon node to inline SVG markup. */
+export declare function iconHtml(node: IconNode, attrs?: Record<string, string | number>): string;
+export type IconName = 'select' | 'text' | 'rect' | 'ellipse' | 'arrow' | 'freehand' | 'highlight' | 'undo' | 'redo' | 'close' | 'delete' | 'check' | 'lockClosed' | 'lockOpen' | 'plus' | 'flipHorizontal' | 'flipVertical' | 'chevronDown' | 'settings' | 'keyboard';
+/** Render an icon by name. */
+export declare function icon(name: IconName, attrs?: Record<string, string | number>): string;
+export {};
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,KAAK,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAelF,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,GAAG,MAAM,CAc5F;AAED,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,UAAU,GACV,WAAW,GACX,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,UAAU,GACV,MAAM,GACN,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,UAAU,GACV,UAAU,CAAC;AA+Cf,8BAA8B;AAC9B,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAEpF"}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import './styles/base.css';
+import './styles/crop.css';
+import './styles/transform.css';
+import './styles/annotate.css';
+import './styles/finetune.css';
+import './styles/filter.css';
+import './styles/redact.css';
+import './styles/frame.css';
+import './styles/output.css';
+import './styles/preferences.css';
+import './styles/cheatsheet.css';
+import './styles/mobile.css';
+export { mountShell } from './shell.js';
+export type { ShellHandle, ShellOptions } from './shell.js';
+export { mountCropUtility } from './plugins/crop/mount.js';
+export type { MountCropOptions, MountCropHandle } from './plugins/crop/mount.js';
+export { createCropPlugin } from './plugins/crop/plugin.js';
+export type { CropPluginOptions } from './plugins/crop/plugin.js';
+export { mountFlipUtility } from './plugins/flip/mount.js';
+export type { MountFlipOptions, MountFlipHandle } from './plugins/flip/mount.js';
+export { createFlipPlugin } from './plugins/flip/plugin.js';
+export type { FlipPluginOptions } from './plugins/flip/plugin.js';
+export { mountRotateUtility } from './plugins/rotate/mount.js';
+export type { MountRotateOptions, MountRotateHandle } from './plugins/rotate/mount.js';
+export { createRotatePlugin } from './plugins/rotate/plugin.js';
+export type { RotatePluginOptions } from './plugins/rotate/plugin.js';
+export { mountResizeUtility } from './plugins/resize/mount.js';
+export type { MountResizeOptions, MountResizeHandle } from './plugins/resize/mount.js';
+export { createResizePlugin } from './plugins/resize/plugin.js';
+export type { ResizePluginOptions } from './plugins/resize/plugin.js';
+export { mountFinetuneUtility } from './plugins/finetune/mount.js';
+export type { MountFinetuneOptions, MountFinetuneHandle, } from './plugins/finetune/mount.js';
+export { createFinetunePlugin } from './plugins/finetune/plugin.js';
+export type { FinetunePluginOptions } from './plugins/finetune/plugin.js';
+export { mountFilterUtility } from './plugins/filter/mount.js';
+export type { MountFilterOptions, MountFilterHandle, } from './plugins/filter/mount.js';
+export { createFilterPlugin } from './plugins/filter/plugin.js';
+export type { FilterPluginOptions } from './plugins/filter/plugin.js';
+export { mountAnnotateUtility } from './plugins/annotate/mount.js';
+export type { MountAnnotateOptions, MountAnnotateHandle, } from './plugins/annotate/mount.js';
+export { createAnnotatePlugin } from './plugins/annotate/plugin.js';
+export type { AnnotatePluginOptions } from './plugins/annotate/plugin.js';
+export { mountRedactUtility } from './plugins/redact/mount.js';
+export type { MountRedactOptions, MountRedactHandle, } from './plugins/redact/mount.js';
+export { createRedactPlugin } from './plugins/redact/plugin.js';
+export type { RedactPluginOptions } from './plugins/redact/plugin.js';
+export { mountFrameUtility } from './plugins/frame/mount.js';
+export type { MountFrameOptions, MountFrameHandle } from './plugins/frame/mount.js';
+export { createFramePlugin } from './plugins/frame/plugin.js';
+export type { FramePluginOptions } from './plugins/frame/plugin.js';
+export { buildUtilityNav, setActiveUtilityButton, type UtilityNavElements, type UtilityNavEntry, } from './dom/build-util-nav.js';
+export { installFocusTrap, type FocusTrapHandle, type InstallFocusTrapOptions, } from './dom/focus-trap.js';
+export { attachStageGestures, type StageGestureHandle } from './canvas/stage-gestures.js';
+export { icon, iconHtml, type IconName } from './icons.js';
+export { openNestedModal, type NestedModalHandle, type NestedModalOptions, } from './dom/nested-modal.js';
+export { openOutputPopover, type OpenOutputPopoverOptions, type OutputPopoverHandle, } from './output/popover.js';
+export { DEFAULT_PREFERENCES, getSiteScope, loadPreferences, savePreferences, type KalotypPreferences, } from './preferences/storage.js';
+export { openPreferencesModal, type OpenPreferencesModalOptions, type PreferencesModalHandle, } from './preferences/modal.js';
+export { openCheatsheet, type OpenCheatsheetOptions, type CheatsheetHandle, } from './cheatsheet/modal.js';
+export { KEYBOARD_SHORTCUTS, KEYBOARD_SHORTCUT_CONTEXT_LABELS, type KeyboardShortcut, type KeyboardShortcutContext, } from './keyboard-shortcuts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}