@bluepic/embed 0.4.0-next.94 → 0.4.0-next.96

package/dist/util/autoCrop/applyAutoCrop.d.ts

@@ -8,6 +8,8 @@ export type ApplyAutoCropOptions = {
     };
     aspectRatio: number;
     cropMode: Template.ImageValue['cropMode'];
+    /** Tighten the crop around the faces instead of keeping full resolution. */
+    zoom?: boolean;
 };
 /**
  * Full auto-crop pass for one image: load → detect → solve.

package/dist/util/autoCrop/solveAutoCrop.d.ts

@@ -13,6 +13,13 @@ export declare const MIN_FACE_SCORE = 0.6;
  * approximates that while staying safe for group shots.
  */
 export declare const FACE_VERTICAL_ANCHOR = 0.4;
+/**
+ * Margin kept around the face union box when `zoom` is on, as a fraction of the
+ * face box size on each side. 0.6 → the crop is ~2.2× the face box, which reads
+ * as a comfortable headshot rather than a tight passport cut. Only consulted
+ * when zooming is requested; the default policy ignores it entirely.
+ */
+export declare const FACE_ZOOM_PADDING = 0.6;
 export type SolveAutoCropOptions = {
     faces: FaceBox[];
     /** Natural (unscaled) image dimensions in pixels. */
@@ -23,6 +30,12 @@ export type SolveAutoCropOptions = {
     /** Target aspect ratio of the field (width / height). */
     aspectRatio: number;
     cropMode: Template.ImageValue['cropMode'];
+    /**
+     * When true, tighten the crop around the detected faces instead of keeping
+     * the largest possible rectangle. Off by default because zooming throws away
+     * resolution; opt in when framing matters more than pixels.
+     */
+    zoom?: boolean;
 };
 /**
  * Propose a crop rectangle that frames the detected faces.
@@ -31,9 +44,11 @@ export type SolveAutoCropOptions = {
  * degenerate input, or a crop mode where cropping isn't what happens. `null`
  * means "leave the existing default alone", never "error".
  *
- * The geometry mirrors what `cover` already does: the crop is the largest
- * rectangle of the target ratio that fits inside the image (so no pixels are
- * wasted), slid so the faces are well framed. It never zooms in — cropping
- * tighter than necessary would throw away resolution the renderer wants.
+ * By default the geometry mirrors what `cover` already does: the crop is the
+ * largest rectangle of the target ratio that fits inside the image (so no
+ * pixels are wasted), slid so the faces are well framed — it never zooms in,
+ * because cropping tighter than necessary throws away resolution the renderer
+ * wants. Pass `zoom` to opt into the opposite trade-off: tighten the crop
+ * around the faces (down to the padded union box) at the cost of resolution.
  */
 export declare function solveAutoCrop(opts: SolveAutoCropOptions): Template.Crop | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluepic/embed",
-  "version": "0.4.0-next.94",
+  "version": "0.4.0-next.96",
   "description": "Bluepic embed sdk",
   "type": "module",
   "sideEffects": false,