@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/chunk-5HYSKH77.js

@@ -0,0 +1,315 @@
+import {
+  asRecord
+} from "./chunk-KIGGMKAE.js";
+
+// src/viewer-profile.ts
+var VIEWER_TEMPERATURE_VALUES = ["cold", "warm", "hot"];
+var VIEWER_KNOWS_VALUES = ["brand", "offer", "product"];
+var VIEWER_SOURCE_VALUES = ["targeting", "knowledge"];
+var MARKETS = {
+  ES: {
+    name: "Spain",
+    names: /(?<![\p{L}\d])(spain|españa|espana)(?![\p{L}\d])/iu,
+    language: "es-ES",
+    languageName: "Spanish from Spain",
+    currency: "EUR",
+    address: "t\xFA"
+  },
+  MX: {
+    name: "Mexico",
+    names: /(?<![\p{L}\d])(mexico|méxico)(?![\p{L}\d])/iu,
+    language: "es-MX",
+    languageName: "Mexican Spanish",
+    currency: "MXN",
+    address: "t\xFA"
+  },
+  AR: {
+    name: "Argentina",
+    names: /(?<![\p{L}\d])(argentina)(?![\p{L}\d])/iu,
+    language: "es-AR",
+    languageName: "Argentinian Spanish",
+    currency: "ARS",
+    address: "vos"
+  },
+  CO: {
+    name: "Colombia",
+    names: /(?<![\p{L}\d])(colombia)(?![\p{L}\d])/iu,
+    language: "es-CO",
+    languageName: "Colombian Spanish",
+    currency: "COP",
+    address: "t\xFA"
+  },
+  CL: {
+    name: "Chile",
+    names: /(?<![\p{L}\d])(chile)(?![\p{L}\d])/iu,
+    language: "es-CL",
+    languageName: "Chilean Spanish",
+    currency: "CLP",
+    address: "t\xFA"
+  },
+  PE: {
+    name: "Peru",
+    names: /(?<![\p{L}\d])(peru|perú)(?![\p{L}\d])/iu,
+    language: "es-PE",
+    languageName: "Peruvian Spanish",
+    currency: "PEN",
+    address: "t\xFA"
+  },
+  BR: {
+    name: "Brazil",
+    names: /(?<![\p{L}\d])(brazil|brasil)(?![\p{L}\d])/iu,
+    language: "pt-BR",
+    languageName: "Brazilian Portuguese",
+    currency: "BRL",
+    address: "voc\xEA"
+  },
+  PT: {
+    name: "Portugal",
+    names: /(?<![\p{L}\d])(portugal)(?![\p{L}\d])/iu,
+    language: "pt-PT",
+    languageName: "European Portuguese",
+    currency: "EUR",
+    address: "tu"
+  },
+  GB: {
+    name: "the United Kingdom",
+    names: /(?<![\p{L}\d])(united kingdom|uk|britain|england)(?![\p{L}\d])/iu,
+    language: "en-GB",
+    languageName: "British English",
+    currency: "GBP",
+    address: "you"
+  },
+  IE: {
+    name: "Ireland",
+    names: /(?<![\p{L}\d])(ireland)(?![\p{L}\d])/iu,
+    language: "en-IE",
+    languageName: "Irish English",
+    currency: "EUR",
+    address: "you"
+  },
+  US: {
+    name: "the United States",
+    names: /(?<![\p{L}\d])(united states|usa|u\.s\.)(?![\p{L}\d])/iu,
+    language: "en-US",
+    languageName: "American English",
+    currency: "USD",
+    address: "you"
+  },
+  DE: {
+    name: "Germany",
+    names: /(?<![\p{L}\d])(germany|deutschland)(?![\p{L}\d])/iu,
+    language: "de-DE",
+    languageName: "German",
+    currency: "EUR",
+    address: "du"
+  },
+  FR: {
+    name: "France",
+    names: /(?<![\p{L}\d])(france)(?![\p{L}\d])/iu,
+    language: "fr-FR",
+    languageName: "French",
+    currency: "EUR",
+    address: "vous"
+  },
+  IT: {
+    name: "Italy",
+    names: /(?<![\p{L}\d])(italy|italia)(?![\p{L}\d])/iu,
+    language: "it-IT",
+    languageName: "Italian",
+    currency: "EUR",
+    address: "tu"
+  }
+};
+function marketOfCountries(countries) {
+  const codes = [...new Set(countries.map((c) => c.trim().toUpperCase()).filter(Boolean))];
+  if (codes.length === 0) return void 0;
+  if (codes.length > 1) return { country: "global" };
+  const code = codes[0];
+  const facts = MARKETS[code];
+  return facts ? { country: code, language: facts.language, currency: facts.currency, address: facts.address } : { country: code };
+}
+function marketFromCompanyDoc(doc) {
+  const line = (doc ?? "").split("\n").find(
+    (l) => /(?<![\p{L}\d])(markets?|geo|geograph\w*|country|countries|país|paises|países|mercados?)(?![\p{L}\d])/iu.test(l)
+  );
+  if (!line) return void 0;
+  const found = Object.entries(MARKETS).filter(([, facts]) => facts.names.test(line)).map(([code]) => code);
+  return marketOfCountries(found);
+}
+function describeMarket(market) {
+  if (market.country === "global") return "a person in any of the countries the ad runs in";
+  const facts = MARKETS[market.country];
+  const where = facts?.name ?? market.country;
+  const language = facts && market.language === facts.language ? facts.languageName : market.language;
+  return [
+    `a person living in ${where}`,
+    language ? ` who reads ${language} natively` : "",
+    market.currency ? `, pays in ${market.currency}` : "",
+    market.address ? ` and is spoken to as ${market.address}` : ""
+  ].join("");
+}
+function marketCountryName(market) {
+  return market.country === "global" ? null : MARKETS[market.country]?.name ?? market.country;
+}
+function text(value) {
+  return typeof value === "string" ? value : "";
+}
+function audienceRefs(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const ref = asRecord(entry);
+    const id = text(ref?.id);
+    return id ? [{ id, name: text(ref?.name) }] : [];
+  });
+}
+var COLD = { temperature: "cold", knows: [] };
+function tierOf(audience, ref, readName) {
+  const subtype = text(audience?.subtype).toUpperCase();
+  const name = text(audience?.name) || ref.name;
+  const read = readName?.(name);
+  if (subtype === "LOOKALIKE" || !subtype && read?.lookalike) {
+    return { ...COLD, who: "a lookalike: strangers who resemble the seed" };
+  }
+  if (read?.buyers) return { temperature: "hot", knows: ["brand", "offer", "product"], who: "buyers" };
+  if (subtype === "WEBSITE") return { temperature: "warm", knows: ["brand", "offer"], who: "site visitors" };
+  if (subtype === "CUSTOM") {
+    return { temperature: "hot", knows: ["brand", "offer", "product"], who: "an uploaded customer list" };
+  }
+  return { temperature: "warm", knows: ["brand"], who: "people who engaged with the brand" };
+}
+function classifyAudience(adSet, audiences, campaign, readName) {
+  const targeting = asRecord(adSet.targeting) ?? {};
+  const byId = new Map(audiences.map((audience) => [text(audience.id), audience]));
+  const includedRefs = audienceRefs(targeting.custom_audiences);
+  const included = includedRefs.map((ref) => tierOf(byId.get(ref.id), ref, readName));
+  const reasons = [
+    includedRefs.length === 0 ? "No custom audience: Meta finds new people from age, place and interests, so every viewer is a stranger." : `Reaches ${includedRefs.map((ref, i) => `"${ref.name || ref.id}" (${included[i]?.who})`).join(", ")}.`
+  ];
+  const unlisted = includedRefs.filter((ref) => !byId.has(ref.id));
+  if (unlisted.length > 0) {
+    reasons.push(`${quoteNames(unlisted)} is not in this account's audience list, so it was read from its name alone.`);
+  }
+  let reached = coldestOf(included);
+  if (asRecord(targeting.targeting_automation)?.advantage_audience === 1 && included.length > 0) {
+    reached = belowHot(reached);
+    reasons.push(
+      "Advantage+ audience treats the chosen audiences as suggestions and reaches past them, so part of the delivery goes to people who have never bought."
+    );
+  }
+  const excludedRefs = audienceRefs(targeting.excluded_custom_audiences);
+  if (excludedRefs.length > 0) reasons.push(`Keeps out ${quoteNames(excludedRefs)}.`);
+  if (excludedRefs.some((ref) => tierOf(byId.get(ref.id), ref, readName).temperature === "hot")) {
+    reached = belowHot(reached);
+    reasons.push("Buyers are excluded, so nobody reached has used the product.");
+  }
+  const objective = text(campaign?.objective);
+  if (reached.temperature === "cold" && ASKS_TO_ACT.test(objective)) {
+    reasons.push(
+      `Campaign objective ${objective} asks a stranger to act on first contact, so the ad alone must say what is offered and to whom.`
+    );
+  }
+  const countries = strings(asRecord(targeting.geo_locations)?.countries);
+  const market = marketOfCountries(countries);
+  if (market?.country === "global") {
+    reasons.push(
+      `Runs in ${countries.join(", ")}: one version for every market, with no country's places, money or faces.`
+    );
+  }
+  const placements = placementsOf(targeting);
+  if (placements.length === 0) {
+    reasons.push(
+      "Advantage+ placements: Meta picks the surface, so the ad must also work full-screen in Stories and Reels, not only in the feed."
+    );
+  }
+  return {
+    temperature: reached.temperature,
+    knows: reached.knows,
+    placements: placements.length > 0 ? placements : ["automatic"],
+    source: "targeting",
+    reasons,
+    ...market ? { market } : {}
+  };
+}
+var ASKS_TO_ACT = /^(OUTCOME_SALES|OUTCOME_LEADS|OUTCOME_APP_PROMOTION|CONVERSIONS|LEAD_GENERATION|PRODUCT_CATALOG_SALES)$/;
+function strings(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function placementsOf(targeting) {
+  return strings(targeting.publisher_platforms).flatMap((platform) => {
+    const positions = strings(targeting[`${platform}_positions`]);
+    if (positions.length === 0) return [platform];
+    return positions.map((position) => {
+      const surface = platform === "instagram" && position === "stream" ? "feed" : position;
+      return surface.startsWith(`${platform}_`) ? surface : `${platform}_${surface}`;
+    });
+  });
+}
+function quoteNames(refs) {
+  return refs.map((ref) => `"${ref.name || ref.id}"`).join(", ");
+}
+function belowHot(tier) {
+  if (tier.temperature !== "hot") return tier;
+  return { temperature: "warm", knows: tier.knows.filter((known) => known !== "product") };
+}
+var WARMTH = { cold: 0, warm: 1, hot: 2 };
+function coldestOf(tiers) {
+  const [first, ...rest] = tiers;
+  if (!first) return COLD;
+  return rest.reduce(
+    (acc, tier) => ({
+      temperature: WARMTH[tier.temperature] < WARMTH[acc.temperature] ? tier.temperature : acc.temperature,
+      knows: acc.knows.filter((known) => tier.knows.includes(known))
+    }),
+    first
+  );
+}
+var AWARENESS_VALUES = ["unaware", "problem_aware", "solution_aware", "product_aware", "most_aware"];
+var BY_AWARENESS = {
+  unaware: COLD,
+  problem_aware: COLD,
+  solution_aware: COLD,
+  product_aware: { temperature: "warm", knows: ["brand", "offer"] },
+  most_aware: { temperature: "hot", knows: ["brand", "offer", "product"] }
+};
+var CUSTOMER_SEGMENT = /\b(existing|current|past|former|returning|repeat)\s+(customers?|clients?|buyers?|members?|subscribers?|users?)\b|\bclientes\s+(actuales|existentes)\b|\bantiguos\s+clientes\b/i;
+var CONTACT_SEGMENT = /\b(leads?|prospects?)\s+(who|that)\b|\b(site|website|web)\s+visitors\b|\babandon(ed|s)?\s+(carts?|checkouts?|forms?)\b|\btrial\s+users\b|\bvisitantes\b/i;
+function tierOfSegment(segment) {
+  if (CUSTOMER_SEGMENT.test(segment)) return { temperature: "hot", knows: ["brand", "offer", "product"] };
+  if (CONTACT_SEGMENT.test(segment)) return { temperature: "warm", knows: ["brand", "offer"] };
+  return void 0;
+}
+function viewerFromKnowledge(input) {
+  const reasons = ["No ad set to read, so this viewer comes from the Knowledge and the brief, not from targeting."];
+  let tier = COLD;
+  if (input.awareness) {
+    tier = BY_AWARENESS[input.awareness];
+    reasons.push(`The concept is written for a ${input.awareness.replace("_", "-")} viewer.`);
+  } else {
+    const warmed = input.personas.flatMap((segment) => {
+      const read = tierOfSegment(segment);
+      return read ? [{ segment, read }] : [];
+    });
+    if (warmed.length > 0 && warmed.length === input.personas.length) {
+      tier = coldestOf(warmed.map((entry) => entry.read));
+      reasons.push(
+        `The persona is defined by what they already did with the brand: ${warmed.map((entry) => `"${entry.segment}"`).join(", ")}.`
+      );
+    } else {
+      reasons.push("Nothing on file says the viewer knows the brand: design for a stranger.");
+    }
+  }
+  return { temperature: tier.temperature, knows: tier.knows, placements: ["automatic"], source: "knowledge", reasons };
+}
+
+export {
+  VIEWER_TEMPERATURE_VALUES,
+  VIEWER_KNOWS_VALUES,
+  VIEWER_SOURCE_VALUES,
+  marketFromCompanyDoc,
+  describeMarket,
+  marketCountryName,
+  classifyAudience,
+  AWARENESS_VALUES,
+  viewerFromKnowledge
+};
+//# sourceMappingURL=chunk-5HYSKH77.js.map

package/dist/chunk-5HYSKH77.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/viewer-profile.ts"],"sourcesContent":["import { asRecord } from \"./commands/ads/list-rows.ts\";\n\n/**\n * Who will see an ad, read off what the ad set actually targets rather than what\n * anyone hopes it targets — or, with no ad set, off the Knowledge and the brief.\n * `baker ads meta adsets --audience` prints it; a creative records it in its\n * `_definition.md` (`viewer`), and the viewer check plays it.\n */\n\nexport const VIEWER_TEMPERATURE_VALUES = [\"cold\", \"warm\", \"hot\"] as const;\nexport const VIEWER_KNOWS_VALUES = [\"brand\", \"offer\", \"product\"] as const;\nexport const VIEWER_SOURCE_VALUES = [\"targeting\", \"knowledge\"] as const;\n\nexport type ViewerTemperature = (typeof VIEWER_TEMPERATURE_VALUES)[number];\nexport type ViewerKnows = (typeof VIEWER_KNOWS_VALUES)[number];\n\n/**\n * Where the viewer lives and how they are spoken to (D1): the country (`global` for a version\n * that runs in several), the language variant, the currency and the form of address.\n */\nexport interface ViewerMarket {\n  country: string;\n  language?: string;\n  currency?: string;\n  address?: string;\n}\n\nexport interface ViewerProfile {\n  temperature: ViewerTemperature;\n  knows: ViewerKnows[];\n  placements: string[];\n  source: (typeof VIEWER_SOURCE_VALUES)[number];\n  reasons: string[];\n  /** Where they live: read off the ad set's countries, else COMPANY.md. */\n  market?: ViewerMarket;\n}\n\ntype MarketFacts = {\n  name: string;\n  names: RegExp;\n  language: string;\n  languageName: string;\n  currency: string;\n  address: string;\n};\n\n/** The markets our ads run in, with how an ad speaks there. A country not listed keeps its code alone. */\nconst MARKETS: Readonly<Record<string, MarketFacts>> = {\n  ES: {\n    name: \"Spain\",\n    names: /(?<![\\p{L}\\d])(spain|españa|espana)(?![\\p{L}\\d])/iu,\n    language: \"es-ES\",\n    languageName: \"Spanish from Spain\",\n    currency: \"EUR\",\n    address: \"tú\",\n  },\n  MX: {\n    name: \"Mexico\",\n    names: /(?<![\\p{L}\\d])(mexico|méxico)(?![\\p{L}\\d])/iu,\n    language: \"es-MX\",\n    languageName: \"Mexican Spanish\",\n    currency: \"MXN\",\n    address: \"tú\",\n  },\n  AR: {\n    name: \"Argentina\",\n    names: /(?<![\\p{L}\\d])(argentina)(?![\\p{L}\\d])/iu,\n    language: \"es-AR\",\n    languageName: \"Argentinian Spanish\",\n    currency: \"ARS\",\n    address: \"vos\",\n  },\n  CO: {\n    name: \"Colombia\",\n    names: /(?<![\\p{L}\\d])(colombia)(?![\\p{L}\\d])/iu,\n    language: \"es-CO\",\n    languageName: \"Colombian Spanish\",\n    currency: \"COP\",\n    address: \"tú\",\n  },\n  CL: {\n    name: \"Chile\",\n    names: /(?<![\\p{L}\\d])(chile)(?![\\p{L}\\d])/iu,\n    language: \"es-CL\",\n    languageName: \"Chilean Spanish\",\n    currency: \"CLP\",\n    address: \"tú\",\n  },\n  PE: {\n    name: \"Peru\",\n    names: /(?<![\\p{L}\\d])(peru|perú)(?![\\p{L}\\d])/iu,\n    language: \"es-PE\",\n    languageName: \"Peruvian Spanish\",\n    currency: \"PEN\",\n    address: \"tú\",\n  },\n  BR: {\n    name: \"Brazil\",\n    names: /(?<![\\p{L}\\d])(brazil|brasil)(?![\\p{L}\\d])/iu,\n    language: \"pt-BR\",\n    languageName: \"Brazilian Portuguese\",\n    currency: \"BRL\",\n    address: \"você\",\n  },\n  PT: {\n    name: \"Portugal\",\n    names: /(?<![\\p{L}\\d])(portugal)(?![\\p{L}\\d])/iu,\n    language: \"pt-PT\",\n    languageName: \"European Portuguese\",\n    currency: \"EUR\",\n    address: \"tu\",\n  },\n  GB: {\n    name: \"the United Kingdom\",\n    names: /(?<![\\p{L}\\d])(united kingdom|uk|britain|england)(?![\\p{L}\\d])/iu,\n    language: \"en-GB\",\n    languageName: \"British English\",\n    currency: \"GBP\",\n    address: \"you\",\n  },\n  IE: {\n    name: \"Ireland\",\n    names: /(?<![\\p{L}\\d])(ireland)(?![\\p{L}\\d])/iu,\n    language: \"en-IE\",\n    languageName: \"Irish English\",\n    currency: \"EUR\",\n    address: \"you\",\n  },\n  US: {\n    name: \"the United States\",\n    names: /(?<![\\p{L}\\d])(united states|usa|u\\.s\\.)(?![\\p{L}\\d])/iu,\n    language: \"en-US\",\n    languageName: \"American English\",\n    currency: \"USD\",\n    address: \"you\",\n  },\n  DE: {\n    name: \"Germany\",\n    names: /(?<![\\p{L}\\d])(germany|deutschland)(?![\\p{L}\\d])/iu,\n    language: \"de-DE\",\n    languageName: \"German\",\n    currency: \"EUR\",\n    address: \"du\",\n  },\n  FR: {\n    name: \"France\",\n    names: /(?<![\\p{L}\\d])(france)(?![\\p{L}\\d])/iu,\n    language: \"fr-FR\",\n    languageName: \"French\",\n    currency: \"EUR\",\n    address: \"vous\",\n  },\n  IT: {\n    name: \"Italy\",\n    names: /(?<![\\p{L}\\d])(italy|italia)(?![\\p{L}\\d])/iu,\n    language: \"it-IT\",\n    languageName: \"Italian\",\n    currency: \"EUR\",\n    address: \"tu\",\n  },\n};\n\n/**\n * The market an ad set's countries make: one country is its own market; several are one global\n * version in the campaign's language, with market-neutral people, places and money. Pure.\n */\nexport function marketOfCountries(countries: readonly string[]): ViewerMarket | undefined {\n  const codes = [...new Set(countries.map((c) => c.trim().toUpperCase()).filter(Boolean))];\n  if (codes.length === 0) return undefined;\n  if (codes.length > 1) return { country: \"global\" };\n  const code = codes[0] as string;\n  const facts = MARKETS[code];\n  return facts\n    ? { country: code, language: facts.language, currency: facts.currency, address: facts.address }\n    : { country: code };\n}\n\n/** The market COMPANY.md names on its market or geography line, when it names one. Pure. */\nexport function marketFromCompanyDoc(doc: string | null | undefined): ViewerMarket | undefined {\n  const line = (doc ?? \"\")\n    .split(\"\\n\")\n    .find((l) =>\n      /(?<![\\p{L}\\d])(markets?|geo|geograph\\w*|country|countries|país|paises|países|mercados?)(?![\\p{L}\\d])/iu.test(l),\n    );\n  if (!line) return undefined;\n  const found = Object.entries(MARKETS)\n    .filter(([, facts]) => facts.names.test(line))\n    .map(([code]) => code);\n  return marketOfCountries(found);\n}\n\n/** The market in the viewer's own terms, for a model that plays them. Pure. */\nexport function describeMarket(market: ViewerMarket): string {\n  if (market.country === \"global\") return \"a person in any of the countries the ad runs in\";\n  const facts = MARKETS[market.country];\n  const where = facts?.name ?? market.country;\n  const language = facts && market.language === facts.language ? facts.languageName : market.language;\n  return [\n    `a person living in ${where}`,\n    language ? ` who reads ${language} natively` : \"\",\n    market.currency ? `, pays in ${market.currency}` : \"\",\n    market.address ? ` and is spoken to as ${market.address}` : \"\",\n  ].join(\"\");\n}\n\n/** The country a market names, in words (\"Mexico\"); null for a global version. */\nexport function marketCountryName(market: ViewerMarket): string | null {\n  return market.country === \"global\" ? null : (MARKETS[market.country]?.name ?? market.country);\n}\n\nexport interface AdSetTargetingInput {\n  targeting?: unknown;\n}\n\nexport interface CustomAudienceInput {\n  id?: unknown;\n  name?: unknown;\n  subtype?: unknown;\n}\n\nexport interface CampaignInput {\n  objective?: unknown;\n}\n\nfunction text(value: unknown): string {\n  return typeof value === \"string\" ? value : \"\";\n}\n\n/** The `{ id, name }` entries of a targeting list such as `custom_audiences`. */\nfunction audienceRefs(value: unknown): Array<{ id: string; name: string }> {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const ref = asRecord(entry);\n    const id = text(ref?.id);\n    return id ? [{ id, name: text(ref?.name) }] : [];\n  });\n}\n\n/** What one custom audience's members have already been through with the brand. */\ninterface AudienceTier {\n  temperature: ViewerTemperature;\n  knows: ViewerKnows[];\n}\n\ninterface AudienceRead extends AudienceTier {\n  /** Who its members are, in the words a reason prints. */\n  who: string;\n}\n\n/**\n * What an audience's NAME says its members are, as the decision model read it in the advertiser's\n * own language (`audience-names.ts`). A pixel or event audience's subtype says where its members\n * came from, not what they did: \"Purchasers 180d\" and \"All visitors 30d\" are both WEBSITE, and\n * the name is the one place an account records the event. Undefined when the name was not read.\n */\nexport type AudienceNameReading = (name: string) => { buyers: boolean; lookalike: boolean } | undefined;\n\nconst COLD: AudienceTier = { temperature: \"cold\", knows: [] };\n\nfunction tierOf(\n  audience: CustomAudienceInput | undefined,\n  ref: { name: string },\n  readName: AudienceNameReading | undefined,\n): AudienceRead {\n  const subtype = text(audience?.subtype).toUpperCase();\n  const name = text(audience?.name) || ref.name;\n  const read = readName?.(name);\n  // Meta names a lookalike after its seed (\"Lookalike (GB, 1%) - Purchasers\"), so it is ruled out before the name is read.\n  if (subtype === \"LOOKALIKE\" || (!subtype && read?.lookalike)) {\n    return { ...COLD, who: \"a lookalike: strangers who resemble the seed\" };\n  }\n  if (read?.buyers) return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"], who: \"buyers\" };\n  if (subtype === \"WEBSITE\") return { temperature: \"warm\", knows: [\"brand\", \"offer\"], who: \"site visitors\" };\n  if (subtype === \"CUSTOM\") {\n    return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"], who: \"an uploaded customer list\" };\n  }\n  // Every other custom audience is people who met the brand somewhere: a Page, a profile, a video, the app.\n  return { temperature: \"warm\", knows: [\"brand\"], who: \"people who engaged with the brand\" };\n}\n\nexport function classifyAudience(\n  adSet: AdSetTargetingInput,\n  audiences: readonly CustomAudienceInput[],\n  campaign: CampaignInput | undefined,\n  readName?: AudienceNameReading,\n): ViewerProfile {\n  const targeting = asRecord(adSet.targeting) ?? {};\n  const byId = new Map(audiences.map((audience) => [text(audience.id), audience]));\n  const includedRefs = audienceRefs(targeting.custom_audiences);\n  const included = includedRefs.map((ref) => tierOf(byId.get(ref.id), ref, readName));\n  const reasons: string[] = [\n    includedRefs.length === 0\n      ? \"No custom audience: Meta finds new people from age, place and interests, so every viewer is a stranger.\"\n      : `Reaches ${includedRefs.map((ref, i) => `\"${ref.name || ref.id}\" (${included[i]?.who})`).join(\", \")}.`,\n  ];\n  const unlisted = includedRefs.filter((ref) => !byId.has(ref.id));\n  if (unlisted.length > 0) {\n    reasons.push(`${quoteNames(unlisted)} is not in this account's audience list, so it was read from its name alone.`);\n  }\n  let reached = coldestOf(included);\n  if (asRecord(targeting.targeting_automation)?.advantage_audience === 1 && included.length > 0) {\n    reached = belowHot(reached);\n    reasons.push(\n      \"Advantage+ audience treats the chosen audiences as suggestions and reaches past them, so part of the delivery goes to people who have never bought.\",\n    );\n  }\n  const excludedRefs = audienceRefs(targeting.excluded_custom_audiences);\n  if (excludedRefs.length > 0) reasons.push(`Keeps out ${quoteNames(excludedRefs)}.`);\n  if (excludedRefs.some((ref) => tierOf(byId.get(ref.id), ref, readName).temperature === \"hot\")) {\n    reached = belowHot(reached);\n    reasons.push(\"Buyers are excluded, so nobody reached has used the product.\");\n  }\n  const objective = text(campaign?.objective);\n  if (reached.temperature === \"cold\" && ASKS_TO_ACT.test(objective)) {\n    reasons.push(\n      `Campaign objective ${objective} asks a stranger to act on first contact, so the ad alone must say what is offered and to whom.`,\n    );\n  }\n  const countries = strings(asRecord(targeting.geo_locations)?.countries);\n  const market = marketOfCountries(countries);\n  if (market?.country === \"global\") {\n    reasons.push(\n      `Runs in ${countries.join(\", \")}: one version for every market, with no country's places, money or faces.`,\n    );\n  }\n  const placements = placementsOf(targeting);\n  if (placements.length === 0) {\n    reasons.push(\n      \"Advantage+ placements: Meta picks the surface, so the ad must also work full-screen in Stories and Reels, not only in the feed.\",\n    );\n  }\n  return {\n    temperature: reached.temperature,\n    knows: reached.knows,\n    placements: placements.length > 0 ? placements : [\"automatic\"],\n    source: \"targeting\",\n    reasons,\n    ...(market ? { market } : {}),\n  };\n}\n\n/**\n * The objective says what the campaign wants from a viewer, never who the viewer is:\n * a conversion campaign on broad targeting still meets strangers. So it adds a reason\n * and never moves the temperature.\n */\nconst ASKS_TO_ACT =\n  /^(OUTCOME_SALES|OUTCOME_LEADS|OUTCOME_APP_PROMOTION|CONVERSIONS|LEAD_GENERATION|PRODUCT_CATALOG_SALES)$/;\n\nfunction strings(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * `instagram_positions` calls the feed `stream` and Facebook's Reels are already\n * `facebook_reels`; one `<platform>_<surface>` spelling reads the same for both.\n */\nfunction placementsOf(targeting: Record<string, unknown>): string[] {\n  return strings(targeting.publisher_platforms).flatMap((platform) => {\n    const positions = strings(targeting[`${platform}_positions`]);\n    // A platform with no positions of its own is every surface on it.\n    if (positions.length === 0) return [platform];\n    return positions.map((position) => {\n      const surface = platform === \"instagram\" && position === \"stream\" ? \"feed\" : position;\n      return surface.startsWith(`${platform}_`) ? surface : `${platform}_${surface}`;\n    });\n  });\n}\n\nfunction quoteNames(refs: ReadonlyArray<{ id: string; name: string }>): string {\n  return refs.map((ref) => `\"${ref.name || ref.id}\"`).join(\", \");\n}\n\n/** Only buyers know the product itself; anyone short of that knows at most the brand and its offer. */\nfunction belowHot(tier: AudienceTier): AudienceTier {\n  if (tier.temperature !== \"hot\") return tier;\n  return { temperature: \"warm\", knows: tier.knows.filter((known) => known !== \"product\") };\n}\n\nconst WARMTH: Record<ViewerTemperature, number> = { cold: 0, warm: 1, hot: 2 };\n\n/**\n * Meta delivers to anyone in ANY included audience, so the ad has to work on the\n * coldest of them, and it can only lean on what every one of them already knows.\n */\nfunction coldestOf(tiers: readonly AudienceTier[]): AudienceTier {\n  const [first, ...rest] = tiers;\n  if (!first) return COLD;\n  return rest.reduce<AudienceTier>(\n    (acc, tier) => ({\n      temperature: WARMTH[tier.temperature] < WARMTH[acc.temperature] ? tier.temperature : acc.temperature,\n      knows: acc.knows.filter((known) => tier.knows.includes(known)),\n    }),\n    first,\n  );\n}\n\n/** The awareness stages a creative's `awareness` field takes (the scaffold `creatives` collection). */\nexport const AWARENESS_VALUES = [\"unaware\", \"problem_aware\", \"solution_aware\", \"product_aware\", \"most_aware\"] as const;\n\nexport type Awareness = (typeof AWARENESS_VALUES)[number];\n\n/** Until a viewer is aware of the product, they know nothing of the brand behind it either. */\nconst BY_AWARENESS: Record<Awareness, AudienceTier> = {\n  unaware: COLD,\n  problem_aware: COLD,\n  solution_aware: COLD,\n  product_aware: { temperature: \"warm\", knows: [\"brand\", \"offer\"] },\n  most_aware: { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"] },\n};\n\n/**\n * A persona segment says what the viewer already did with the brand only when it is\n * defined by it (\"Existing customers up for renewal\", \"Leads who went quiet\"). Phrases,\n * not words: \"Marketing leads at SaaS firms\" are job titles, not leads.\n */\nconst CUSTOMER_SEGMENT =\n  /\\b(existing|current|past|former|returning|repeat)\\s+(customers?|clients?|buyers?|members?|subscribers?|users?)\\b|\\bclientes\\s+(actuales|existentes)\\b|\\bantiguos\\s+clientes\\b/i;\nconst CONTACT_SEGMENT =\n  /\\b(leads?|prospects?)\\s+(who|that)\\b|\\b(site|website|web)\\s+visitors\\b|\\babandon(ed|s)?\\s+(carts?|checkouts?|forms?)\\b|\\btrial\\s+users\\b|\\bvisitantes\\b/i;\n\nfunction tierOfSegment(segment: string): AudienceTier | undefined {\n  if (CUSTOMER_SEGMENT.test(segment)) return { temperature: \"hot\", knows: [\"brand\", \"offer\", \"product\"] };\n  if (CONTACT_SEGMENT.test(segment)) return { temperature: \"warm\", knows: [\"brand\", \"offer\"] };\n  return undefined;\n}\n\nexport interface KnowledgeViewerInput {\n  /** The segment line (frontmatter `segment`, else the title) of each persona the ad is for. */\n  personas: readonly string[];\n  /** The awareness stage the concept was written for, when the brief set one. */\n  awareness?: Awareness;\n}\n\n/**\n * The viewer when there is no ad set to read. The Knowledge describes who a persona\n * is, almost never what they already know about the brand, so the stranger is the\n * default and only an explicit signal warms it.\n */\nexport function viewerFromKnowledge(input: KnowledgeViewerInput): ViewerProfile {\n  const reasons = [\"No ad set to read, so this viewer comes from the Knowledge and the brief, not from targeting.\"];\n  let tier = COLD;\n  if (input.awareness) {\n    tier = BY_AWARENESS[input.awareness];\n    reasons.push(`The concept is written for a ${input.awareness.replace(\"_\", \"-\")} viewer.`);\n  } else {\n    const warmed = input.personas.flatMap((segment) => {\n      const read = tierOfSegment(segment);\n      return read ? [{ segment, read }] : [];\n    });\n    if (warmed.length > 0 && warmed.length === input.personas.length) {\n      tier = coldestOf(warmed.map((entry) => entry.read));\n      reasons.push(\n        `The persona is defined by what they already did with the brand: ${warmed.map((entry) => `\"${entry.segment}\"`).join(\", \")}.`,\n      );\n    } else {\n      reasons.push(\"Nothing on file says the viewer knows the brand: design for a stranger.\");\n    }\n  }\n  return { temperature: tier.temperature, knows: tier.knows, placements: [\"automatic\"], source: \"knowledge\", reasons };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-5MBPIONY.js

@@ -0,0 +1,29 @@
+// src/commands/canvas/composition-dims.ts
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+function patchCompositionMeta(metaJson, dims) {
+  try {
+    const meta = JSON.parse(metaJson);
+    if (!meta || typeof meta !== "object" || Array.isArray(meta)) return metaJson;
+    return `${JSON.stringify({ ...meta, width: dims.w, height: dims.h }, null, 2)}
+`;
+  } catch {
+    return metaJson;
+  }
+}
+function patchCompositionHtml(html, dims) {
+  return html.replace(/(<meta\s+name="viewport"\s+content="width=)\d+(,\s*height=)\d+(")/i, `$1${dims.w}$2${dims.h}$3`).replace(/(width:\s*)\d+(px;\s*height:\s*)\d+(px;)/i, `$1${dims.w}$2${dims.h}$3`).replace(/(data-width=")\d+(")/i, `$1${dims.w}$2`).replace(/(data-height=")\d+(")/i, `$1${dims.h}$2`);
+}
+async function stampCompositionDims(compositionDir, dims) {
+  const metaPath = path.join(compositionDir, "meta.json");
+  const rawMeta = await readFile(metaPath, "utf8");
+  await writeFile(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
+  const htmlPath = path.join(compositionDir, "index.html");
+  const rawHtml = await readFile(htmlPath, "utf8");
+  await writeFile(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
+}
+
+export {
+  stampCompositionDims
+};
+//# sourceMappingURL=chunk-5MBPIONY.js.map

package/dist/chunk-5MBPIONY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/composition-dims.ts"],"sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * Sizing a staged composition to the ad's output frame.\n *\n * The shipped compositions hardcode 1080x1920 (9:16). Both video scaffolders copy them\n * beside the canvas, and a 4:5 or 1:1 ad must render its overlay and caption layers at\n * its own dims or the composite lays them out against a frame that does not match.\n */\n\n/**\n * Stamp the output canvas dims onto a staged composition's meta.json. Non-JSON input\n * passes through untouched (the copy stays usable; validation surfaces the real problem).\n */\nexport function patchCompositionMeta(metaJson: string, dims: { w: number; h: number }): string {\n  try {\n    const meta = JSON.parse(metaJson) as Record<string, unknown>;\n    if (!meta || typeof meta !== \"object\" || Array.isArray(meta)) return metaJson;\n    return `${JSON.stringify({ ...meta, width: dims.w, height: dims.h }, null, 2)}\\n`;\n  } catch {\n    return metaJson;\n  }\n}\n\n/**\n * Rewrite a staged composition's `index.html` hardcoded 1080x1920 dimension declarations\n * (viewport meta, the html/body CSS rule, and #root's data-width/data-height) to the output\n * canvas dims. `meta.json`'s width/height is what actually sizes the Hyperframes render\n * capture, but the DOM inside is laid out against these SAME literals; leaving them at\n * 1920 while the capture is cropped to e.g. 1350 clips/misplaces every absolutely-positioned\n * element (captions, overlays) against a canvas that no longer matches. No match: untouched.\n */\nexport function patchCompositionHtml(html: string, dims: { w: number; h: number }): string {\n  return html\n    .replace(/(<meta\\s+name=\"viewport\"\\s+content=\"width=)\\d+(,\\s*height=)\\d+(\")/i, `$1${dims.w}$2${dims.h}$3`)\n    .replace(/(width:\\s*)\\d+(px;\\s*height:\\s*)\\d+(px;)/i, `$1${dims.w}$2${dims.h}$3`)\n    .replace(/(data-width=\")\\d+(\")/i, `$1${dims.w}$2`)\n    .replace(/(data-height=\")\\d+(\")/i, `$1${dims.h}$2`);\n}\n\n/** Rewrite a staged composition's meta.json AND index.html to the output canvas dims. */\nexport async function stampCompositionDims(compositionDir: string, dims: { w: number; h: number }): Promise<void> {\n  const metaPath = path.join(compositionDir, \"meta.json\");\n  const rawMeta = await readFile(metaPath, \"utf8\");\n  await writeFile(metaPath, patchCompositionMeta(rawMeta, dims), \"utf8\");\n\n  const htmlPath = path.join(compositionDir, \"index.html\");\n  const rawHtml = await readFile(htmlPath, \"utf8\");\n  await writeFile(htmlPath, patchCompositionHtml(rawHtml, dims), \"utf8\");\n}\n"],"mappings":";AAAA,SAAS,UAAU,iBAAiB;AACpC,OAAO,UAAU;AAcV,SAAS,qBAAqB,UAAkB,MAAwC;AAC7F,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,QAAQ;AAChC,QAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,EAAG,QAAO;AACrE,WAAO,GAAG,KAAK,UAAU,EAAE,GAAG,MAAM,OAAO,KAAK,GAAG,QAAQ,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC/E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAUO,SAAS,qBAAqB,MAAc,MAAwC;AACzF,SAAO,KACJ,QAAQ,sEAAsE,KAAK,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,EACxG,QAAQ,6CAA6C,KAAK,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,EAC/E,QAAQ,yBAAyB,KAAK,KAAK,CAAC,IAAI,EAChD,QAAQ,0BAA0B,KAAK,KAAK,CAAC,IAAI;AACtD;AAGA,eAAsB,qBAAqB,gBAAwB,MAA+C;AAChH,QAAM,WAAW,KAAK,KAAK,gBAAgB,WAAW;AACtD,QAAM,UAAU,MAAM,SAAS,UAAU,MAAM;AAC/C,QAAM,UAAU,UAAU,qBAAqB,SAAS,IAAI,GAAG,MAAM;AAErE,QAAM,WAAW,KAAK,KAAK,gBAAgB,YAAY;AACvD,QAAM,UAAU,MAAM,SAAS,UAAU,MAAM;AAC/C,QAAM,UAAU,UAAU,qBAAqB,SAAS,IAAI,GAAG,MAAM;AACvE;","names":[]}

package/dist/chunk-5OVOLYY3.js

@@ -0,0 +1,74 @@
+import {
+  writeOutput
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/images/providerHits.ts
+function asRecord(value) {
+  return value && typeof value === "object" ? value : {};
+}
+function str(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function num(value) {
+  return typeof value === "number" ? value : void 0;
+}
+function compactHit(hit) {
+  return {
+    source: str(hit.source) ?? "",
+    url: str(hit.url) ?? "",
+    imageId: str(hit.imageId),
+    imageUrl: str(hit.imageUrl),
+    name: str(hit.name),
+    width: num(hit.width),
+    height: num(hit.height)
+  };
+}
+function providerHitNormalizer(record, full) {
+  const compact = compactHit(record);
+  if (!full) {
+    return compact;
+  }
+  const group = asRecord(record.group);
+  return {
+    ...compact,
+    externalUrl: str(record.externalUrl),
+    externalId: str(record.externalId),
+    description: str(record.description),
+    tags: Array.isArray(record.tags) ? record.tags : [],
+    aspectRatio: num(record.aspectRatio),
+    dominantColor: str(record.dominantColor),
+    score: num(record.score),
+    deduped: typeof record.deduped === "boolean" ? record.deduped : void 0,
+    alsoInLibrary: str(record.alsoInLibrary),
+    groupKey: str(group.key)
+  };
+}
+function readOutputFlags(args) {
+  const format = typeof args.output === "string" && args.output.length > 0 ? args.output : "json";
+  const rawFields = typeof args.fields === "string" && args.fields.length > 0 ? args.fields : void 0;
+  return {
+    format,
+    fields: rawFields ? rawFields.split(",").filter(Boolean) : void 0,
+    full: args.full === true
+  };
+}
+function writeProviderHits(data, hits, args, hints) {
+  const { format, fields, full } = readOutputFlags(args);
+  const envelope = {
+    ok: true,
+    data: format === "json" ? data : hits,
+    ...hints.length > 0 ? { hints } : {}
+  };
+  writeOutput(envelope, format, fields, full, providerHitNormalizer);
+}
+var OUTPUT_ARGS = {
+  output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+  fields: { type: "string", description: "Comma-separated field names to include", required: false },
+  full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+};
+
+export {
+  writeProviderHits,
+  OUTPUT_ARGS
+};
+//# sourceMappingURL=chunk-5OVOLYY3.js.map

package/dist/chunk-5OVOLYY3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/providerHits.ts"],"sourcesContent":["/**\n * Table projection for the provider-search commands (`logo`, `icon`, `find`).\n *\n * These returned `{ hits, ingested }` as raw JSON with no `--output`/`--fields`\n * /`--full`, so the only way to pull one field out of a result was\n * `grep -oE '\"imageUrl\": \"[^\"]+\"'`. The library commands already had the flag\n * trio; the provider commands just needed a projection to hand it, because the\n * shared image normalizer expects a library row and would flatten a provider\n * hit into an empty record.\n */\n\nimport { type OutputFormat, writeOutput } from \"../../output.ts\";\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return value && typeof value === \"object\" ? (value as Record<string, unknown>) : {};\n}\n\nfunction str(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction num(value: unknown): number | undefined {\n  return typeof value === \"number\" ? value : undefined;\n}\n\n/**\n * What decides whether a hit is usable and how to keep it: which provider it\n * came from, where the pixels are, and — once auto-ingest ran — the library id\n * and Baker-owned URL that make it durable.\n */\nfunction compactHit(hit: Record<string, unknown>): Record<string, unknown> {\n  return {\n    source: str(hit.source) ?? \"\",\n    url: str(hit.url) ?? \"\",\n    imageId: str(hit.imageId),\n    imageUrl: str(hit.imageUrl),\n    name: str(hit.name),\n    width: num(hit.width),\n    height: num(hit.height),\n  };\n}\n\nexport function providerHitNormalizer(record: Record<string, unknown>, full: boolean): Record<string, unknown> {\n  const compact = compactHit(record);\n  if (!full) {\n    return compact;\n  }\n  const group = asRecord(record.group);\n  return {\n    ...compact,\n    externalUrl: str(record.externalUrl),\n    externalId: str(record.externalId),\n    description: str(record.description),\n    tags: Array.isArray(record.tags) ? record.tags : [],\n    aspectRatio: num(record.aspectRatio),\n    dominantColor: str(record.dominantColor),\n    score: num(record.score),\n    deduped: typeof record.deduped === \"boolean\" ? record.deduped : undefined,\n    alsoInLibrary: str(record.alsoInLibrary),\n    groupKey: str(group.key),\n  };\n}\n\n/** The standard `--output`/`--fields`/`--full` trio, parsed the same way in every provider command. */\nexport interface OutputFlags {\n  format: OutputFormat;\n  fields: string[] | undefined;\n  full: boolean;\n}\n\nexport function readOutputFlags(args: Record<string, unknown>): OutputFlags {\n  const format = typeof args.output === \"string\" && args.output.length > 0 ? (args.output as OutputFormat) : \"json\";\n  const rawFields = typeof args.fields === \"string\" && args.fields.length > 0 ? args.fields : undefined;\n  return {\n    format,\n    fields: rawFields ? rawFields.split(\",\").filter(Boolean) : undefined,\n    full: args.full === true,\n  };\n}\n\n/**\n * Emit a provider search result.\n *\n * `json` (the default) emits the backend's response **unchanged** — callers\n * already parse that shape, and `--output` must not rewrite it. The table\n * formats tabulate `hits`, which the caller passes separately because `find`\n * groups its results and has no top-level `hits` key to read.\n */\nexport function writeProviderHits<T>(data: T, hits: unknown[], args: Record<string, unknown>, hints: string[]): void {\n  const { format, fields, full } = readOutputFlags(args);\n  const envelope = {\n    ok: true as const,\n    data: format === \"json\" ? data : (hits as Record<string, unknown>[]),\n    ...(hints.length > 0 ? { hints } : {}),\n  };\n  writeOutput(envelope, format, fields, full, providerHitNormalizer);\n}\n\n/** The flag trio, declared identically on every command that emits provider hits. */\nexport const OUTPUT_ARGS = {\n  output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n  fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n  full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n} as const;\n"],"mappings":";;;;;AAaA,SAAS,SAAS,OAAyC;AACzD,SAAO,SAAS,OAAO,UAAU,WAAY,QAAoC,CAAC;AACpF;AAEA,SAAS,IAAI,OAAoC;AAC/C,SAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;AAEA,SAAS,IAAI,OAAoC;AAC/C,SAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAOA,SAAS,WAAW,KAAuD;AACzE,SAAO;AAAA,IACL,QAAQ,IAAI,IAAI,MAAM,KAAK;AAAA,IAC3B,KAAK,IAAI,IAAI,GAAG,KAAK;AAAA,IACrB,SAAS,IAAI,IAAI,OAAO;AAAA,IACxB,UAAU,IAAI,IAAI,QAAQ;AAAA,IAC1B,MAAM,IAAI,IAAI,IAAI;AAAA,IAClB,OAAO,IAAI,IAAI,KAAK;AAAA,IACpB,QAAQ,IAAI,IAAI,MAAM;AAAA,EACxB;AACF;AAEO,SAAS,sBAAsB,QAAiC,MAAwC;AAC7G,QAAM,UAAU,WAAW,MAAM;AACjC,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,SAAS,OAAO,KAAK;AACnC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa,IAAI,OAAO,WAAW;AAAA,IACnC,YAAY,IAAI,OAAO,UAAU;AAAA,IACjC,aAAa,IAAI,OAAO,WAAW;AAAA,IACnC,MAAM,MAAM,QAAQ,OAAO,IAAI,IAAI,OAAO,OAAO,CAAC;AAAA,IAClD,aAAa,IAAI,OAAO,WAAW;AAAA,IACnC,eAAe,IAAI,OAAO,aAAa;AAAA,IACvC,OAAO,IAAI,OAAO,KAAK;AAAA,IACvB,SAAS,OAAO,OAAO,YAAY,YAAY,OAAO,UAAU;AAAA,IAChE,eAAe,IAAI,OAAO,aAAa;AAAA,IACvC,UAAU,IAAI,MAAM,GAAG;AAAA,EACzB;AACF;AASO,SAAS,gBAAgB,MAA4C;AAC1E,QAAM,SAAS,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,SAAS,IAAK,KAAK,SAA0B;AAC3G,QAAM,YAAY,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,SAAS,IAAI,KAAK,SAAS;AAC5F,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,YAAY,UAAU,MAAM,GAAG,EAAE,OAAO,OAAO,IAAI;AAAA,IAC3D,MAAM,KAAK,SAAS;AAAA,EACtB;AACF;AAUO,SAAS,kBAAqB,MAAS,MAAiB,MAA+B,OAAuB;AACnH,QAAM,EAAE,QAAQ,QAAQ,KAAK,IAAI,gBAAgB,IAAI;AACrD,QAAM,WAAW;AAAA,IACf,IAAI;AAAA,IACJ,MAAM,WAAW,SAAS,OAAQ;AAAA,IAClC,GAAI,MAAM,SAAS,IAAI,EAAE,MAAM,IAAI,CAAC;AAAA,EACtC;AACA,cAAY,UAAU,QAAQ,QAAQ,MAAM,qBAAqB;AACnE;AAGO,IAAM,cAAc;AAAA,EACzB,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,EACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,EACjG,MAAM,EAAE,MAAM,WAAW,aAAa,yBAAyB,UAAU,OAAO,SAAS,MAAM;AACjG;","names":[]}