@cliangdev/conductor 0.21.0 → 0.22.0

package/dist/creative/sheet.html

@@ -0,0 +1,27 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<title>Creative contact sheet</title>
+<link rel="stylesheet" href="styles.css">
+<style>
+  html, body { margin: 0; background: #F2F2F7; font-family: system-ui, -apple-system, sans-serif; }
+  #sheet { display: inline-flex; gap: 24px; align-items: flex-start; padding: 24px; }
+  .cell { display: flex; flex-direction: column; gap: 8px; align-items: center; }
+  .shell { position: relative; overflow: hidden; border-radius: 6px; box-shadow: 0 3px 12px rgba(0,0,0,0.16); }
+  .cap { font-size: 13px; font-weight: 700; color: #717171; }
+</style>
+</head>
+<body>
+<!--
+  Preview-only contact sheet: every enabled placement of one creative (or
+  every beat of a story/carousel), scaled down onto one page, for a quick
+  look without downloading full-size PNGs one at a time. Rendered by
+  job/render.mjs when a render's `previewOnly` flag is set, and uploaded as
+  the single frame placementKey "sheet". Reads its spec from
+  window.__RENDER_SPEC__ — see sheet.js.
+-->
+<div id="sheet"></div>
+<script type="module" src="sheet.js"></script>
+</body>
+</html>

package/dist/creative/sheet.js

@@ -0,0 +1,94 @@
+/* sheet.js — builds a contact sheet: every enabled placement of a creative,
+ * or every beat of its story/carousel sequence, scaled down onto one page.
+ * Preview only — never screenshotted per-placement, never assertion-checked
+ * (a bad frame still shows up in the sheet so a human can see what broke).
+ *
+ * Spec shape (set by job/render.mjs via page.addInitScript before this page
+ * loads):
+ *   {
+ *     creative, brand,        // see README.md's Creative/Brand shapes
+ *     placementKeys: [...],   // the render's placements (spec.placements from
+ *                             // the backend); ignored when the creative has a
+ *                             // sequence, which always renders every beat
+ *     placements?, layouts?,  // registry overrides (default: the shipped ones)
+ *   }
+ *
+ * Result contract: window.__RENDER_RESULT = { ok: true, width, height } |
+ * { ok: false, error }; window.__ready = true once the sheet has been built,
+ * fitted and scaled.
+ */
+import { resolveAd, resolveSequence, renderBoard, fitAll } from './render.js';
+import { placements as DEFAULT_PLACEMENTS } from './placements.js';
+import { layouts as DEFAULT_LAYOUTS } from './layouts/index.js';
+import { ensureBrandFont } from './font.js';
+
+const SHEET_SCALE = 0.34;
+
+function finish(result) {
+  window.__RENDER_RESULT = result;
+  window.__ready = true;
+}
+
+async function main() {
+  const spec = window.__RENDER_SPEC__;
+  if (!spec || !spec.creative) {
+    finish({ ok: false, error: 'no render spec provided (window.__RENDER_SPEC__)' });
+    return;
+  }
+  const placementsReg = spec.placements || DEFAULT_PLACEMENTS;
+  const layoutsReg = spec.layouts || DEFAULT_LAYOUTS;
+  const sheet = document.getElementById('sheet');
+  const boards = [];
+
+  function addCell(ad, placementKey, label) {
+    const placement = placementsReg[placementKey];
+    if (!placement) throw new Error(`unknown placement "${placementKey}"`);
+    const cell = document.createElement('div');
+    cell.className = 'cell';
+    const shell = document.createElement('div');
+    shell.className = 'shell';
+    shell.style.width = Math.round(placement.w * SHEET_SCALE) + 'px';
+    shell.style.height = Math.round(placement.h * SHEET_SCALE) + 'px';
+    const board = renderBoard(ad, placementKey, placementsReg, layoutsReg, spec.brand || {});
+    shell.appendChild(board);
+    cell.appendChild(shell);
+    const cap = document.createElement('div');
+    cap.className = 'cap';
+    cap.textContent = label;
+    cell.appendChild(cap);
+    sheet.appendChild(cell);
+    boards.push(board);
+  }
+
+  try {
+    await ensureBrandFont(spec.brand);
+    const isSequence = spec.creative.sequenceKind && Array.isArray(spec.creative.sequence) && spec.creative.sequence.length;
+    if (isSequence) {
+      const frames = resolveSequence(spec.creative, placementsReg, layoutsReg);
+      const key = spec.creative.sequenceKind === 'carousel' ? spec.creative.carouselRatio || '4x5' : 'story';
+      frames.forEach((frame, i) => addCell(frame, key, `${i + 1} of ${frames.length}`));
+    } else {
+      const ad = resolveAd(spec.creative, placementsReg, layoutsReg);
+      const keys = Array.isArray(spec.placementKeys) && spec.placementKeys.length
+        ? spec.placementKeys
+        : Object.keys(placementsReg).filter((k) => placementsReg[k].default);
+      keys.forEach((key) => addCell(ad, key, (placementsReg[key] && placementsReg[key].label) || key));
+    }
+
+    // Fit every board at its TRUE, unscaled size first (a CSS transform
+    // shrinks the measured rect and would throw fitBoard's line-count math
+    // off), then apply the display scale — the same order mount.js uses.
+    await fitAll(sheet, placementsReg);
+    boards.forEach((board) => {
+      board.style.transformOrigin = 'top left';
+      board.style.transform = `scale(${SHEET_SCALE})`;
+    });
+
+    const rect = sheet.getBoundingClientRect();
+    finish({ ok: true, width: Math.round(rect.width), height: Math.round(rect.height) });
+  } catch (err) {
+    finish({ ok: false, error: String((err && err.message) || err) });
+  }
+}
+
+main();

package/dist/creative/styles.css

@@ -0,0 +1,314 @@
+/* styles.css — the single stylesheet a consumer needs: tokens.css + frame.css
+ * + every layouts/<name>/layout.css, concatenated in registry order so a
+ * layout can rely on frame.css cascading first. This file is generated by
+ * hand-concatenation (no build step); if you edit tokens.css, frame.css, or
+ * a layout.css, re-run the same concatenation (or copy the change into both
+ * the source file and here) and let test/registry.test.mjs catch drift on
+ * the individual files it checks. A consumer that only ever wants one board
+ * on the page can import this single file; components/layouts.js callers
+ * that want to import files individually still can (see README).
+ */
+
+/* ── from tokens.css ── */
+/* tokens.css — neutral fallback tokens for the creative artboard.
+ *
+ * This package renders no brand: every color and font here is a plain,
+ * unbranded default so a board with no brand tokens applied still renders
+ * something legible. The real values come from a workspace's Brand Kit,
+ * applied at render time as inline custom properties on the board's own root
+ * element (see render.js's applyBrandTokens / mount.js's mountBoard) — never
+ * written here and never on `:root`, so two different kits can render on the
+ * same page (e.g. two creatives side by side) without colliding.
+ *
+ * Scoped to .cc-board so it cannot collide with the host app's own styles.
+ * All custom properties are prefixed --cc- for the same reason.
+ */
+
+.cc-board {
+  --cc-accent: #6B7280;    /* neutral accent; a kit's `tokens.accent` overrides this */
+  --cc-accent-2: #4B5563;  /* a kit's `tokens.accent2` overrides this */
+
+  --cc-d-bg: #1C1C1E;      /* dark artboard background and scrim end stop */
+  --cc-d-ink: #FFFFFF;     /* headline on dark */
+
+  --cc-l-bg: #F2F2F7;      /* light artboard background */
+  --cc-l-card: #FFFFFF;    /* light-ground card/chip background */
+  --cc-ink: #222222;       /* headline on light */
+  --cc-ink-2: #717171;     /* body on light */
+
+  --cc-sky: #4AADDB;       /* safe-zone review guide only, never in an export */
+
+  --cc-elev-overlay: 0 8px 24px rgba(0,0,0,0.12);
+  --cc-elev-high: 0 8px 32px rgba(0,0,0,0.10);
+
+  --cc-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+}
+
+/* ── from frame.css ── */
+/* frame.css — the shared creative artboard rules: everything a layout does
+ * not own. Ratios and layouts are both data, not hardcoded here.
+ *
+ *   Placements (artboard sizes and per-placement numbers: lockup, body, cta,
+ *   card padding) live in placements.json / placements.js. render.js reads
+ *   them and sets CSS custom properties on the board (--cc-board-w,
+ *   --cc-lockup-gap, --cc-body-size, ...).
+ *
+ *   Layouts (structural families: stacked, bleed, card, split, and any added
+ *   later) live in layouts/<name>/layout.json + layout.css. This file keeps
+ *   only what every layout shares: the artboard, the lockup, the headline,
+ *   the body, the cta row, sequence anchoring, and the safe-zone review
+ *   guide.
+ *
+ * NOTHING structural here may be position:absolute. A PNG exporter that
+ * screenshots this DOM (the future render job) can drop absolutely
+ * positioned layers, so every photo and scrim stays in normal flow: photos
+ * are painted as background-image on the artboard or a band, scrims are
+ * background-image on the text panel.
+ *
+ * This file has no @import and no font-face: fonts are brand data (a kit's
+ * `fontUrl`), loaded by mount.js's loadFont(), never bundled here.
+ */
+
+/* ── Artboard ─────────────────────────────────────────────────────────────── */
+.cc-board {
+  position: relative;
+  overflow: hidden;
+  box-sizing: border-box;
+  font-family: var(--cc-font);
+  background-color: var(--cc-d-bg);
+  -webkit-font-smoothing: antialiased;
+  flex: none;
+  display: flex;
+  flex-direction: column;
+  width: var(--cc-board-w);
+  height: var(--cc-board-h);
+}
+.cc-board--light { background-color: var(--cc-l-bg); }
+
+.cc-board__panel {
+  position: relative; /* keeps the panel above the glow */
+  box-sizing: border-box;
+  display: flex; flex-direction: column; align-items: flex-start;
+}
+
+/* ── Sequence frames (stories and carousels) ──────────────────────────────── */
+/* Anchored to the bottom on every frame so the eye does not have to re-find the
+   copy between taps or swipes. The CTA appears only on the last frame. */
+.cc-board--seq .cc-lockup { position: absolute; top: var(--cc-safe-top, 48px); left: 88px; }
+
+/* ── Lockup ───────────────────────────────────────────────────────────────── */
+/* Renders only when the brand kit has a mark and/or a wordmark image; a kit
+   with neither renders no lockup at all (see render.js's buildLockup). */
+.cc-lockup { display: inline-flex; align-items: center; flex: none; align-self: flex-start; gap: var(--cc-lockup-gap); }
+.cc-lockup__icon { display: block; width: var(--cc-icon-size); height: var(--cc-icon-size); border-radius: var(--cc-icon-radius); }
+.cc-lockup__mark { display: block; height: var(--cc-mark-height); }
+.cc-lockup--spacer { visibility: hidden; }
+
+/* Chip variant: a white pill behind the lockup, for busy photography (ported
+   from nexus's schema.json `lockup: "chip"` / render.js). `--cc-l-card` and
+   `--cc-elev-overlay` are tokens.css's neutral light-ground surface and
+   shadow — brand-agnostic, so a white pill works over any brand's photo. */
+.cc-lockup--chip {
+  border-radius: 999px;
+  background: var(--cc-l-card);
+  box-shadow: var(--cc-elev-overlay);
+  padding: var(--cc-chip-pad);
+  gap: var(--cc-chip-gap);
+}
+.cc-lockup--chip .cc-lockup__icon {
+  width: var(--cc-chip-icon, var(--cc-icon-size));
+  height: var(--cc-chip-icon, var(--cc-icon-size));
+  border-radius: var(--cc-chip-icon-radius, var(--cc-icon-radius));
+}
+.cc-lockup--chip .cc-lockup__mark { height: var(--cc-chip-mark, var(--cc-mark-height)); }
+
+/* ── Headline ─────────────────────────────────────────────────────────────── */
+.cc-headline {
+  margin: 0;
+  font-size: var(--cc-h-size);
+  line-height: var(--cc-h-leading, 1.04);
+  font-weight: 800;
+  letter-spacing: var(--cc-h-track, -2.3px);
+  color: var(--cc-d-ink);
+  text-wrap: balance;
+}
+.cc-board--light .cc-headline { color: var(--cc-ink); }
+.cc-headline em { font-style: italic; color: var(--cc-accent); }
+
+/* ── Body ─────────────────────────────────────────────────────────────────── */
+.cc-body {
+  margin: 0;
+  font-weight: 500;
+  text-wrap: pretty;
+  font-size: var(--cc-body-size);
+  line-height: var(--cc-body-lh);
+  max-width: var(--cc-body-max-w);
+  color: var(--cc-body-color);
+}
+.cc-board--light .cc-body { font-size: var(--cc-light-body-size, var(--cc-body-size)); color: var(--cc-ink-2); }
+
+/* ── CTA row ──────────────────────────────────────────────────────────────── */
+/* Renders only when the kit has a badge image and/or a ctaClaim string; a kit
+   with neither renders no cta row at all (see render.js's buildCta). */
+.cc-cta { display: flex; align-items: center; flex-wrap: wrap; flex: none; gap: var(--cc-cta-gap); margin-top: var(--cc-cta-margin-top, 0); }
+
+/* The badge is brand artwork (a kit's `logos.badge`): sized by height only in
+   render.js, its own intrinsic aspect ratio preserved. Nothing here may
+   restyle it — no border, no border-radius, no filter, no shadow, no overlay —
+   since a store badge (Apple's, Google's, or a kit's own) typically comes with
+   guidelines against exactly that. */
+.cc-badge { display: block; flex: none; width: auto; }
+
+.cc-cta__note { font-weight: 600; font-size: var(--cc-note-size); color: var(--cc-note-color); }
+.cc-board--light .cc-cta__note { color: var(--cc-ink-2); }
+
+/* ── Safe zones (review guide only, never exported) ───────────────────────── */
+.cc-safe { position: absolute; inset: 0; pointer-events: none; }
+.cc-safe__top    { position: absolute; top: 0; left: 0; right: 0; height: var(--cc-safe-top);
+                   background: rgba(74,173,219,0.28); border-bottom: 2px dashed var(--cc-sky); }
+.cc-safe__bottom { position: absolute; bottom: 0; left: 0; right: 0; height: var(--cc-safe-bottom);
+                   background: rgba(74,173,219,0.28); border-top: 2px dashed var(--cc-sky); }
+.cc-safe__right  { position: absolute; bottom: var(--cc-safe-bottom); top: var(--cc-safe-top); right: 0;
+                   width: var(--cc-safe-right);
+                   background: rgba(74,173,219,0.20); border-left: 2px dashed var(--cc-sky); }
+
+/* ── from layouts/stacked/layout.css ── */
+/* stacked — photo band pinned top over a solid text panel. */
+
+.cc-board__band {
+  position: relative;
+  flex: 0 0 auto;
+  height: var(--cc-band-h);
+  overflow: hidden;
+  margin-bottom: -2px; /* hides a subpixel seam against the panel below */
+}
+.cc-board__band img {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 30%);
+}
+.cc-board__scrim {
+  position: absolute; left: 0; right: 0; bottom: 0; height: 220px;
+  background: linear-gradient(to top,
+    var(--cc-d-bg) 0%, var(--cc-d-bg) 18%,
+    rgba(28,28,30,0.75) 42%, rgba(28,28,30,0.25) 72%, rgba(28,28,30,0) 100%);
+}
+.cc-board__glow {
+  position: absolute; right: -200px; bottom: -260px;
+  width: 720px; height: 720px; border-radius: 50%;
+  background: radial-gradient(circle, color-mix(in srgb, var(--cc-accent) 13%, transparent), transparent 68%);
+  pointer-events: none;
+}
+
+.cc-board--stacked .cc-board__panel { flex: 1 1 auto; min-height: 0; }
+.cc-r-9x16.cc-board--stacked .cc-board__panel,
+.cc-r-story.cc-board--stacked .cc-board__panel {
+  padding: 88px 88px var(--cc-pad-b, var(--cc-safe-bottom, 430px));
+  justify-content: space-between;
+  gap: 26px;
+}
+.cc-r-4x5.cc-board--stacked .cc-board__panel {
+  padding: 0 88px 88px;
+  justify-content: center;
+  gap: 20px;
+}
+
+/* ── from layouts/bleed/layout.css ── */
+/* bleed — photo covers the whole artboard, text sits over a scrim. */
+
+.cc-board--bleed {
+  background-image: var(--cc-photo);
+  background-size: cover;
+  background-position: var(--cc-focal, 50% 50%);
+  justify-content: flex-end;
+}
+
+/* Fill variant (9x16, 4x5, story): the scrim covers the artboard and the
+   copy is distributed from top to bottom over it. */
+.cc-board__panel--fill {
+  flex: 1 1 auto;
+  height: 100%;
+  justify-content: space-between;
+}
+.cc-r-9x16 .cc-board__panel--fill,
+.cc-r-story .cc-board__panel--fill {
+  padding: 48px 88px var(--cc-safe-bottom, 430px);
+  background-image: linear-gradient(to top,
+    rgba(0,0,0,0.94) 0%, rgba(0,0,0,0.88) 42%,
+    rgba(0,0,0,0.68) 62%, rgba(0,0,0,0.34) 80%, rgba(0,0,0,0.55) 100%);
+}
+.cc-r-4x5 .cc-board__panel--fill {
+  padding: 48px 88px 96px;
+  background-image: linear-gradient(to top,
+    rgba(0,0,0,0.94) 0%, rgba(0,0,0,0.88) 48%,
+    rgba(0,0,0,0.62) 70%, rgba(0,0,0,0.30) 86%, rgba(0,0,0,0.50) 100%);
+}
+/* The chip's own padding already reads as a visual left inset over a full-bleed photo; nudge it back
+   flush with the panel's other content (ported from nexus's bleed layout.css). */
+.cc-board__panel--fill .cc-lockup--chip { margin-left: -40px; }
+
+/* Sequence frames (stories and carousels): anchored bottom so the eye does
+   not have to re-find the copy between taps or swipes. */
+.cc-board--seq .cc-board__panel--fill { justify-content: flex-end; gap: 28px; }
+.cc-board--story.cc-board--bleed .cc-board__panel--fill { padding-top: var(--cc-safe-top, 250px); }
+
+/* Bottom variant (every 1x1, forced via perPlacement). */
+.cc-board__panel--bottom {
+  flex: 0 0 auto;
+  padding: 220px 72px 48px;
+  gap: 14px;
+  background-image: linear-gradient(to top,
+    rgba(28,28,30,0.97) 0%, rgba(28,28,30,0.95) 42%,
+    rgba(28,28,30,0.74) 66%, rgba(28,28,30,0.26) 88%, rgba(28,28,30,0) 100%);
+}
+
+/* ── from layouts/card/layout.css ── */
+/* card — the light layout: inset rounded photo card on a light page. */
+
+.cc-board--card { padding: var(--cc-card-pad); gap: var(--cc-card-gap); }
+
+.cc-board__card {
+  position: relative;
+  width: 100%;
+  height: var(--cc-band-h);
+  flex: 0 0 auto;
+  border-radius: 24px;
+  overflow: hidden;
+  box-shadow: var(--cc-elev-high);
+}
+.cc-board__card img {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 40%);
+}
+.cc-board--card .cc-board__panel {
+  flex: 1 1 auto; min-height: 0;
+  justify-content: center;
+  gap: 28px;
+}
+
+/* ── from layouts/split/layout.css ── */
+/* split — photo on the top half, plain panel below, no scrim. Proves a fourth
+   layout needs only this folder plus an entry in layouts/index.json. */
+
+.cc-board--split .cc-board__band {
+  position: relative;
+  flex: 0 0 auto;
+  height: var(--cc-band-h);
+  overflow: hidden;
+}
+.cc-board--split .cc-board__band img {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 30%);
+}
+.cc-board--split .cc-board__panel {
+  flex: 1 1 auto; min-height: 0;
+  padding: 72px 88px;
+  justify-content: center;
+  gap: 24px;
+  background-color: var(--cc-d-bg);
+}

package/dist/creative/tokens.css

@@ -0,0 +1,33 @@
+/* tokens.css — neutral fallback tokens for the creative artboard.
+ *
+ * This package renders no brand: every color and font here is a plain,
+ * unbranded default so a board with no brand tokens applied still renders
+ * something legible. The real values come from a workspace's Brand Kit,
+ * applied at render time as inline custom properties on the board's own root
+ * element (see render.js's applyBrandTokens / mount.js's mountBoard) — never
+ * written here and never on `:root`, so two different kits can render on the
+ * same page (e.g. two creatives side by side) without colliding.
+ *
+ * Scoped to .cc-board so it cannot collide with the host app's own styles.
+ * All custom properties are prefixed --cc- for the same reason.
+ */
+
+.cc-board {
+  --cc-accent: #6B7280;    /* neutral accent; a kit's `tokens.accent` overrides this */
+  --cc-accent-2: #4B5563;  /* a kit's `tokens.accent2` overrides this */
+
+  --cc-d-bg: #1C1C1E;      /* dark artboard background and scrim end stop */
+  --cc-d-ink: #FFFFFF;     /* headline on dark */
+
+  --cc-l-bg: #F2F2F7;      /* light artboard background */
+  --cc-l-card: #FFFFFF;    /* light-ground card/chip background */
+  --cc-ink: #222222;       /* headline on light */
+  --cc-ink-2: #717171;     /* body on light */
+
+  --cc-sky: #4AADDB;       /* safe-zone review guide only, never in an export */
+
+  --cc-elev-overlay: 0 8px 24px rgba(0,0,0,0.12);
+  --cc-elev-high: 0 8px 32px rgba(0,0,0,0.10);
+
+  --cc-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+}

package/dist/index.js

@@ -14,6 +14,7 @@ import { registerConfig } from './commands/config.js';
 import { registerDashboard } from './commands/dashboard.js';
 import { registerStatus } from './commands/status.js';
 import { registerLint } from './commands/lint.js';
+import { registerCreative } from './commands/creative.js';
 const program = new Command();
 program
     .name('conductor')
@@ -30,5 +31,6 @@ registerConfig(program);
 registerDashboard(program);
 registerStatus(program);
 registerLint(program);
+registerCreative(program);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,WAAW,CAAC,OAAO,CAAC,CAAA;AACpB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AAErB,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,WAAW,CAAC,OAAO,CAAC,CAAA;AACpB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,gBAAgB,CAAC,OAAO,CAAC,CAAA;AAEzB,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/lib/creative-browser.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Finds a locally-installed browser to render Creatives with, using `playwright-core` (a dependency
+ * of this package, not the browser-bundling `playwright`). `conductor-creative/job/render.mjs`'s own
+ * CLI bootstrap depends on full `playwright` (it ships its own Chromium download) because it's meant
+ * to run inside a container built for that purpose; the CLI/MCP server run on a user's own machine,
+ * so they discover whatever Chromium-family browser is already there instead of bundling one — the
+ * same shape nexus-marketing's `rexipe-social` MCP server used.
+ *
+ * `playwright-core` itself is lazy-imported (see `findBrowserFactory`) so requiring it doesn't add
+ * to MCP server startup cost for sessions that never call a creative tool.
+ */
+import type { Browser } from 'playwright-core';
+export type BrowserFactory = () => Promise<Browser>;
+export declare const CHROME_INSTALL_HINT: string;
+/**
+ * Returns a factory that, when the render core first asks for a browser, launches the first one it can
+ * find in the order above. Launching is deferred to that call on purpose: `run()` fetches the spec before
+ * it asks for a browser, and a browser launched ahead of a spec fetch that then fails is never closed —
+ * it keeps the CLI process alive and leaks a Chrome process from the MCP server.
+ *
+ * The factory throws `CHROME_INSTALL_HINT` plus what each attempt failed with when nothing launches;
+ * `run()` catches that and reports it as the render's failure.
+ */
+export declare function findBrowserFactory(log?: (...args: unknown[]) => void): Promise<BrowserFactory>;
+//# sourceMappingURL=creative-browser.d.ts.map

