@molecule/app-feature-image-canvas-solid 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,183 @@
1
+ /**
2
+ * Solid Canvas2D image-editing surface — a filter chain, pointer-drag
3
+ * panning, wheel zooming and a data-URL export handle.
4
+ *
5
+ * Solid counterpart of `@molecule/app-feature-image-canvas-react`'s
6
+ * `ImageCanvas` — the same props (React names), the same DOM for the same
7
+ * input.
8
+ *
9
+ * @module
10
+ */
11
+ import { createEffect, createMemo, createSignal, onCleanup, onMount, } from 'solid-js';
12
+ import { useTranslation } from '@molecule/app-solid';
13
+ import { getClassMap } from '@molecule/app-ui';
14
+ import { clamp, clampPan, composeFilterString } from './helpers.js';
15
+ import { isImageElement } from './image-source.js';
16
+ /**
17
+ * Canvas2D image-editing surface. Renders a source image onto a canvas with a
18
+ * filter chain (brightness, contrast, saturation, hue, sepia, grayscale, blur,
19
+ * sharpen), pointer-event drag panning, and wheel zooming. The current state
20
+ * can be exported to a data URL via the `exportRef` imperative handle.
21
+ *
22
+ * All styling routes through `getClassMap()` (no raw class names). All
23
+ * user-visible text routes through `t()` so the canvas translates via the
24
+ * companion locale bond.
25
+ *
26
+ * @param props - Component props (see {@link ImageCanvasProps}).
27
+ * @returns The rendered image canvas.
28
+ */
29
+ export const ImageCanvas = (props) => {
30
+ const cm = getClassMap();
31
+ const { t } = useTranslation();
32
+ let canvas;
33
+ const [internalImage, setInternalImage] = createSignal(isImageElement(props.src) ? props.src : null);
34
+ const [loadError, setLoadError] = createSignal(null);
35
+ const width = () => props.width ?? 512;
36
+ const height = () => props.height ?? 512;
37
+ const safeZoom = () => {
38
+ const zoom = props.zoom;
39
+ return zoom !== undefined && Number.isFinite(zoom) && zoom > 0 ? zoom : 1;
40
+ };
41
+ const safePan = () => ({
42
+ x: Number.isFinite(props.pan?.x) ? props.pan?.x : 0,
43
+ y: Number.isFinite(props.pan?.y) ? props.pan?.y : 0,
44
+ });
45
+ const filterString = createMemo(() => composeFilterString(props.filters));
46
+ // Drag state lives outside signals: handlers mutate it without re-rendering,
47
+ // exactly like React's ref.
48
+ let dragState = { pointerId: null, startX: 0, startY: 0, startPan: { x: 0, y: 0 } };
49
+ // Load the source image when the prop is a URL string.
50
+ createEffect(() => {
51
+ const src = props.src;
52
+ if (typeof src !== 'string') {
53
+ if (isImageElement(src)) {
54
+ setInternalImage(src);
55
+ setLoadError(null);
56
+ }
57
+ return;
58
+ }
59
+ let cancelled = false;
60
+ setLoadError(null);
61
+ const img = new Image();
62
+ img.crossOrigin = 'anonymous';
63
+ img.onload = () => {
64
+ if (cancelled)
65
+ return;
66
+ setInternalImage(img);
67
+ };
68
+ img.onerror = () => {
69
+ if (cancelled)
70
+ return;
71
+ setLoadError(src);
72
+ setInternalImage(null);
73
+ };
74
+ img.src = src;
75
+ onCleanup(() => {
76
+ cancelled = true;
77
+ });
78
+ });
79
+ // Re-paint whenever the image, viewport, or filter chain changes.
80
+ createEffect(() => {
81
+ const image = internalImage();
82
+ const zoom = safeZoom();
83
+ const pan = safePan();
84
+ const filter = filterString();
85
+ const canvasWidth = width();
86
+ const canvasHeight = height();
87
+ const node = canvas;
88
+ if (!node)
89
+ return;
90
+ const ctx = node.getContext('2d');
91
+ if (!ctx)
92
+ return;
93
+ ctx.save();
94
+ ctx.clearRect(0, 0, canvasWidth, canvasHeight);
95
+ if (!image) {
96
+ ctx.restore();
97
+ return;
98
+ }
99
+ ctx.filter = filter;
100
+ const drawWidth = image.naturalWidth * zoom;
101
+ const drawHeight = image.naturalHeight * zoom;
102
+ const dx = canvasWidth / 2 - drawWidth / 2 + pan.x;
103
+ const dy = canvasHeight / 2 - drawHeight / 2 + pan.y;
104
+ ctx.drawImage(image, dx, dy, drawWidth, drawHeight);
105
+ ctx.restore();
106
+ });
107
+ onMount(() => {
108
+ if (!props.exportRef)
109
+ return;
110
+ props.exportRef.current = {
111
+ toDataURL: (type, quality) => {
112
+ if (!canvas)
113
+ return '';
114
+ return canvas.toDataURL(type, quality);
115
+ },
116
+ };
117
+ });
118
+ onCleanup(() => {
119
+ if (props.exportRef)
120
+ props.exportRef.current = null;
121
+ });
122
+ const handlePointerDown = (event) => {
123
+ if (!canvas)
124
+ return;
125
+ canvas.setPointerCapture(event.pointerId);
126
+ dragState = {
127
+ pointerId: event.pointerId,
128
+ startX: event.clientX,
129
+ startY: event.clientY,
130
+ startPan: { ...safePan() },
131
+ };
132
+ };
133
+ const handlePointerMove = (event) => {
134
+ const state = dragState;
135
+ if (state.pointerId !== event.pointerId)
136
+ return;
137
+ const dx = event.clientX - state.startX;
138
+ const dy = event.clientY - state.startY;
139
+ const image = internalImage();
140
+ const next = clampPan({ x: state.startPan.x + dx, y: state.startPan.y + dy }, { width: width(), height: height() }, image
141
+ ? { width: image.naturalWidth, height: image.naturalHeight }
142
+ : { width: width(), height: height() }, safeZoom());
143
+ props.onChange?.({ zoom: safeZoom(), pan: next });
144
+ };
145
+ const endDrag = (event) => {
146
+ const state = dragState;
147
+ if (state.pointerId !== event.pointerId)
148
+ return;
149
+ if (canvas && canvas.hasPointerCapture(event.pointerId)) {
150
+ canvas.releasePointerCapture(event.pointerId);
151
+ }
152
+ dragState = { pointerId: null, startX: 0, startY: 0, startPan: { x: 0, y: 0 } };
153
+ };
154
+ const handleWheel = (event) => {
155
+ // Negative deltaY = scroll up = zoom in.
156
+ const factor = event.deltaY < 0 ? 1.1 : 1 / 1.1;
157
+ const nextZoom = clamp(safeZoom() * factor, 0.05, 32);
158
+ props.onChange?.({ zoom: nextZoom, pan: safePan() });
159
+ };
160
+ return (<div role="region" aria-label={t('imageCanvas.aria.region', {}, { defaultValue: 'Image canvas' })} data-mol-id="image-canvas" class={cm.cn(props.className)} style={{
161
+ display: 'inline-block',
162
+ width: `${width()}px`,
163
+ height: `${height()}px`,
164
+ position: 'relative',
165
+ }}>
166
+ <canvas ref={(element) => {
167
+ canvas = element;
168
+ }} width={width()} height={height()} aria-label={t('imageCanvas.aria.canvas', {}, { defaultValue: 'Drag to pan, scroll to zoom' })} data-mol-id="image-canvas-surface" data-loading={internalImage() ? 'false' : loadError() ? 'false' : 'true'} data-error={loadError() ? 'true' : 'false'} style={{
169
+ display: 'block',
170
+ width: `${width()}px`,
171
+ height: `${height()}px`,
172
+ cursor: props.onChange ? 'grab' : 'default',
173
+ 'touch-action': 'none',
174
+ }} onPointerDown={handlePointerDown} onPointerMove={handlePointerMove} onPointerUp={endDrag} onPointerCancel={endDrag} onWheel={handleWheel}/>
175
+ {!internalImage() && !loadError() ? (<p class={cm.cn(cm.textSize('xs'), cm.sp('p', 2))} data-mol-id="image-canvas-loading">
176
+ {t('imageCanvas.loading', {}, { defaultValue: 'Loading image…' })}
177
+ </p>) : null}
178
+ {loadError() ? (<p class={cm.cn(cm.textSize('xs'), cm.sp('p', 2))} data-mol-id="image-canvas-error" role="alert">
179
+ {t('imageCanvas.error', {}, { defaultValue: 'Image failed to load.' })}
180
+ </p>) : null}
181
+ </div>);
182
+ };
183
+ //# sourceMappingURL=ImageCanvas.jsx.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImageCanvas.jsx","sourceRoot":"","sources":["../src/ImageCanvas.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Framework-free helpers of the Solid Canvas2D image-editing surface — the same
3
+ * values `@molecule/app-feature-image-canvas-react` exports.
4
+ *
5
+ * @module
6
+ */
7
+ import type { ImageCanvasFilters, PanOffset } from './types.js';
8
+ /**
9
+ * Clamp a numeric value into the closed interval `[min, max]`. Returns
10
+ * `min` for non-finite inputs.
11
+ *
12
+ * @param value - The value to clamp.
13
+ * @param min - Inclusive minimum.
14
+ * @param max - Inclusive maximum.
15
+ * @returns The clamped value.
16
+ */
17
+ export declare function clamp(value: number, min: number, max: number): number;
18
+ /**
19
+ * Compose a CSS filter string from a set of `ImageCanvasFilters` values.
20
+ * Out-of-range values are clamped; omitted / non-finite fields are
21
+ * ignored. Returns `'none'` when no filters are active so callers can
22
+ * assign the result directly to `CanvasRenderingContext2D.filter`.
23
+ *
24
+ * @param filters - The filter parameters. May be `undefined`.
25
+ * @returns A CSS filter string, or `'none'` when nothing applies.
26
+ */
27
+ export declare function composeFilterString(filters?: ImageCanvasFilters): string;
28
+ /**
29
+ * Convert a screen-space (canvas-relative) point into image-space
30
+ * coordinates given the current zoom + pan and the source image
31
+ * dimensions. Useful for tools that need to know which image pixel a
32
+ * pointer event hit (cropping, picking, masking).
33
+ *
34
+ * @param point - The canvas-space point in CSS pixels (origin top-left
35
+ * of the canvas element).
36
+ * @param canvasSize - The canvas size in CSS pixels.
37
+ * @param imageSize - The source image's natural size in pixels.
38
+ * @param zoom - The current zoom factor. Non-positive values fall back
39
+ * to `1`.
40
+ * @param pan - The current pan offset in CSS pixels.
41
+ * @returns The corresponding point in image-space coordinates.
42
+ */
43
+ export declare function screenToCanvas(point: {
44
+ x: number;
45
+ y: number;
46
+ }, canvasSize: {
47
+ width: number;
48
+ height: number;
49
+ }, imageSize: {
50
+ width: number;
51
+ height: number;
52
+ }, zoom: number, pan: PanOffset): {
53
+ x: number;
54
+ y: number;
55
+ };
56
+ /**
57
+ * Clamp a pan offset so the (zoomed) image cannot be dragged entirely
58
+ * off-canvas. The clamp keeps at least half of the image visible in
59
+ * each axis. Non-finite inputs are treated as `0`.
60
+ *
61
+ * @param pan - The desired pan offset, in CSS pixels.
62
+ * @param canvasSize - The canvas size in CSS pixels.
63
+ * @param imageSize - The source image's natural size in pixels.
64
+ * @param zoom - The current zoom factor. Non-positive values fall back
65
+ * to `1`.
66
+ * @returns The clamped pan offset.
67
+ */
68
+ export declare function clampPan(pan: PanOffset, canvasSize: {
69
+ width: number;
70
+ height: number;
71
+ }, imageSize: {
72
+ width: number;
73
+ height: number;
74
+ }, zoom: number): PanOffset;
75
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE/D;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAuCxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7C,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,SAAS,GACb;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAa1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,SAAS,EACd,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7C,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5C,IAAI,EAAE,MAAM,GACX,SAAS,CAgBX"}
@@ -0,0 +1,139 @@
1
+ /**
2
+ * Framework-free helpers of the Solid Canvas2D image-editing surface — the same
3
+ * values `@molecule/app-feature-image-canvas-react` exports.
4
+ *
5
+ * @module
6
+ */
7
+ /**
8
+ * Clamp a numeric value into the closed interval `[min, max]`. Returns
9
+ * `min` for non-finite inputs.
10
+ *
11
+ * @param value - The value to clamp.
12
+ * @param min - Inclusive minimum.
13
+ * @param max - Inclusive maximum.
14
+ * @returns The clamped value.
15
+ */
16
+ export function clamp(value, min, max) {
17
+ if (!Number.isFinite(value))
18
+ return min;
19
+ if (value < min)
20
+ return min;
21
+ if (value > max)
22
+ return max;
23
+ return value;
24
+ }
25
+ /**
26
+ * Compose a CSS filter string from a set of `ImageCanvasFilters` values.
27
+ * Out-of-range values are clamped; omitted / non-finite fields are
28
+ * ignored. Returns `'none'` when no filters are active so callers can
29
+ * assign the result directly to `CanvasRenderingContext2D.filter`.
30
+ *
31
+ * @param filters - The filter parameters. May be `undefined`.
32
+ * @returns A CSS filter string, or `'none'` when nothing applies.
33
+ */
34
+ export function composeFilterString(filters) {
35
+ if (!filters)
36
+ return 'none';
37
+ const parts = [];
38
+ if (filters.brightness !== undefined && Number.isFinite(filters.brightness)) {
39
+ const v = Math.max(0, filters.brightness);
40
+ if (v !== 1)
41
+ parts.push(`brightness(${v})`);
42
+ }
43
+ if (filters.contrast !== undefined && Number.isFinite(filters.contrast)) {
44
+ const v = Math.max(0, filters.contrast);
45
+ if (v !== 1)
46
+ parts.push(`contrast(${v})`);
47
+ }
48
+ if (filters.saturation !== undefined && Number.isFinite(filters.saturation)) {
49
+ const v = Math.max(0, filters.saturation);
50
+ if (v !== 1)
51
+ parts.push(`saturate(${v})`);
52
+ }
53
+ if (filters.hue !== undefined && Number.isFinite(filters.hue)) {
54
+ const v = ((filters.hue % 360) + 360) % 360;
55
+ if (v !== 0)
56
+ parts.push(`hue-rotate(${v}deg)`);
57
+ }
58
+ if (filters.sepia !== undefined && Number.isFinite(filters.sepia)) {
59
+ const v = clamp(filters.sepia, 0, 1);
60
+ if (v > 0)
61
+ parts.push(`sepia(${v})`);
62
+ }
63
+ if (filters.grayscale !== undefined && Number.isFinite(filters.grayscale)) {
64
+ const v = clamp(filters.grayscale, 0, 1);
65
+ if (v > 0)
66
+ parts.push(`grayscale(${v})`);
67
+ }
68
+ if (filters.blur !== undefined && Number.isFinite(filters.blur)) {
69
+ const v = Math.max(0, filters.blur);
70
+ if (v > 0)
71
+ parts.push(`blur(${v}px)`);
72
+ }
73
+ if (filters.sharpen !== undefined && Number.isFinite(filters.sharpen)) {
74
+ const v = clamp(filters.sharpen, 0, 1);
75
+ // Approximate sharpen as a small contrast bump. 1.0 = +50% contrast.
76
+ if (v > 0)
77
+ parts.push(`contrast(${1 + 0.5 * v})`);
78
+ }
79
+ return parts.length === 0 ? 'none' : parts.join(' ');
80
+ }
81
+ /**
82
+ * Convert a screen-space (canvas-relative) point into image-space
83
+ * coordinates given the current zoom + pan and the source image
84
+ * dimensions. Useful for tools that need to know which image pixel a
85
+ * pointer event hit (cropping, picking, masking).
86
+ *
87
+ * @param point - The canvas-space point in CSS pixels (origin top-left
88
+ * of the canvas element).
89
+ * @param canvasSize - The canvas size in CSS pixels.
90
+ * @param imageSize - The source image's natural size in pixels.
91
+ * @param zoom - The current zoom factor. Non-positive values fall back
92
+ * to `1`.
93
+ * @param pan - The current pan offset in CSS pixels.
94
+ * @returns The corresponding point in image-space coordinates.
95
+ */
96
+ export function screenToCanvas(point, canvasSize, imageSize, zoom, pan) {
97
+ const safeZoom = Number.isFinite(zoom) && zoom > 0 ? zoom : 1;
98
+ const cx = canvasSize.width / 2;
99
+ const cy = canvasSize.height / 2;
100
+ // The image is drawn centred at (cx + pan.x, cy + pan.y) and scaled by
101
+ // `safeZoom` from its natural size. Inverting that mapping yields the
102
+ // image-space pixel for an arbitrary canvas-space point.
103
+ const dx = point.x - cx - pan.x;
104
+ const dy = point.y - cy - pan.y;
105
+ return {
106
+ x: dx / safeZoom + imageSize.width / 2,
107
+ y: dy / safeZoom + imageSize.height / 2,
108
+ };
109
+ }
110
+ /**
111
+ * Clamp a pan offset so the (zoomed) image cannot be dragged entirely
112
+ * off-canvas. The clamp keeps at least half of the image visible in
113
+ * each axis. Non-finite inputs are treated as `0`.
114
+ *
115
+ * @param pan - The desired pan offset, in CSS pixels.
116
+ * @param canvasSize - The canvas size in CSS pixels.
117
+ * @param imageSize - The source image's natural size in pixels.
118
+ * @param zoom - The current zoom factor. Non-positive values fall back
119
+ * to `1`.
120
+ * @returns The clamped pan offset.
121
+ */
122
+ export function clampPan(pan, canvasSize, imageSize, zoom) {
123
+ const safeZoom = Number.isFinite(zoom) && zoom > 0 ? zoom : 1;
124
+ const halfImgW = (imageSize.width * safeZoom) / 2;
125
+ const halfImgH = (imageSize.height * safeZoom) / 2;
126
+ const halfCanvasW = canvasSize.width / 2;
127
+ const halfCanvasH = canvasSize.height / 2;
128
+ // Allow the image centre to move up to (halfCanvas + halfImg/2) — i.e.
129
+ // half the image always stays visible.
130
+ const maxX = halfCanvasW + halfImgW / 2;
131
+ const maxY = halfCanvasH + halfImgH / 2;
132
+ const px = Number.isFinite(pan.x) ? pan.x : 0;
133
+ const py = Number.isFinite(pan.y) ? pan.y : 0;
134
+ return {
135
+ x: clamp(px, -maxX, maxX),
136
+ y: clamp(py, -maxY, maxY),
137
+ };
138
+ }
139
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Internal source guard of the Solid Canvas2D image-editing surface: whether
3
+ * the `src` prop is an already-loaded element rather than a URL string.
4
+ *
5
+ * @module
6
+ */
7
+ /**
8
+ * Determine whether a `src` prop is an `HTMLImageElement` instance. The
9
+ * constructor is tested at call time so jsdom's `HTMLImageElement` shim
10
+ * works in tests.
11
+ *
12
+ * @param src - The `src` value to inspect.
13
+ * @returns `true` if `src` is an `HTMLImageElement`.
14
+ */
15
+ export declare function isImageElement(src: string | HTMLImageElement): src is HTMLImageElement;
16
+ //# sourceMappingURL=image-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"image-source.d.ts","sourceRoot":"","sources":["../src/image-source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,GAAG,IAAI,gBAAgB,CAItF"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Internal source guard of the Solid Canvas2D image-editing surface: whether
3
+ * the `src` prop is an already-loaded element rather than a URL string.
4
+ *
5
+ * @module
6
+ */
7
+ /**
8
+ * Determine whether a `src` prop is an `HTMLImageElement` instance. The
9
+ * constructor is tested at call time so jsdom's `HTMLImageElement` shim
10
+ * works in tests.
11
+ *
12
+ * @param src - The `src` value to inspect.
13
+ * @returns `true` if `src` is an `HTMLImageElement`.
14
+ */
15
+ export function isImageElement(src) {
16
+ if (typeof src === 'string')
17
+ return false;
18
+ if (typeof HTMLImageElement === 'undefined')
19
+ return false;
20
+ return src instanceof HTMLImageElement;
21
+ }
22
+ //# sourceMappingURL=image-source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"image-source.js","sourceRoot":"","sources":["../src/image-source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,GAA8B;IAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,OAAO,gBAAgB,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IACzD,OAAO,GAAG,YAAY,gBAAgB,CAAA;AACxC,CAAC"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Solid Canvas2D image-editing surface.
3
+ *
4
+ * Exports `ImageCanvas` — the Solid counterpart of
5
+ * `@molecule/app-feature-image-canvas-react` with the same props and the same
6
+ * DOM: an image rendered onto a canvas with a filter chain (brightness,
7
+ * contrast, saturation, hue, sepia, grayscale, blur, sharpen), pointer-drag
8
+ * panning, wheel zooming, and a `toDataURL()` export handle, plus the
9
+ * framework-free `clamp`, `composeFilterString`, `screenToCanvas` and
10
+ * `clampPan` helpers.
11
+ *
12
+ * @example
13
+ * ```tsx
14
+ * import { createSignal } from 'solid-js'
15
+ * import {
16
+ * ImageCanvas,
17
+ * type ImageCanvasExportHandle,
18
+ * } from '@molecule/app-feature-image-canvas-solid'
19
+ *
20
+ * export function Editor() {
21
+ * const [zoom, setZoom] = createSignal(1)
22
+ * const [pan, setPan] = createSignal({ x: 0, y: 0 })
23
+ * const exportRef: { current: ImageCanvasExportHandle | null } = { current: null }
24
+ * return (
25
+ * <ImageCanvas
26
+ * src="/photo.jpg"
27
+ * filters={{ brightness: 1.1, contrast: 1.2, sepia: 0.3 }}
28
+ * zoom={zoom()}
29
+ * pan={pan()}
30
+ * onChange={(next) => {
31
+ * setZoom(next.zoom)
32
+ * setPan(next.pan)
33
+ * }}
34
+ * exportRef={exportRef}
35
+ * />
36
+ * )
37
+ * }
38
+ * ```
39
+ *
40
+ * @remarks
41
+ * - Pan / zoom interaction is CONTROLLED-ONLY: pointer-drag and wheel events
42
+ * call `onChange` with the proposed `{ zoom, pan }` and never mutate
43
+ * internal state. Without `onChange` and a caller feeding the values back
44
+ * through the `zoom` / `pan` props, dragging and scrolling do nothing.
45
+ * - Requires a bonded ClassMap (the frame and the loading text use ClassMap
46
+ * tokens) and a bonded i18n provider for its aria labels and messages.
47
+ * - URL sources load with `crossOrigin="anonymous"` so `toDataURL()` is never
48
+ * blocked by a tainted canvas — remote images MUST be served with CORS
49
+ * headers. Same-origin and data-URL sources are unaffected.
50
+ * - The canvas bitmap is exactly `width` x `height` device-independent
51
+ * pixels — there is no devicePixelRatio upscaling.
52
+ *
53
+ * @module
54
+ */
55
+ export * from './helpers.js';
56
+ export * from './ImageCanvas.jsx';
57
+ export * from './types.js';
58
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}
package/dist/index.js ADDED
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Solid Canvas2D image-editing surface.
3
+ *
4
+ * Exports `ImageCanvas` — the Solid counterpart of
5
+ * `@molecule/app-feature-image-canvas-react` with the same props and the same
6
+ * DOM: an image rendered onto a canvas with a filter chain (brightness,
7
+ * contrast, saturation, hue, sepia, grayscale, blur, sharpen), pointer-drag
8
+ * panning, wheel zooming, and a `toDataURL()` export handle, plus the
9
+ * framework-free `clamp`, `composeFilterString`, `screenToCanvas` and
10
+ * `clampPan` helpers.
11
+ *
12
+ * @example
13
+ * ```tsx
14
+ * import { createSignal } from 'solid-js'
15
+ * import {
16
+ * ImageCanvas,
17
+ * type ImageCanvasExportHandle,
18
+ * } from '@molecule/app-feature-image-canvas-solid'
19
+ *
20
+ * export function Editor() {
21
+ * const [zoom, setZoom] = createSignal(1)
22
+ * const [pan, setPan] = createSignal({ x: 0, y: 0 })
23
+ * const exportRef: { current: ImageCanvasExportHandle | null } = { current: null }
24
+ * return (
25
+ * <ImageCanvas
26
+ * src="/photo.jpg"
27
+ * filters={{ brightness: 1.1, contrast: 1.2, sepia: 0.3 }}
28
+ * zoom={zoom()}
29
+ * pan={pan()}
30
+ * onChange={(next) => {
31
+ * setZoom(next.zoom)
32
+ * setPan(next.pan)
33
+ * }}
34
+ * exportRef={exportRef}
35
+ * />
36
+ * )
37
+ * }
38
+ * ```
39
+ *
40
+ * @remarks
41
+ * - Pan / zoom interaction is CONTROLLED-ONLY: pointer-drag and wheel events
42
+ * call `onChange` with the proposed `{ zoom, pan }` and never mutate
43
+ * internal state. Without `onChange` and a caller feeding the values back
44
+ * through the `zoom` / `pan` props, dragging and scrolling do nothing.
45
+ * - Requires a bonded ClassMap (the frame and the loading text use ClassMap
46
+ * tokens) and a bonded i18n provider for its aria labels and messages.
47
+ * - URL sources load with `crossOrigin="anonymous"` so `toDataURL()` is never
48
+ * blocked by a tainted canvas — remote images MUST be served with CORS
49
+ * headers. Same-origin and data-URL sources are unaffected.
50
+ * - The canvas bitmap is exactly `width` x `height` device-independent
51
+ * pixels — there is no devicePixelRatio upscaling.
52
+ *
53
+ * @module
54
+ */
55
+ export * from './helpers.js';
56
+ export * from './ImageCanvas.jsx';
57
+ export * from './types.js';
58
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}