@melite/image-mask-studio 0.1.4-alpha → 0.1.5-pre-alpha

package/README.md

@@ -0,0 +1,40 @@
+---
+description: Leaf-face carrier of the retired mask card's studio surfaces — paint and bbox canvases embedded in modifier leaves.
+kind: package-library
+---
+
+# @melite/image-mask-studio
+
+`@melite/image-mask-studio` carries the two studio surfaces the mask card's modifier leaves embed: the brush canvas (`./paint-canvas`) and the rectangle canvas (`./bbox-canvas`). The card itself is retired at parity (CONTRACT D — no cardPackages row remains); the package is DEMOTED to a leaf-face carrier and the takeover client is gone. The root door is dependency-free leaf data both canvases share.
+
+## Contract
+
+- `./paint-canvas` — `PaintLeafCanvas`, the brush canvas a paint mod leaf embeds. Strokes render on a transparent overlay so the saved PNG's alpha IS the stroke shape — the `LoadImageMask` lane reads exactly that alpha; the view fits at 640. Committed strokes report live through `onChange`, and a paint-over seeds from the existing payload. A commit-gate ref mirror keeps pointerup from committing a blank payload.
+- `./bbox-canvas` — `BboxLeafCanvas`, the rectangle canvas a bbox mod leaf embeds. The drawn box reports image-pixel coordinates (naturals, not view pixels), stays clearable (`onChange(null)`), and still takes a rectangle over the blank fitted 1024 canvas when no image is staged.
+- `.` — `paintInk.ts`, the shared leaf data (the stroke ink constants), importable under plain Node with no React.
+- `./package.json` — the manifest.
+
+Both canvases port from the retired modal; the leaf's own Add/Save/Cancel owns commit.
+
+## Model Experience
+
+### Request context and condition
+
+The canvases author mask payloads for other cards' runs; they never run anything.
+
+#### What the model sees
+
+None — the package contributes no model-visible input.
+
+#### Token effect
+
+zero-direct — the package contributes no prompt or schema to any language-model context.
+
+#### KV Cache effect
+
+independent — nothing here appends to or reshapes a session cache.
+
+## Known Limitations and Deferred Work
+
+- **The card is retired (CONTRACT D)** — no cardPackages row exists; the package survives only as the leaf-face carrier.
+- **No takeover client** — the former modal studio surface is gone; the leaves are the only remaining faces.

package/lib/ui/BboxLeafCanvas.js

@@ -18,6 +18,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { Button } from "@deepseek-ai/dsh-client-ui-primitives";
 import { PAINT_STROKE_INK } from "../paintInk.js";
+import { paintCopy } from "./paintCopy.js";
 const FIT = 640;
 const loadImage = (url) => new Promise((resolve) => {
     if (url === "") {
@@ -189,7 +190,7 @@ export function BboxLeafCanvas(props) {
         onChange(null);
     };
     return (_jsxs("div", { "data-bbox-leaf-canvas": "embedded", style: { display: "flex", flexDirection: "column", gap: 8 }, children: [_jsx("canvas", { ref: viewRef, "data-testid": "bbox-leaf-view", "data-bbox-canvas": "view", style: { maxWidth: "100%", cursor: "crosshair", touchAction: "none", borderRadius: 4, display: "block" }, onPointerDown: onDown, onPointerMove: onMove, onPointerUp: onUp, onPointerCancel: onUp }), _jsxs("div", { style: { display: "flex", gap: 8, alignItems: "center" }, children: [_jsx("span", { style: { opacity: 0.7, fontSize: 12, flex: 1 }, children: rect !== null && rect.w >= 1 && rect.h >= 1
-                            ? `box ${Math.round(rect.w)}×${Math.round(rect.h)} (view px)`
-                            : "drag on the image to scope the selection" }), _jsx(Button, { variant: "ghost", onClick: clear, children: "Clear box" })] })] }));
+                            ? paintCopy.bboxSize({ w: rect.w, h: rect.h })
+                            : paintCopy.bboxHint }), _jsx(Button, { variant: "ghost", onClick: clear, children: paintCopy.clearBoxAction })] })] }));
 }
 //# sourceMappingURL=BboxLeafCanvas.js.map

package/lib/ui/PaintLeafCanvas.js

@@ -16,6 +16,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { Button, Input } from "@deepseek-ai/dsh-client-ui-primitives";
 import { PAINT_STROKE_INK } from "../paintInk.js";
+import { paintCopy } from "./paintCopy.js";
 const FIT = 640;
 /** Load an image element from a URL (null while loading/failed —
  *  the canvas degrades to the blank 1024 fit, never a crash). */
@@ -213,7 +214,7 @@ export function PaintLeafCanvas(props) {
         redraw();
         onChange("");
     };
