@nodaro/shared 3.4.0 → 3.6.0

package/dist/index.cjs

@@ -4945,6 +4945,63 @@ function assembleNarratedVideoCredits(blockCount) {
   return 3 + Math.ceil(blockCount / 6);
 }
 
+// src/image-overlay-platforms.ts
+var YT_BANNER_ALL = { x: (2560 - 1546) / 2 / 2560, y: (1440 - 423) / 2 / 1440, w: 1546 / 2560, h: 423 / 1440 };
+var OVERLAY_PLATFORMS = [
+  { id: "youtube-thumbnail", label: "YouTube thumbnail", width: 1280, height: 720, safe: { x: 0, y: 0, w: 1, h: 0.86 }, note: "The bottom-right corner carries the duration badge." },
+  {
+    id: "youtube-banner",
+    label: "YouTube channel banner",
+    width: 2560,
+    height: 1440,
+    safe: YT_BANNER_ALL,
+    zones: [
+      { id: "tv", x: 0, y: 0, w: 1, h: 1 },
+      { id: "desktop", x: 0, y: (1440 - 423) / 2 / 1440, w: 1, h: 423 / 1440 },
+      { id: "all", ...YT_BANNER_ALL }
+    ],
+    note: "TV shows the whole banner, desktop a 2560\xD7423 strip, phones only the centre 1546\xD7423."
+  },
+  { id: "linkedin-company", label: "LinkedIn company cover", width: 1128, height: 191, safe: { x: 0.18, y: 0, w: 0.82, h: 1 }, note: "The company logo sits over the left ~200px." },
+  { id: "linkedin-personal", label: "LinkedIn personal cover", width: 1584, height: 396, safe: { x: 0.24, y: 0, w: 0.76, h: 0.9 }, note: "The profile photo covers the bottom-left." },
+  { id: "x-header", label: "X / Twitter header", width: 1500, height: 500, safe: { x: 0.2, y: 0.05, w: 0.78, h: 0.9 }, note: "The profile photo covers the bottom-left." },
+  { id: "facebook-cover", label: "Facebook page cover", width: 820, height: 312, safe: { x: 0.05, y: 0.08, w: 0.9, h: 0.84 } },
+  { id: "instagram-post", label: "Instagram post (1:1)", width: 1080, height: 1080 },
+  { id: "instagram-portrait", label: "Instagram post (4:5)", width: 1080, height: 1350 },
+  { id: "instagram-story", label: "Instagram / TikTok story (9:16)", width: 1080, height: 1920, safe: { x: 0, y: 250 / 1920, w: 1, h: (1920 - 500) / 1920 }, note: "The top and bottom 250px sit under the story UI." },
+  { id: "open-graph", label: "Link preview (Open Graph)", width: 1200, height: 630 },
+  { id: "presentation", label: "Presentation slide (16:9)", width: 1920, height: 1080 },
+  { id: "a4-print", label: "Print A4 @300dpi", width: 2480, height: 3508, safe: { x: 0.05, y: 0.05, w: 0.9, h: 0.9 }, note: "5% bleed margin." }
+];
+var OVERLAY_PLATFORM_IDS = OVERLAY_PLATFORMS.map((p) => p.id);
+function overlayPlatformById(id) {
+  return id ? OVERLAY_PLATFORMS.find((p) => p.id === id) : void 0;
+}
+var OVERLAY_MAX_VARIANTS = OVERLAY_PLATFORMS.length;
+var OVERLAY_VARIANT_HANDLE_PREFIX = "variant:";
+function overlayVariantHandle(platformId) {
+  return `${OVERLAY_VARIANT_HANDLE_PREFIX}${platformId}`;
+}
+function overlayVariantIdFromHandle(handle) {
+  if (!handle || !handle.startsWith(OVERLAY_VARIANT_HANDLE_PREFIX)) return null;
+  const id = handle.slice(OVERLAY_VARIANT_HANDLE_PREFIX.length);
+  return overlayPlatformById(id) ? id : null;
+}
+
+// src/credit-estimators/image-overlay.ts
+var IMAGE_OVERLAY_BASE_CREDITS = 10;
+var IMAGE_OVERLAY_VARIANT_CREDITS = 2;
+function imageOverlayBillableVariants(variants) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const v of variants ?? []) {
+    if (typeof v === "string" && overlayPlatformById(v)) seen.add(v);
+  }
+  return [...seen];
+}
+function imageOverlayCredits(variants) {
+  return IMAGE_OVERLAY_BASE_CREDITS + IMAGE_OVERLAY_VARIANT_CREDITS * imageOverlayBillableVariants(variants).length;
+}
+
 // src/video-duration.ts
 function extractVideoDurationFromNode(data) {
   if (!data) return void 0;
@@ -13922,6 +13979,167 @@ var SUPPORTED_FONT_NAMES = [
   "Tajawal"
 ];
 
+// src/image-overlay-shapes.ts
+var OVERLAY_SHAPES = [
+  "rect",
+  "rounded",
+  "pill",
+  "circle",
+  "ribbon",
+  "triangle",
+  "diamond",
+  "hexagon",
+  "star",
+  "burst",
+  "arrow"
+];
+function round(n) {
+  return Math.round(n * 100) / 100;
+}
+function points(list) {
+  return list.map(([x, y]) => `${round(x)},${round(y)}`).join(" ");
+}
+function radial(cx, cy, rx, ry, n, inner) {
+  const pts = [];
+  for (let i = 0; i < n * 2; i++) {
+    const a = -Math.PI / 2 + i * Math.PI / n;
+    const f = i % 2 === 0 ? 1 : inner;
+    pts.push([cx + Math.cos(a) * rx * f, cy + Math.sin(a) * ry * f]);
+  }
+  return points(pts);
+}
+function overlayShapeElement(shape, w, h, inset = 0) {
+  const i = Math.max(0, inset);
+  const iw = Math.max(0, w - 2 * i);
+  const ih = Math.max(0, h - 2 * i);
+  const cx = w / 2;
+  const cy = h / 2;
+  switch (shape) {
+    case "rounded":
+      return { tag: "rect", attrs: { x: i, y: i, width: iw, height: ih, rx: round(Math.min(iw, ih) * 0.18) } };
+    case "pill":
+      return { tag: "rect", attrs: { x: i, y: i, width: iw, height: ih, rx: round(ih / 2) } };
+    case "circle":
+      return { tag: "ellipse", attrs: { cx, cy, rx: round(iw / 2), ry: round(ih / 2) } };
+    case "ribbon": {
+      const notch = Math.min(w / 4, h / 2);
+      return { tag: "polygon", attrs: { points: points([[i, i], [w - i, i], [w - notch, cy], [w - i, h - i], [i, h - i], [notch, cy]]) } };
+    }
+    case "triangle":
+      return { tag: "polygon", attrs: { points: points([[cx, i], [w - i, h - i], [i, h - i]]) } };
+    case "diamond":
+      return { tag: "polygon", attrs: { points: points([[cx, i], [w - i, cy], [cx, h - i], [i, cy]]) } };
+    case "hexagon":
+      return { tag: "polygon", attrs: { points: points([[w * 0.25, i], [w * 0.75, i], [w - i, cy], [w * 0.75, h - i], [w * 0.25, h - i], [i, cy]]) } };
+    case "star":
+      return { tag: "polygon", attrs: { points: radial(cx, cy, iw / 2, ih / 2, 5, 0.42) } };
+    case "burst":
+      return { tag: "polygon", attrs: { points: radial(cx, cy, iw / 2, ih / 2, 14, 0.82) } };
+    case "arrow":
+      return {
+        tag: "polygon",
+        attrs: { points: points([[i, h * 0.25], [w * 0.6, h * 0.25], [w * 0.6, i], [w - i, cy], [w * 0.6, h - i], [w * 0.6, h * 0.75], [i, h * 0.75]]) }
+      };
+    default:
+      return { tag: "rect", attrs: { x: i, y: i, width: iw, height: ih } };
+  }
+}
+
+// src/image-overlay-layers.ts
+var OVERLAY_LAYER_KINDS = ["image", "text", "qr", "shape"];
+var OVERLAY_TEXT_ALIGNS = ["left", "center", "right"];
+var OVERLAY_IMAGE_MASKS = ["none", "circle"];
+var OVERLAY_FONTS = [
+  { id: "inter", family: "Inter", file: "Inter.ttf", variable: true, scripts: ["latin"], category: "sans" },
+  { id: "montserrat", family: "Montserrat", file: "Montserrat.ttf", variable: true, scripts: ["latin"], category: "sans" },
+  { id: "space-grotesk", family: "Space Grotesk", file: "SpaceGrotesk.ttf", variable: true, scripts: ["latin"], category: "sans" },
+  { id: "playfair-display", family: "Playfair Display", file: "PlayfairDisplay.ttf", variable: true, scripts: ["latin"], category: "serif" },
+  { id: "oswald", family: "Oswald", file: "Oswald.ttf", variable: true, scripts: ["latin"], category: "display" },
+  { id: "bebas-neue", family: "Bebas Neue", file: "BebasNeue.ttf", variable: false, scripts: ["latin"], category: "display" },
+  { id: "anton", family: "Anton", file: "Anton.ttf", variable: false, scripts: ["latin"], category: "display" },
+  { id: "pacifico", family: "Pacifico", file: "Pacifico.ttf", variable: false, scripts: ["latin"], category: "script" },
+  { id: "rubik", family: "Rubik", file: "Rubik.ttf", variable: true, scripts: ["latin", "hebrew"], category: "sans" },
+  { id: "heebo", family: "Heebo", file: "Heebo.ttf", variable: true, scripts: ["latin", "hebrew"], category: "sans" }
+];
+var OVERLAY_FONT_IDS = OVERLAY_FONTS.map((f) => f.id);
+function overlayFontById(id) {
+  return OVERLAY_FONTS.find((f) => f.id === id);
+}
+var hex6 = zod.z.string().regex(/^#[0-9a-fA-F]{6}$/, "Expected a #RRGGBB color");
+var overlayStrokeSchema = zod.z.object({
+  /** px on the base image */
+  width: zod.z.number().min(0).max(50),
+  color: hex6
+});
+var overlayTextStyleSchema = zod.z.object({
+  text: zod.z.string().min(1).max(500),
+  fontId: zod.z.enum(OVERLAY_FONT_IDS).default("inter"),
+  fontWeight: zod.z.number().int().min(100).max(900).default(700),
+  /** % of the BASE height */
+  fontSize: zod.z.number().min(1).max(50).default(8),
+  color: hex6.default("#ffffff"),
+  align: zod.z.enum(OVERLAY_TEXT_ALIGNS).default("center"),
+  /** em */
+  letterSpacing: zod.z.number().min(-0.2).max(1).default(0),
+  lineHeight: zod.z.number().min(0.8).max(2.5).default(1.15),
+  uppercase: zod.z.boolean().default(false),
+  stroke: overlayStrokeSchema.optional(),
+  /** A filled box behind the text — a pill, a badge, a lower third. */
+  background: zod.z.object({
+    color: hex6,
+    opacity: zod.z.number().min(0).max(1).default(1),
+    /** px on the base image */
+    padding: zod.z.number().min(0).max(300).default(24),
+    /** px corner radius; a huge value makes a pill */
+    radius: zod.z.number().min(0).max(1e3).default(0)
+  }).optional()
+});
+var overlayQrStyleSchema = zod.z.object({
+  /** The link / text the code opens. May be empty ONLY while `fromInput` is
+   *  set — the run then fills it from the node's "QR link" text handle. */
+  text: zod.z.string().max(2e3).default(""),
+  /** Take the payload from the node's QR link handle (a Text node, a List
+   *  column, any text output) instead of this style's `text`. */
+  fromInput: zod.z.boolean().optional(),
+  color: hex6.default("#000000"),
+  /** Absent = transparent quiet zone and background. */
+  background: hex6.optional(),
+  /** Quiet-zone modules */
+  margin: zod.z.number().int().min(0).max(8).default(1)
+});
+var overlayShapeStyleSchema = zod.z.object({
+  shape: zod.z.enum(OVERLAY_SHAPES).default("rect"),
+  color: hex6.default("#ff0073"),
+  stroke: overlayStrokeSchema.optional()
+});
+var overlayImageEffectsSchema = zod.z.object({
+  mask: zod.z.enum(OVERLAY_IMAGE_MASKS).optional(),
+  /** px on the base image — edge fade width */
+  feather: zod.z.number().min(0).max(500).optional(),
+  stroke: overlayStrokeSchema.optional(),
+  glow: zod.z.object({
+    blur: zod.z.number().min(0).max(200),
+    color: hex6,
+    opacity: zod.z.number().min(0).max(1)
+  }).optional()
+});
+var DEFAULT_OVERLAY_TEXT = {
+  text: "Your text",
+  fontId: "inter",
+  fontWeight: 700,
+  fontSize: 8,
+  color: "#ffffff",
+  align: "center",
+  letterSpacing: 0,
+  lineHeight: 1.15,
+  uppercase: false
+};
+var DEFAULT_OVERLAY_QR = { text: "https://nodaro.ai", color: "#000000", background: "#ffffff", margin: 1 };
+var DEFAULT_OVERLAY_SHAPE = { shape: "pill", color: "#ff0073" };
+function isRtlText(text) {
+  return /[֐-׿؀-ۿݐ-ݿࢠ-ࣿיִ-﷿ﹰ-]/.test(text);
+}
+
 // src/entity-image-handle.ts
 var ENTITY_IMAGE_HANDLE_TYPES = /* @__PURE__ */ new Set([
   "character",
@@ -15257,6 +15475,7 @@ var SCENE3D_V2_LIMITS = {
   maxIdLength: SCENE3D_LIMITS.maxIdLength,
   maxAssetIdLength: 128,
   maxNodeIdLength: 128,
+  maxNodeNameLength: 256,
   maxNameLength: SCENE3D_LIMITS.maxNameLength,
   maxLabelLength: SCENE3D_LIMITS.maxNameLength,
   maxMaterialNameLength: 120,
@@ -15325,9 +15544,10 @@ var SCENE3D_RENDERER_ASSET_KINDS = [
   "poster"
 ];
 var SCENE3D_PRIMITIVE_MATERIAL_ROLE = "identity";
-var SCENE3D_CLAY_LIGHTING_PRESETS = ["clay-studio-v1"];
+var SCENE3D_CLAY_LIGHTING_PRESETS = ["clay-studio-v1", "clay-studio-v2"];
 var scene3DAssetIdSchema = zod.z.string().min(1).max(SCENE3D_V2_LIMITS.maxAssetIdLength).regex(/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/, "assetId must be an opaque id (letters, digits, '_', '-', '.', ':')").refine((value) => !value.includes(".."), "assetId must not contain '..'");
 var scene3DNodeIdSchema = zod.z.string().min(1).max(SCENE3D_V2_LIMITS.maxNodeIdLength).regex(/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/, "node id must be an exporter-generated stable id");
+var scene3DNodeNameSchema = zod.z.string().min(1).max(SCENE3D_V2_LIMITS.maxNodeNameLength).regex(/^[^\u0000-\u001f\u007f]+$/, "node name must not contain control characters");
 var scene3DSha256Schema = zod.z.string().regex(/^[0-9a-f]{64}$/, "sha256 must be 64 lowercase hex characters");
 var scene3DVersionTokenSchema = zod.z.string().min(1).max(SCENE3D_V2_LIMITS.maxVersionLength).regex(
   /^[A-Za-z0-9][A-Za-z0-9_.+-]*$/,
@@ -15342,6 +15562,7 @@ var scene3DEntityCapabilitySchema = zod.z.enum(["transform", "color", "visibilit
 var scene3DAnchorSchema = zod.z.object({
   name: scene3DAnchorNameSchema,
   position: vec3Schema,
+  nodeName: scene3DNodeNameSchema.optional(),
   rotation: rotationVec3Schema.optional()
 }).strict();
 var scene3DMaterialBindingSchema = zod.z.object({
@@ -15526,6 +15747,12 @@ function checkEntities(plan, byId, issues) {
     });
     const anchorNames = /* @__PURE__ */ new Set();
     (entity.anchors ?? []).forEach((anchor, anchorIndex) => {
+      if (anchor.nodeName !== void 0 && entity.visual.kind !== "asset") {
+        issues.push({
+          path: at("anchors", anchorIndex, "nodeName"),
+          message: `entity "${entity.id}" can bind anchor nodes only with an asset visual`
+        });
+      }
       if (anchorNames.has(anchor.name)) {
         issues.push({
           path: at("anchors", anchorIndex, "name"),
@@ -16274,8 +16501,8 @@ function scene3DCameraTrackIssues(track) {
   }
   const quaternionTolerance = SCENE3D_CAMERA_TRACK_LIMITS.quaternionTolerance;
   track.samples.forEach((sample, index) => {
-    const [x, y, z24, w] = sample.quaternion;
-    const norm = Math.sqrt(x * x + y * y + z24 * z24 + w * w);
+    const [x, y, z25, w] = sample.quaternion;
+    const norm = Math.sqrt(x * x + y * y + z25 * z25 + w * w);
     if (Math.abs(norm - 1) > quaternionTolerance) {
       issues.push({
         path: ["samples", index, "quaternion"],
@@ -16878,6 +17105,9 @@ exports.DEFAULT_CHARACTER_EXPRESSION_COUNT = DEFAULT_CHARACTER_EXPRESSION_COUNT;
 exports.DEFAULT_CHARACTER_FACET = DEFAULT_CHARACTER_FACET;
 exports.DEFAULT_LABEL_BY_SOURCE = DEFAULT_LABEL_BY_SOURCE;
 exports.DEFAULT_LOCATION_USAGE_MODE = DEFAULT_LOCATION_USAGE_MODE;
+exports.DEFAULT_OVERLAY_QR = DEFAULT_OVERLAY_QR;
+exports.DEFAULT_OVERLAY_SHAPE = DEFAULT_OVERLAY_SHAPE;
+exports.DEFAULT_OVERLAY_TEXT = DEFAULT_OVERLAY_TEXT;
 exports.DEFAULT_PANEL_COUNT = DEFAULT_PANEL_COUNT;
 exports.DEFAULT_REF_IMAGE_MAX = DEFAULT_REF_IMAGE_MAX;
 exports.DEFAULT_SECTIONS = DEFAULT_SECTIONS;
@@ -16964,6 +17194,8 @@ exports.IMAGE_EDIT_PROVIDERS = IMAGE_EDIT_PROVIDERS;
 exports.IMAGE_GEN_PROVIDERS = IMAGE_GEN_PROVIDERS;
 exports.IMAGE_I2I_PROVIDERS = IMAGE_I2I_PROVIDERS;
 exports.IMAGE_MASK_MODE = IMAGE_MASK_MODE;
+exports.IMAGE_OVERLAY_BASE_CREDITS = IMAGE_OVERLAY_BASE_CREDITS;
+exports.IMAGE_OVERLAY_VARIANT_CREDITS = IMAGE_OVERLAY_VARIANT_CREDITS;
 exports.IMAGE_PROMPT_MAX = IMAGE_PROMPT_MAX;
 exports.IMAGE_REF_TYPES = IMAGE_REF_TYPES;
 exports.IMAGE_TO_VIDEO_PROVIDERS = IMAGE_TO_VIDEO_PROVIDERS;
@@ -17054,6 +17286,16 @@ exports.ORG_ROLES = ORG_ROLES;
 exports.ORG_STATUSES = ORG_STATUSES;
 exports.OUTPUT_FIELD_MAP = OUTPUT_FIELD_MAP;
 exports.OUTPUT_FORMATS = OUTPUT_FORMATS;
+exports.OVERLAY_FONTS = OVERLAY_FONTS;
+exports.OVERLAY_FONT_IDS = OVERLAY_FONT_IDS;
+exports.OVERLAY_IMAGE_MASKS = OVERLAY_IMAGE_MASKS;
+exports.OVERLAY_LAYER_KINDS = OVERLAY_LAYER_KINDS;
+exports.OVERLAY_MAX_VARIANTS = OVERLAY_MAX_VARIANTS;
+exports.OVERLAY_PLATFORMS = OVERLAY_PLATFORMS;
+exports.OVERLAY_PLATFORM_IDS = OVERLAY_PLATFORM_IDS;
+exports.OVERLAY_SHAPES = OVERLAY_SHAPES;
+exports.OVERLAY_TEXT_ALIGNS = OVERLAY_TEXT_ALIGNS;
+exports.OVERLAY_VARIANT_HANDLE_PREFIX = OVERLAY_VARIANT_HANDLE_PREFIX;
 exports.ObjectMetadataSchema = ObjectMetadataSchema;
 exports.OptimizeForModelInputSchema = OptimizeForModelInputSchema;
 exports.OptimizeForModelResultSchema = OptimizeForModelResultSchema;
@@ -17499,6 +17741,8 @@ exports.hexToRgbaArray = hexToRgbaArray;
 exports.humanizeSlotSid = humanizeSlotSid;
 exports.imageMentionSlug = imageMentionSlug;
 exports.imageMentionSlugForRef = imageMentionSlugForRef;
+exports.imageOverlayBillableVariants = imageOverlayBillableVariants;
+exports.imageOverlayCredits = imageOverlayCredits;
 exports.imageReferenceLimit = imageReferenceLimit;
 exports.inferMusicVideo = inferMusicVideo;
 exports.isAggregateableType = isAggregateableType;
@@ -17521,6 +17765,7 @@ exports.isPerSecondLipSyncProvider = isPerSecondLipSyncProvider;
 exports.isPro3DRenderJobOutput = isPro3DRenderJobOutput;
 exports.isPro3DRenderQuote = isPro3DRenderQuote;
 exports.isPro3DRenderRenderOnly = isPro3DRenderRenderOnly;
+exports.isRtlText = isRtlText;
 exports.isScene3DAuthoringEngine = isScene3DAuthoringEngine;
 exports.isScene3DCameraTrack = isScene3DCameraTrack;
 exports.isScene3DHttpUrl = isScene3DHttpUrl;
@@ -17572,6 +17817,16 @@ exports.normalizeRoleSlug = normalizeRoleSlug;
 exports.normalizeVideoRequestParams = normalizeVideoRequestParams;
 exports.normalizeWan3Resolution = normalizeWan3Resolution;
 exports.orderedLlmModels = orderedLlmModels;
+exports.overlayFontById = overlayFontById;
+exports.overlayImageEffectsSchema = overlayImageEffectsSchema;
+exports.overlayPlatformById = overlayPlatformById;
+exports.overlayQrStyleSchema = overlayQrStyleSchema;
+exports.overlayShapeElement = overlayShapeElement;
+exports.overlayShapeStyleSchema = overlayShapeStyleSchema;
+exports.overlayStrokeSchema = overlayStrokeSchema;
+exports.overlayTextStyleSchema = overlayTextStyleSchema;
+exports.overlayVariantHandle = overlayVariantHandle;
+exports.overlayVariantIdFromHandle = overlayVariantIdFromHandle;
 exports.parseAttributedDialogue = parseAttributedDialogue;
 exports.parseCharacterMentionToken = parseCharacterMentionToken;
 exports.parseEntityMentionToken = parseEntityMentionToken;
@@ -17700,6 +17955,7 @@ exports.scene3DMaterialBindingSchema = scene3DMaterialBindingSchema;
 exports.scene3DMaterialNameSchema = scene3DMaterialNameSchema;
 exports.scene3DMaterialRoleSchema = scene3DMaterialRoleSchema;
 exports.scene3DNodeIdSchema = scene3DNodeIdSchema;
+exports.scene3DNodeNameSchema = scene3DNodeNameSchema;
 exports.scene3DObjectChangesSchema = scene3DObjectChangesSchema;
 exports.scene3DObjectKeyframeSchema = scene3DObjectKeyframeSchema;
 exports.scene3DObjectSchema = scene3DObjectSchema;