@magicpages/kalotyp-core 0.1.0

package/dist/plugins/redact/bake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake.d.ts","sourceRoot":"","sources":["../../../src/plugins/redact/bake.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,8EAA8E;AAC9E,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAoBtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,wBAAwB,GAAG,iCAAiC,EACjE,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,WAAW,GAClB,IAAI,CAmBN"}

package/dist/plugins/redact/state.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Redact state and mutators. Mirrors the annotate plugin's vocabulary
+ * (id + kind, monotonic mint, replace/delete) so the selection layer
+ * can be reused.
+ */
+import type { Rect } from '../../geometry/rect.js';
+/** `pixelate`, `blur`, or `solid` (flat fill). */
+export type RedactMode = 'pixelate' | 'blur' | 'solid';
+export declare const REDACT_MODES: readonly RedactMode[];
+export interface RedactRegion {
+    /** Stable per-session id; survives undo/redo. */
+    readonly id: string;
+    /** Image-space rectangle. May be temporarily negative-extent mid-drag. */
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly mode: RedactMode;
+    /** Used only when `mode === 'solid'`. CSS hex string. */
+    readonly color: string;
+}
+export interface RedactState {
+    readonly regions: ReadonlyArray<RedactRegion>;
+    /** Monotonic id source for new regions. Never decreases. */
+    readonly nextRegionNumber: number;
+    /** The currently-selected region id, or `null` when none. */
+    readonly selectedId: string | null;
+    /** The mode new regions are created with. Persists across selections. */
+    readonly currentMode: RedactMode;
+    /** Default fill colour for the `solid` mode. */
+    readonly currentColor: string;
+    /** Image-space dimensions of the upstream-baked source the plugin was mounted on. */
+    readonly imageSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export declare const DEFAULT_REDACT_COLOR = "#000000";
+export declare const DEFAULT_REDACT_MODE: RedactMode;
+export interface InitialRedactStateInput {
+    readonly imageSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export declare function initialRedactState(input: InitialRedactStateInput): RedactState;
+/** Allocate a new region id; caller threads `nextRegionNumber` back into state. */
+export declare function mintRegionId(state: RedactState): {
+    id: string;
+    nextRegionNumber: number;
+};
+export declare function addRegion(state: RedactState, region: RedactRegion): RedactState;
+export declare function replaceRegion(state: RedactState, region: RedactRegion): RedactState;
+export declare function deleteRegion(state: RedactState, id: string): RedactState;
+/** Mirror every region across an axis of `dims`. */
+export declare function mirrorRegions(state: RedactState, axis: 'horizontal' | 'vertical', dims: {
+    readonly width: number;
+    readonly height: number;
+}): RedactState;
+/** Translate every region by `(dx, dy)`. Out-of-bounds regions are kept (bake clips on Save). */
+export declare function translateRegions(state: RedactState, dx: number, dy: number, dims: {
+    readonly width: number;
+    readonly height: number;
+}): RedactState;
+/**
+ * Rotate every region `turns × 90°` CW around the image centre. Caller
+ * passes post-rotation dims as `newDims`; pre-rotation dims come from
+ * `state.imageSize`.
+ */
+export declare function rotateRegions(state: RedactState, turns: 0 | 1 | 2 | 3, newDims: {
+    readonly width: number;
+    readonly height: number;
+}): RedactState;
+export declare function selectRegion(state: RedactState, id: string | null): RedactState;
+export declare function setCurrentMode(state: RedactState, mode: RedactMode): RedactState;
+export declare function setCurrentColor(state: RedactState, color: string): RedactState;
+/** Update the mode of a region; `color` is preserved across mode flips. */
+export declare function setRegionMode(state: RedactState, id: string, mode: RedactMode): RedactState;
+export declare function setRegionColor(state: RedactState, id: string, color: string): RedactState;
+export declare function findRegion(state: RedactState, id: string | null): RedactRegion | undefined;
+export declare function selectedRegionOf(state: RedactState): RedactRegion | null;
+/** Normalise a region's rect so `width` / `height` are non-negative. */
+export declare function normaliseRegionExtent(extent: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** Default-sized region centred on the image. Used by the keyboard "Insert" path. */
+export interface CreateCenteredRegionContext {
+    readonly imageSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly mode: RedactMode;
+    readonly color: string;
+    readonly id: string;
+}
+export declare function createCenteredRegion(ctx: CreateCenteredRegionContext): RedactRegion;
+/** Clamp regions against new bounds; drop regions fully outside. "Clamp, don't reset". */
+export declare function revalidateAgainstBounds(state: RedactState, bounds: {
+    width: number;
+    height: number;
+}): RedactState;
+/** Bounding-box shape used by the selection layer; matches `Rect`. */
+export declare function regionBoundingBox(region: RedactRegion): Rect;
+//# sourceMappingURL=state.d.ts.map

package/dist/plugins/redact/state.d.ts.map

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

package/dist/plugins/resize/bake.d.ts

@@ -0,0 +1,9 @@
+import type { SourceImage } from '../utility.js';
+import { type ResizeState } from './state.js';
+/**
+ * Resize `source` to the dimensions implied by `state`. Downscales > 2×
+ * run a halving pyramid first so the bilinear-ish `drawImage` scaler
+ * doesn't alias.
+ */
+export declare function bakeResize(state: ResizeState, source: SourceImage): Promise<SourceImage>;
+//# sourceMappingURL=bake.d.ts.map

package/dist/plugins/resize/bake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake.d.ts","sourceRoot":"","sources":["../../../src/plugins/resize/bake.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,YAAY,CAAC;AAE/E;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC9F"}

package/dist/plugins/resize/state.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Per-axis scale factors. `lockAspect` makes the editor keep `scaleX === scaleY`.
+ * Output pixels are computed at bake time as `round(upstream * scale)`,
+ * clamped to `[MIN_DIMENSION, MAX_DIMENSION]`.
+ */
+export interface ResizeState {
+    readonly scaleX: number;
+    readonly scaleY: number;
+    readonly lockAspect: boolean;
+}
+export declare const MAX_DIMENSION = 8000;
+export declare const MIN_DIMENSION = 1;
+export declare function initialResizeState(): ResizeState;
+export declare function isResizeNoOp(state: ResizeState): boolean;
+/** Integer output dimensions for an upstream image, clamped per axis. */
+export declare function resolveOutputSize(state: ResizeState, upstream: {
+    readonly width: number;
+    readonly height: number;
+}): {
+    width: number;
+    height: number;
+};
+/** Set width via a pixel value; with `lockAspect` the vertical scale follows. */
+export declare function setWidthPx(state: ResizeState, widthPx: number, upstream: {
+    readonly width: number;
+    readonly height: number;
+}): ResizeState;
+export declare function setHeightPx(state: ResizeState, heightPx: number, upstream: {
+    readonly width: number;
+    readonly height: number;
+}): ResizeState;
+/** Uniform percentage change; always touches both axes regardless of `lockAspect`. */
+export declare function setPercent(state: ResizeState, percent: number): ResizeState;
+export declare function setLockAspect(state: ResizeState, locked: boolean): ResizeState;
+/** Percent display value; when axes differ, returns the larger scale. */
+export declare function effectivePercent(state: ResizeState): number;
+//# sourceMappingURL=state.d.ts.map

package/dist/plugins/resize/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/plugins/resize/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAInC;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D,WAAW,CAMb;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D,WAAW,CAMb;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAG3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,CAM9E;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAG3D"}

package/dist/plugins/rotate/bake.d.ts

@@ -0,0 +1,9 @@
+import type { SourceImage } from '../utility.js';
+import { type RotateState } from './state.js';
+/**
+ * Apply rotation = quarter-turns + free-angle in one `drawImage`. Free
+ * angles auto-crop to the largest same-aspect rect inside the rotated
+ * bounding box so transparent corners stay out of the output.
+ */
+export declare function bakeRotate(state: RotateState, source: SourceImage): Promise<SourceImage>;
+//# sourceMappingURL=bake.d.ts.map

package/dist/plugins/rotate/bake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake.d.ts","sourceRoot":"","sources":["../../../src/plugins/rotate/bake.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,YAAY,CAAC;AAE/E;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CA0C9F"}

package/dist/plugins/rotate/inscribe.d.ts

@@ -0,0 +1,14 @@
+import type { Size } from '../../geometry/rect.js';
+/**
+ * Largest axis-aligned rect of the source's aspect ratio that fits
+ * inside the source rotated by `angleRad`. Used by free-angle rotation
+ * to avoid transparent corners.
+ *
+ * The two binding constraints reduce to
+ *   `2x ≤ W² / (W|cosθ| + H|sinθ|)`
+ *   `2x ≤ W·H / (W|sinθ| + H|cosθ|)`
+ * — the inscribed half-width is the smaller bound. Works on absolute
+ * sin/cos so the result is symmetric in the sign of the angle.
+ */
+export declare function largestInscribedRect(source: Size, angleRad: number): Size;
+//# sourceMappingURL=inscribe.d.ts.map

package/dist/plugins/rotate/inscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inscribe.d.ts","sourceRoot":"","sources":["../../../src/plugins/rotate/inscribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgBzE"}

package/dist/plugins/rotate/state.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Independent quarter-turns (lossless 90° CW) and free angle (±45°).
+ * Bake applies `quarterTurns * 90° + freeAngle` so a press of "rotate 90°"
+ * doesn't reset a straighten correction and vice versa.
+ */
+export interface RotateState {
+    readonly quarterTurns: 0 | 1 | 2 | 3;
+    /** Free-angle offset in degrees. Range: [-45, 45]. */
+    readonly freeAngle: number;
+}
+export declare const FREE_ANGLE_MIN = -45;
+export declare const FREE_ANGLE_MAX = 45;
+export declare const FREE_ANGLE_STEP = 0.1;
+export declare function initialRotateState(): RotateState;
+export declare function rotateClockwise(state: RotateState): RotateState;
+export declare function rotateCounterClockwise(state: RotateState): RotateState;
+export declare function setFreeAngle(state: RotateState, angleDeg: number): RotateState;
+export declare function isRotateNoOp(state: RotateState): boolean;
+/** Effective rotation applied during bake, in degrees clockwise. */
+export declare function effectiveAngleDeg(state: RotateState): number;
+//# sourceMappingURL=state.d.ts.map

package/dist/plugins/rotate/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/plugins/rotate/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEtE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAK9E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE5D"}

package/dist/plugins/utility.d.ts

@@ -0,0 +1,59 @@
+import type { ViewportController } from '../canvas/viewport-controller.js';
+import type { EventBus } from '../events/event-bus.js';
+import type { Store } from '../state/store.js';
+/**
+ * Internal utility id taxonomy. Includes the ids Ghost enumerates in
+ * `options.utils` plus `'rotate'` and `'flip'`, which Kalotyp ships as
+ * separate utilities (Ghost's array is the set it wants exposed, not the
+ * upper bound on what the editor may render).
+ */
+export type UtilityId = 'crop' | 'rotate' | 'flip' | 'filter' | 'finetune' | 'redact' | 'annotate' | 'trim' | 'frame' | 'resize';
+/** Normalised wrapper around an image inside the bake chain. `bitmap` is anything `drawImage` accepts. */
+export interface SourceImage {
+    readonly bitmap: ImageBitmap | HTMLImageElement | HTMLCanvasElement | OffscreenCanvas;
+    readonly width: number;
+    readonly height: number;
+    readonly mimeType: string;
+}
+export interface UtilityHandle {
+    destroy(): void;
+}
+/**
+ * Editor → plugin / plugin → editor channel. `commit` signals a state
+ * change worth re-rendering; `announce` requests a polite-live-region
+ * announcement forwarded to the shell's screen-reader announcer.
+ */
+export type EditorEvents = {
+    commit: {
+        readonly utility: UtilityId;
+    };
+    announce: {
+        readonly message: string;
+    };
+};
+export interface UtilityContext {
+    readonly source: SourceImage;
+    readonly bus: EventBus<EditorEvents>;
+    /**
+     * Editor-level zoom + pan controller. Plugins read viewports via
+     * `viewport.computeViewport(stage, image)` and subscribe for repaint;
+     * the editor's gesture detector owns mutation.
+     */
+    readonly viewport: ViewportController;
+}
+export interface UtilityPlugin<TState extends object> {
+    readonly id: UtilityId;
+    /** Synchronous default state for the plugin given the loaded image. */
+    init(ctx: UtilityContext): TState;
+    /**
+     * Mount the plugin's interactive UI under `host`. The returned handle's
+     * `destroy()` is called when the editor closes.
+     */
+    mount(host: HTMLElement, ctx: UtilityContext, store: Store<TState>): UtilityHandle;
+    /**
+     * Apply this utility's transformation to the image and return the result.
+     * The chain runner feeds this output as the next utility's input.
+     */
+    bake(state: TState, source: SourceImage): Promise<SourceImage>;
+}
+//# sourceMappingURL=utility.d.ts.map

package/dist/plugins/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/plugins/utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,GACV,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAEb,0GAA0G;AAC1G,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC;IACxC,QAAQ,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM;IAClD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,uEAAuE;IACvE,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;IACnF;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChE"}

package/dist/state/store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal observable store. Subscribers fire after every `set`/`update`;
+ * the store does no equality check — subscribers diff if they care.
+ */
+export type StoreListener<T> = (state: T, previous: T) => void;
+export type Unsubscribe = () => void;
+export interface Store<T> {
+    get(): T;
+    set(next: Partial<T>): void;
+    update(updater: (state: T) => Partial<T>): void;
+    subscribe(listener: StoreListener<T>): Unsubscribe;
+}
+export declare function createStore<T extends object>(initial: T): Store<T>;
+//# sourceMappingURL=store.d.ts.map

package/dist/state/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/state/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,GAAG,IAAI,CAAC,CAAC;IACT,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;CACpD;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAmClE"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@magicpages/kalotyp-core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic editor engine for Kalotyp — an open-source image editor for Ghost CMS.",
+  "license": "MIT",
+  "author": "Jannis Fedoruk-Betschki <jannis@magicpages.co>",
+  "homepage": "https://github.com/magicpages/kalotyp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/magicpages/kalotyp.git",
+    "directory": "packages/core"
+  },
+  "bugs": "https://github.com/magicpages/kalotyp/issues",
+  "keywords": [
+    "ghost",
+    "image-editor",
+    "canvas",
+    "editor-engine"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "5.6.3",
+    "vite": "5.4.10",
+    "vite-plugin-dts": "4.3.0",
+    "vitest": "2.1.5",
+    "jsdom": "25.0.1"
+  }
+}