n8n-nodes-sudomock 0.16.0 → 0.17.1

package/README.md

@@ -287,6 +287,10 @@ Generate a mockup by filling smart objects with your designs.
     - Brightness: -150 to 150
     - Contrast: -100 to 100
     - Opacity: 0-100
+    - Custom Width and Custom Height: the artwork's own size in pixels
+    - Position Top and Position Left: offset in pixels from the top left of the smart object when Custom Width or Custom Height is set. Without a size they move the whole smart object on the template, so set them together with a size.
+    - Tile: repeat the artwork as a pattern across the whole smart object. Custom Width and Custom Height are one tile, Fit Mode places the artwork inside each tile, and Position Top and Position Left set where the grid starts. A tile needs a size.
+    - Tile Spacing: gap between tiles, 0 to 100 percent of the tile size: that percent of the tile width between columns, and of its height between rows. Used only when Tile is on.
 
 - **Hidden Layers** (optional): JSON array of up to 50 layer UUIDs from **PSD Mockup: Get Layers** to leave out of this render, including layers inside a smart object. Hiding a group hides every layer inside it. Works on its own.
 
@@ -387,9 +391,9 @@ Deletion confirmation
 Create, prepare, render, and manage reusable mockups from product images without a PSD.
 
 1. **Photo Mockup: Create** accepts a public `source_url` or `source_base64`, plus an optional name. By default it waits and returns the ready mockup detail unchanged. Enable **Run Asynchronously** to receive a 202 job with `job_id` and `status_url`, then use **Get Job** when needed.
-2. **Photo Mockup: Get** returns `draft`, `ready`, or `failed` status. Poll this operation until the mockup is `ready`. The ready response lists every printable product in `data.surfaces` (addressed by `surface_uuid`), and every print area someone has drawn in `data.quads` (addressed by `print_area_id`).
+2. **Photo Mockup: Get** returns `draft`, `ready`, or `failed` status. Poll this operation until the mockup is `ready`. The ready response lists every printable product, and the main wall of a room photo, in `data.surfaces` (addressed by `surface_uuid`), and every print area someone has drawn in `data.quads` (addressed by `print_area_id`).
 3. **Photo Mockup: List** returns your photo mockups with limit, offset, and shopper-customizable filtering.
-4. **Photo Mockup: Set Print Areas** replaces saved areas with quads made from four `[x, y]` coordinate pairs. It can also send an empty list; the API remains authoritative and accepts that only when the mockup can remain renderable without saved areas.
+4. **Photo Mockup: Set Print Areas** replaces saved areas with quads made from four `[x, y]` coordinate pairs. It can also send an empty list; the API remains authoritative and accepts that only when the mockup can remain renderable without saved areas. An area with a Print Area ID, the id of one of the mockup's print areas, keeps that id; an area without one gets a new id.
 5. **Photo Mockup: Render** accepts the mockup UUID and one or more ready render targets. Each target names exactly one address: `uuid` for a saved print area, or `surface_uuid` for a surface. Each target also includes either an artwork URL or Base64 artwork, with optional background removal (adds 25 credits per artwork), color, public adjustments, and placement. Export options support PNG, JPG, or WebP from 100 to 10000 pixels, plus quality and optional DPI. Each render costs 5 credits and returns `print_files`, where `print_files[0]` is the CDN URL.
 6. **Photo Mockup: Delete** deletes the selected photo mockup.
 
@@ -399,8 +403,9 @@ logo can both be addressed on the same product, in the same call, as two targets
 
 Placement is where the two kinds differ:
 
-- A **surface** target takes **Coverage**, a percentage from 10 to 100. Leave it out
-  and the artwork covers the whole surface.
+- A **surface** target takes either **Coverage**, a percentage from 10 to 100, or an
+  explicit **Width** and **Height** pair. Send one or the other, never both. Leave
+  both out and the artwork covers the whole surface.
 - A **print area** target takes either **Fit** (`contain`, `fill`, or `cover`), which
   always sizes the artwork to the whole area, or an explicit **Width** and **Height**
   pair when you want to choose the box yourself. Send one or the other, never both,
@@ -409,6 +414,15 @@ Placement is where the two kinds differ:
 Both kinds take position, offset, and rotation. Anything you do not set is not sent,
 so the API decides it.
 
+Both kinds also take **Tile**, which repeats the artwork as a pattern across the
+whole target. The size you set is one tile: **Fit**, or **Width** and **Height**, on
+a print area, and **Coverage**, or **Width** and **Height**, on a surface. **Position**
+with **Offset X** and **Offset Y** sets where the grid starts. **Tile Spacing** is the
+gap between tiles, 0 to 100 percent of the tile size, used only when Tile is on.
+
+Each entry in `data.surfaces` also carries a `label`, what was detected there, such
+as `pillow` or `wall`, so you can tell surfaces apart before you pick one.
+
 Create must reach `ready` through **Photo Mockup: Get** before **Photo Mockup: Render**.
 
 ---
@@ -421,7 +435,7 @@ Turn a mockup (or an existing image URL) into a short product video. Always asyn
 
 - **Input Mode**: `Render Mockup` (render a mockup with your designs first) or `Animate Image URL` (animate a public image directly)
 - **Mockup UUID** (required in Render Mockup mode): UUID of the mockup to animate
-- **Smart Objects** (required in Render Mockup mode): one or more smart objects with a Design URL and Fit Mode
+- **Smart Objects** (required in Render Mockup mode): one or more smart objects with a Design URL and Fit Mode, plus optional Custom Width, Custom Height, Position Top, Position Left, Tile and Tile Spacing, the same as in PSD Mockup: Render
 - **Image URL** (required in Animate Image URL mode): public HTTPS image (`.png`, `.jpg`, `.jpeg`, `.webp`, `.gif`, `.avif`)
 - **Webhook URL** (optional): one-off HTTPS URL notified when this job finishes
 - **Video Options**: