@shop-os/modelkit 0.7.3 → 0.7.4

package/dist/index.cjs

@@ -6687,6 +6687,161 @@ var MODEL3D_IMAGE_SLOTS = {
   ordered: ["image", "left", "back", "right"],
   unordered: ["image", "back", "left", "right", "top"]
 };
+var MODEL3D_FAMILY_RULES = {
+  trellis: {
+    textPath: false,
+    views: ["none"],
+    multiImage: false,
+    texture: null,
+    pbr: false,
+    seed: true,
+    textureRef: false,
+    resolutions: "integer"
+  },
+  hunyuan: {
+    textPath: true,
+    views: ["none", "named"],
+    multiImage: false,
+    // generate_type
+    texture: { none: "Geometry", standard: "Normal" },
+    pbr: true,
+    seed: false,
+    textureRef: false,
+    resolutions: null
+  },
+  tripo: {
+    textPath: true,
+    views: ["none", "ordered"],
+    multiImage: true,
+    // texture_quality; null sends an untextured model.
+    texture: { none: null, standard: "standard", detailed: "detailed" },
+    pbr: true,
+    seed: true,
+    textureRef: false,
+    resolutions: null
+  },
+  rodin: {
+    textPath: true,
+    views: ["none", "unordered"],
+    multiImage: false,
+    texture: null,
+    pbr: false,
+    seed: true,
+    textureRef: false,
+    resolutions: null
+  },
+  meshy: {
+    textPath: true,
+    views: ["none", "unordered"],
+    multiImage: true,
+    // The text endpoint's mode; the image endpoints take should_texture.
+    texture: { none: "preview", standard: "full" },
+    pbr: true,
+    seed: true,
+    textureRef: true,
+    resolutions: null
+  },
+  hi3d: {
+    textPath: false,
+    views: ["none", "named"],
+    multiImage: true,
+    // enable_texture
+    texture: { none: false, standard: true },
+    pbr: true,
+    seed: false,
+    textureRef: false,
+    resolutions: { quality: "2048quality", master: "2048master" }
+  },
+  sam: {
+    textPath: false,
+    views: ["none"],
+    multiImage: false,
+    texture: null,
+    pbr: false,
+    seed: true,
+    textureRef: false,
+    resolutions: null
+  }
+};
+function model3dSpecIssues(spec) {
+  const issues = [];
+  const add = (path, message) => issues.push({ path, message });
+  const rules = MODEL3D_FAMILY_RULES[spec.family];
+  const promptOnly = spec.text && !spec.imageRequired;
+  if (spec.endpoints.image === void 0)
+    add(["endpoints", "image"], "every row needs an image endpoint");
+  if (promptOnly && !rules.textPath) {
+    add(
+      ["imageRequired"],
+      `${spec.family} has no text-to-3D endpoint; a text row needs an image`
+    );
+  }
+  if (promptOnly && spec.endpoints.text === void 0) {
+    add(["endpoints", "text"], "a text row needs a text endpoint");
+  }
+  if (!rules.views.includes(spec.views)) {
+    add(["views"], `${spec.family} takes views ${rules.views.join(" or ")}`);
+  }
+  if (spec.views === "none" && spec.maxImages !== 1) {
+    add(["maxImages"], "a row without views takes 1 image");
+  }
+  if (spec.views === "unordered" && spec.maxImages < 2) {
+    add(["maxImages"], "a row with views takes at least 2 images");
+  }
+  const slots = MODEL3D_IMAGE_SLOTS[spec.views].length;
+  if (spec.views !== "none" && spec.maxImages > slots) {
+    add(["maxImages"], `a row with ${spec.views} views sends at most ${slots} images`);
+  }
+  if ((spec.views === "named" || spec.views === "ordered") && spec.maxImages < slots) {
+    add(
+      ["maxImages"],
+      `a row with ${spec.views} views takes ${slots} images (front and three sides)`
+    );
+  }
+  if (spec.views !== "none" && rules.multiImage && spec.endpoints.multiImage === void 0) {
+    add(["endpoints", "multiImage"], `${spec.family} sends views to a multi-image endpoint`);
+  }
+  if (rules.texture === null) {
+    if (spec.texture.length > 0) add(["texture"], `${spec.family} has no texture switch`);
+  } else {
+    const allowed = rules.texture;
+    if (spec.texture.length === 0) add(["texture"], `${spec.family} needs its texture options`);
+    if (new Set(spec.texture).size !== spec.texture.length)
+      add(["texture"], "texture options repeat");
+    for (const t of spec.texture) {
+      if (!Object.hasOwn(allowed, t))
+        add(["texture"], `${spec.family} has no "${t}" texture`);
+    }
+  }
+  if (spec.pbr && !rules.pbr) add(["pbr"], `${spec.family} has no PBR switch`);
+  if (spec.pbr && !spec.texture.some((t) => t !== "none")) {
+    add(["pbr"], "PBR needs a textured option");
+  }
+  if (spec.seed && !rules.seed) add(["seed"], `${spec.family} takes no seed`);
+  if (spec.seedMax !== void 0 && !spec.seed) add(["seedMax"], "seedMax needs seed");
+  if (spec.textureRef && !rules.textureRef)
+    add(["textureRef"], `${spec.family} takes no texture reference`);
+  const res = spec.resolutions;
+  if (rules.resolutions === null) {
+    if (res !== void 0) add(["resolutions"], `${spec.family} has no resolution option`);
+  } else if (res === void 0) {
+    add(["resolutions"], `${spec.family} needs its resolution options`);
+  } else {
+    if (!res.options.includes(res.default)) {
+      add(["resolutions", "default"], "default must be an option");
+    }
+    if (new Set(res.options).size !== res.options.length) {
+      add(["resolutions", "options"], "resolution options repeat");
+    }
+    const allowed = rules.resolutions;
+    for (const option of res.options) {
+      const ok = allowed === "integer" ? /^[1-9][0-9]*$/.test(option) : Object.hasOwn(allowed, option);
+      if (!ok)
+        add(["resolutions", "options"], `${spec.family} has no "${option}" resolution`);
+    }
+  }
+  return issues;
+}
 function model3dInputRefusal(spec, wired) {
   const top = spec.views === "unordered" && wired.top === true;
   const anyView = spec.views !== "none" && (wired.back || wired.left || wired.right || top);
@@ -7274,156 +7429,6 @@ var LanguageOptionSchema = import_zod3.z.looseObject({
   code: import_zod3.z.string().min(1),
   name: import_zod3.z.string().min(1)
 });
-var MODEL3D_FAMILY_RULES = {
-  trellis: {
-    textPath: false,
-    views: ["none"],
-    multiImage: false,
-    texture: null,
-    pbr: false,
-    seed: true,
-    textureRef: false,
-    resolutions: "integer"
-  },
-  hunyuan: {
-    textPath: true,
-    views: ["none", "named"],
-    multiImage: false,
-    texture: ["none", "standard"],
-    pbr: true,
-    seed: false,
-    textureRef: false,
-    resolutions: null
-  },
-  tripo: {
-    textPath: true,
-    views: ["none", "ordered"],
-    multiImage: true,
-    texture: ["none", "standard", "detailed"],
-    pbr: true,
-    seed: true,
-    textureRef: false,
-    resolutions: null
-  },
-  rodin: {
-    textPath: true,
-    views: ["none", "unordered"],
-    multiImage: false,
-    texture: null,
-    pbr: false,
-    seed: true,
-    textureRef: false,
-    resolutions: null
-  },
-  meshy: {
-    textPath: true,
-    views: ["none", "unordered"],
-    multiImage: true,
-    texture: ["none", "standard"],
-    pbr: true,
-    seed: true,
-    textureRef: true,
-    resolutions: null
-  },
-  hi3d: {
-    textPath: false,
-    views: ["none", "named"],
-    multiImage: true,
-    texture: ["none", "standard"],
-    pbr: true,
-    seed: false,
-    textureRef: false,
-    resolutions: ["quality", "master"]
-  },
-  sam: {
-    textPath: false,
-    views: ["none"],
-    multiImage: false,
-    texture: null,
-    pbr: false,
-    seed: true,
-    textureRef: false,
-    resolutions: null
-  }
-};
-function model3dSpecIssues(spec) {
-  const issues = [];
-  const add = (path, message) => issues.push({ path, message });
-  const rules = MODEL3D_FAMILY_RULES[spec.family];
-  const promptOnly = spec.text && !spec.imageRequired;
-  if (spec.endpoints.image === void 0)
-    add(["endpoints", "image"], "every row needs an image endpoint");
-  if (promptOnly && !rules.textPath) {
-    add(
-      ["imageRequired"],
-      `${spec.family} has no text-to-3D endpoint; a text row needs an image`
-    );
-  }
-  if (promptOnly && spec.endpoints.text === void 0) {
-    add(["endpoints", "text"], "a text row needs a text endpoint");
-  }
-  if (!rules.views.includes(spec.views)) {
-    add(["views"], `${spec.family} takes views ${rules.views.join(" or ")}`);
-  }
-  if (spec.views === "none" && spec.maxImages !== 1) {
-    add(["maxImages"], "a row without views takes 1 image");
-  }
-  if (spec.views === "unordered" && spec.maxImages < 2) {
-    add(["maxImages"], "a row with views takes at least 2 images");
-  }
-  const slots = MODEL3D_IMAGE_SLOTS[spec.views].length;
-  if (spec.views !== "none" && spec.maxImages > slots) {
-    add(["maxImages"], `a row with ${spec.views} views sends at most ${slots} images`);
-  }
-  if ((spec.views === "named" || spec.views === "ordered") && spec.maxImages < slots) {
-    add(
-      ["maxImages"],
-      `a row with ${spec.views} views takes ${slots} images (front and three sides)`
-    );
-  }
-  if (spec.views !== "none" && rules.multiImage && spec.endpoints.multiImage === void 0) {
-    add(["endpoints", "multiImage"], `${spec.family} sends views to a multi-image endpoint`);
-  }
-  if (rules.texture === null) {
-    if (spec.texture.length > 0) add(["texture"], `${spec.family} has no texture switch`);
-  } else {
-    const allowed = rules.texture;
-    if (spec.texture.length === 0) add(["texture"], `${spec.family} needs its texture options`);
-    if (new Set(spec.texture).size !== spec.texture.length)
-      add(["texture"], "texture options repeat");
-    for (const t of spec.texture) {
-      if (!allowed.includes(t)) add(["texture"], `${spec.family} has no "${t}" texture`);
-    }
-  }
-  if (spec.pbr && !rules.pbr) add(["pbr"], `${spec.family} has no PBR switch`);
-  if (spec.pbr && !spec.texture.some((t) => t !== "none")) {
-    add(["pbr"], "PBR needs a textured option");
-  }
-  if (spec.seed && !rules.seed) add(["seed"], `${spec.family} takes no seed`);
-  if (spec.seedMax !== void 0 && !spec.seed) add(["seedMax"], "seedMax needs seed");
-  if (spec.textureRef && !rules.textureRef)
-    add(["textureRef"], `${spec.family} takes no texture reference`);
-  const res = spec.resolutions;
-  if (rules.resolutions === null) {
-    if (res !== void 0) add(["resolutions"], `${spec.family} has no resolution option`);
-  } else if (res === void 0) {
-    add(["resolutions"], `${spec.family} needs its resolution options`);
-  } else {
-    if (!res.options.includes(res.default)) {
-      add(["resolutions", "default"], "default must be an option");
-    }
-    if (new Set(res.options).size !== res.options.length) {
-      add(["resolutions", "options"], "resolution options repeat");
-    }
-    const allowed = rules.resolutions;
-    for (const option of res.options) {
-      const ok = allowed === "integer" ? /^[1-9][0-9]*$/.test(option) : allowed.includes(option);
-      if (!ok)
-        add(["resolutions", "options"], `${spec.family} has no "${option}" resolution`);
-    }
-  }
-  return issues;
-}
 var VideoToolConstraintsSchema = import_zod3.z.looseObject({
   kind: import_zod3.z.enum(["upscale", "interpolate", "hdr", "bg-remove", "subtitles"]),
   upscaleFactor: RangeSchema.optional(),
@@ -10825,6 +10830,19 @@ function specOf(ctx) {
   return spec;
 }
 var present = (v) => v !== void 0 && v.length > 0;
+function wireValue(row2, values, option, what) {
+  const value = option !== void 0 && Object.hasOwn(values, option) ? values[option] : void 0;
+  if (value === void 0) {
+    throw new ModelKitError({
+      code: "unsupported_option",
+      message: `${row2.id} has no ${what} "${option ?? ""}" to send`,
+      provider: "fal",
+      model: row2.id,
+      retryable: false
+    });
+  }
+  return value;
+}
 function model3dCall(row2, spec, req) {
   const prompt = req.prompt?.trim() || void 0;
   const texture = model3dTexture(spec, req.texture);
@@ -10868,7 +10886,15 @@ function model3dCall(row2, spec, req) {
         }
       };
     case "hunyuan": {
-      const opts = { generate_type: textured ? "Normal" : "Geometry", enable_pbr: pbr };
+      const opts = {
+        generate_type: wireValue(
+          row2,
+          MODEL3D_FAMILY_RULES.hunyuan.texture,
+          texture,
+          "texture"
+        ),
+        enable_pbr: pbr
+      };
       if (!present(req.image)) {
         return {
           endpoint: endpoint(spec.endpoints.text),
@@ -10887,12 +10913,11 @@ function model3dCall(row2, spec, req) {
       };
     }
     case "tripo": {
+      const quality = wireValue(row2, MODEL3D_FAMILY_RULES.tripo.texture, texture, "texture");
       const opts = {
         texture: textured,
         pbr,
-        ...textured && {
-          texture_quality: texture === "detailed" ? "detailed" : "standard"
-        },
+        ...quality !== null && { texture_quality: quality },
         ...seed !== void 0 && { model_seed: seed }
       };
       if (!present(req.image)) {
@@ -10928,6 +10953,7 @@ function model3dCall(row2, spec, req) {
       };
     }
     case "meshy": {
+      const mode = wireValue(row2, MODEL3D_FAMILY_RULES.meshy.texture, texture, "texture");
       const texturePrompt = req.texturePrompt?.trim() || void 0;
       const opts = {
         enable_pbr: pbr,
@@ -10939,7 +10965,7 @@ function model3dCall(row2, spec, req) {
           endpoint: endpoint(spec.endpoints.text),
           input: {
             prompt: prompt ?? "",
-            mode: textured ? "full" : "preview",
+            mode,
             ...opts,
             ...seed !== void 0 && { seed }
           }
@@ -10955,8 +10981,18 @@ function model3dCall(row2, spec, req) {
     }
     case "hi3d": {
       const opts = {
-        resolution: resolution === "master" ? "2048master" : "2048quality",
-        enable_texture: textured,
+        resolution: wireValue(
+          row2,
+          MODEL3D_FAMILY_RULES.hi3d.resolutions,
+          resolution,
+          "resolution"
+        ),
+        enable_texture: wireValue(
+          row2,
+          MODEL3D_FAMILY_RULES.hi3d.texture,
+          texture,
+          "texture"
+        ),
         enable_pbr: pbr,
         export_format: "glb"
       };