package/dist/lib/creative-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-browser.d.ts","sourceRoot":"","sources":["../../src/lib/creative-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,iBAAiB,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnD,eAAO,MAAM,mBAAmB,QAI4C,CAAA;AAa5E;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAe9G"}

package/dist/lib/creative-browser.js

@@ -0,0 +1,36 @@
+export const CHROME_INSTALL_HINT = 'No installed browser could be launched for creative rendering. Try one of:\n' +
+    '  - Google Chrome (launched via Playwright channel "chrome")\n' +
+    '  - Microsoft Edge (launched via Playwright channel "msedge")\n' +
+    '  - a Playwright-managed Chromium: run `npx playwright install chromium`';
+const ATTEMPTS = [
+    { label: 'system Chrome (channel: chrome)', options: { channel: 'chrome' } },
+    { label: 'system Edge (channel: msedge)', options: { channel: 'msedge' } },
+    { label: 'Playwright-managed Chromium', options: {} },
+];
+/**
+ * Returns a factory that, when the render core first asks for a browser, launches the first one it can
+ * find in the order above. Launching is deferred to that call on purpose: `run()` fetches the spec before
+ * it asks for a browser, and a browser launched ahead of a spec fetch that then fails is never closed —
+ * it keeps the CLI process alive and leaks a Chrome process from the MCP server.
+ *
+ * The factory throws `CHROME_INSTALL_HINT` plus what each attempt failed with when nothing launches;
+ * `run()` catches that and reports it as the render's failure.
+ */
+export async function findBrowserFactory(log = () => { }) {
+    const { chromium } = await import('playwright-core');
+    return async () => {
+        const errors = [];
+        for (const attempt of ATTEMPTS) {
+            try {
+                const browser = await chromium.launch(attempt.options);
+                log(`using ${attempt.label}`);
+                return browser;
+            }
+            catch (err) {
+                errors.push(`${attempt.label}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        throw new Error(`${CHROME_INSTALL_HINT}\n\nTried:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    };
+}
+//# sourceMappingURL=creative-browser.js.map

package/dist/lib/creative-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-browser.js","sourceRoot":"","sources":["../../src/lib/creative-browser.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,mBAAmB,GAC9B,8EAA8E;IAC9E,gEAAgE;IAChE,iEAAiE;IACjE,0EAA0E,CAAA;AAO5E,MAAM,QAAQ,GAAc;IAC1B,EAAE,KAAK,EAAE,iCAAiC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAC5E,EAAE,KAAK,EAAE,+BAA+B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAC1E,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,EAAE,EAAE;CACtD,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoC,GAAG,EAAE,GAAE,CAAC;IACnF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;IACpD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBACtD,GAAG,CAAC,SAAS,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;gBAC7B,OAAO,OAAO,CAAA;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACtF,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,mBAAmB,eAAe,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClG,CAAC,CAAA;AACH,CAAC"}

package/dist/lib/creative-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creatives are shown to people by display id — "12a", "12b" — on the web page, in list_creatives and in
+ * the copyable "render this" commands, while the API addresses them by UUID. Tools and the CLI accept
+ * either and resolve a display id here, so a model or a person can pass what they were shown.
+ */
+import type { Config } from '../mcp/config.js';
+export declare function resolveCreativeId(idOrDisplayId: string, config: Config): Promise<string>;
+//# sourceMappingURL=creative-id.d.ts.map

package/dist/lib/creative-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-id.d.ts","sourceRoot":"","sources":["../../src/lib/creative-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAM9C,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9F"}

package/dist/lib/creative-id.js

@@ -0,0 +1,14 @@
+import { apiGet } from '../mcp/api.js';
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const DISPLAY_ID = /^\d+[a-z]$/i;
+export async function resolveCreativeId(idOrDisplayId, config) {
+    const value = idOrDisplayId.trim();
+    if (UUID.test(value) || !DISPLAY_ID.test(value))
+        return value;
+    const creatives = await apiGet(`/api/v2/projects/${config.projectId}/marketing/creatives`, config);
+    const match = creatives.find((c) => (c.displayId ?? '').toLowerCase() === value.toLowerCase());
+    if (!match)
+        throw new Error(`No Creative ${value} in this workspace — call list_creatives for the ids that exist.`);
+    return match.id;
+}
+//# sourceMappingURL=creative-id.js.map

package/dist/lib/creative-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-id.js","sourceRoot":"","sources":["../../src/lib/creative-id.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,MAAM,IAAI,GAAG,iEAAiE,CAAA;AAC9E,MAAM,UAAU,GAAG,aAAa,CAAA;AAEhC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,MAAc;IAC3E,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,SAAS,GAAG,MAAM,MAAM,CAC5B,oBAAoB,MAAM,CAAC,SAAS,sBAAsB,EAC1D,MAAM,CACP,CAAA;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,kEAAkE,CAAC,CAAA;IACnH,OAAO,KAAK,CAAC,EAAE,CAAA;AACjB,CAAC"}

package/dist/lib/creative-render.d.ts

@@ -0,0 +1,32 @@
+import type { Config } from '../mcp/config.js';
+export interface RenderFrame {
+    id?: string;
+    placementKey: string;
+    platform?: string;
+    sequenceIndex?: number | null;
+    url?: string;
+    width?: number;
+    height?: number;
+    sizeBytes?: number;
+    warnings?: string[];
+}
+export interface RenderCreativeParams {
+    creativeId: string;
+    previewOnly?: boolean;
+    renderer?: string;
+    workflowRunId?: string;
+}
+export interface RenderCreativeResult {
+    ok: boolean;
+    renderId?: string;
+    state?: string;
+    error?: string | null;
+    frames: RenderFrame[];
+}
+/**
+ * Renders a Creative end to end: finds a local browser, runs the render core against the external
+ * API, and reads back the stored render (frames with signed URLs, final state) whether or not the
+ * render itself succeeded — a FAILED render still has an id and an error message worth returning.
+ */
+export declare function renderCreative(params: RenderCreativeParams, config: Config, log?: (...args: unknown[]) => void): Promise<RenderCreativeResult>;
+//# sourceMappingURL=creative-render.d.ts.map

package/dist/lib/creative-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-render.d.ts","sourceRoot":"","sources":["../../src/lib/creative-render.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI9C,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAwDD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAe,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}