-    return (_jsxs("div", { "data-paint-leaf-canvas": "embedded", style: { display: "flex", flexDirection: "column", gap: 8 }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: 12 }, children: [_jsxs("label", { style: { display: "flex", alignItems: "center", gap: 6 }, children: ["Brush", _jsx(Input, { type: "range", "aria-label": "Brush size", min: 4, max: 128, step: 2, value: String(brushSize), onChange: (e) => { setBrushSize(Number(e.target.value)); } }), _jsx("span", { style: { width: 28, textAlign: "right" }, children: brushSize })] }), _jsx("span", { style: { opacity: 0.7, fontSize: 12, flex: 1 }, children: hasStrokes ? "strokes paint the mask (alpha = the mask)" : "drag on the image to paint the mask" }), _jsx(Button, { variant: "ghost", onClick: clearPaint, children: "Clear" })] }), _jsx("canvas", { ref: viewRef, "data-testid": "paint-leaf-view", style: {
+    return (_jsxs("div", { "data-paint-leaf-canvas": "embedded", style: { display: "flex", flexDirection: "column", gap: 8 }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: 12 }, children: [_jsxs("label", { style: { display: "flex", alignItems: "center", gap: 6 }, children: [paintCopy.brushLabel, _jsx(Input, { type: "range", "aria-label": paintCopy.brushSizeAria, min: 4, max: 128, step: 2, value: String(brushSize), onChange: (e) => { setBrushSize(Number(e.target.value)); } }), _jsx("span", { style: { width: 28, textAlign: "right" }, children: brushSize })] }), _jsx("span", { style: { opacity: 0.7, fontSize: 12, flex: 1 }, children: hasStrokes ? paintCopy.strokesHint : paintCopy.paintHint }), _jsx(Button, { variant: "ghost", onClick: clearPaint, children: paintCopy.clearAction })] }), _jsx("canvas", { ref: viewRef, "data-testid": "paint-leaf-view", style: {
                     display: viewSize === null ? "none" : "block",
                     maxWidth: "100%",
                     border: "1px solid var(--dsw-alias-border-l2)",

package/lib/ui/paintCopy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * paintCopy.ts — THE PAINT LEAF COPY DICTIONARY. Client UI copy is locale-owned —
+ * presentation code owns no copy literals; it consumes them here through the typed
+ * seat. A second locale plugs into this dictionary without touching a single leaf
+ * component.
+ *
+ * THE BOUND: static user-visible FACES of the paint + bbox leaf canvases live here
+ * (labels, hints, aria names, clear actions, the bbox size readout). Canvas DATA —
+ * the stroke ink (paintInk.ts), data-testid hooks, classNames, and numeric control
+ * seats (min/max/step) — rides the components, never this dictionary.
+ */
+/** The typed dictionary. Keys are stable copy ids. */
+export declare const paintCopy: {
+    /** The brush-size slider's visible label. */
+    readonly brushLabel: "Brush";
+    /** The brush-size slider's accessible name. */
+    readonly brushSizeAria: "Brush size";
+    /** The paint hint once strokes landed (alpha = the mask). */
+    readonly strokesHint: "strokes paint the mask (alpha = the mask)";
+    /** The paint hint before the first stroke. */
+    readonly paintHint: "drag on the image to paint the mask";
+    /** The paint toolbar's clear action. */
+    readonly clearAction: "Clear";
+    /** The bbox size readout in view pixels. */
+    readonly bboxSize: (p: {
+        w: number;
+        h: number;
+    }) => string;
+    /** The bbox hint before a box is drawn. */
+    readonly bboxHint: "drag on the image to scope the selection";
+    /** The bbox toolbar's clear action. */
+    readonly clearBoxAction: "Clear box";
+};
+//# sourceMappingURL=paintCopy.d.ts.map

package/lib/ui/paintCopy.js

@@ -0,0 +1,32 @@
+/**
+ * paintCopy.ts — THE PAINT LEAF COPY DICTIONARY. Client UI copy is locale-owned —
+ * presentation code owns no copy literals; it consumes them here through the typed
+ * seat. A second locale plugs into this dictionary without touching a single leaf
+ * component.
+ *
+ * THE BOUND: static user-visible FACES of the paint + bbox leaf canvases live here
+ * (labels, hints, aria names, clear actions, the bbox size readout). Canvas DATA —
+ * the stroke ink (paintInk.ts), data-testid hooks, classNames, and numeric control
+ * seats (min/max/step) — rides the components, never this dictionary.
+ */
+/** The typed dictionary. Keys are stable copy ids. */
+// v8 ignore next -- exercised key-by-key by the copy wall's census arm
+export const paintCopy = {
+    /** The brush-size slider's visible label. */
+    brushLabel: "Brush",
+    /** The brush-size slider's accessible name. */
+    brushSizeAria: "Brush size",
+    /** The paint hint once strokes landed (alpha = the mask). */
+    strokesHint: "strokes paint the mask (alpha = the mask)",
+    /** The paint hint before the first stroke. */
+    paintHint: "drag on the image to paint the mask",
+    /** The paint toolbar's clear action. */
+    clearAction: "Clear",
+    /** The bbox size readout in view pixels. */
+    bboxSize: (p) => `box ${Math.round(p.w)}×${Math.round(p.h)} (view px)`,
+    /** The bbox hint before a box is drawn. */
+    bboxHint: "drag on the image to scope the selection",
+    /** The bbox toolbar's clear action. */
+    clearBoxAction: "Clear box",
+};
+//# sourceMappingURL=paintCopy.js.map

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.4-alpha",
+  "version": "0.1.5-pre-alpha",
   "license": "SSPL-1.0",
   "type": "module",
   "description": "the mask-studio carrier, DEMOTED (CONTRACT D — the card retired at parity): ui/ survives as the leaf-face carrier (paint + bbox); the takeover client is gone",
@@ -21,7 +21,7 @@
   "dependencies": {
     "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
     "react": "^19.3.0",
-    "@melite/contracts": "0.1.4-alpha"
+    "@melite/contracts": "0.1.5-pre-alpha"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "*",