@koda-sl/baker-cli 0.385.0-dev.ec7b0e42b → 0.385.0-dev.f7ef4c7e1

package/dist/chunk-MZQ5DX6S.js

@@ -0,0 +1,125 @@
+import {
+  apiGet
+} from "./chunk-CUL3VB4L.js";
+
+// src/commands/studio/batch.ts
+function projectBatch(generation, full) {
+  const compact = {
+    generationId: generation.generationId,
+    kind: generation.kind,
+    status: generation.status,
+    prompt: generation.prompt,
+    model: generation.model,
+    aspectRatio: generation.aspectRatio,
+    variants: generation.variants.map((variant) => ({
+      slot: variant.slot,
+      status: variant.status,
+      ...variant.imageId ? { imageId: variant.imageId } : {},
+      ...variant.videoId ? { videoId: variant.videoId } : {},
+      ...variant.url ? { url: variant.url } : {},
+      inLibrary: variant.inLibrary,
+      ...variant.error ? { error: variant.error } : {}
+    }))
+  };
+  if (!full) return compact;
+  return {
+    ...compact,
+    ...generation.skillId ? { skillId: generation.skillId } : {},
+    ...generation.imageSettings ? { imageSettings: generation.imageSettings } : {},
+    ...generation.clipSettings ? { clipSettings: generation.clipSettings } : {},
+    ...generation.referenceImageIds ? { referenceImageIds: generation.referenceImageIds } : {},
+    ...generation.chatId ? { chatId: generation.chatId } : {},
+    createdAt: generation.createdAt
+  };
+}
+function slotArg(candidates) {
+  return candidates.length === 1 ? `--slot ${candidates[0]?.slot}` : "--slot <n>";
+}
+function chooseFirst(candidates) {
+  return candidates.length === 1 ? "" : " Look at the takes and pick one \u2014 do not default to the first.";
+}
+function batchHints(generation) {
+  const id = generation.generationId;
+  if (generation.status === "running") {
+    return [
+      `Still rendering. Run \`baker studio get ${id}\` when you need the result \u2014 do not start the same batch again.`
+    ];
+  }
+  const hints = [];
+  const ready = generation.variants.filter((variant) => variant.status === "ready");
+  const failed = generation.variants.filter((variant) => variant.status === "failed");
+  if (generation.kind === "image" && ready.length > 0) {
+    hints.push(
+      'Every rendered image is already in the media library and searchable \u2014 `baker images library "<what it shows>"` finds it, and you can use its image id straight away.'
+    );
+    hints.push(
+      `Mark the take you are using: \`baker studio keep ${id} ${slotArg(ready)}\` stars it so the client reviews the right one.${chooseFirst(ready)}`
+    );
+  }
+  const unkeptClips = ready.filter((variant) => !variant.inLibrary);
+  if (generation.kind === "video" && unkeptClips.length > 0) {
+    hints.push(
+      `A clip is not usable anywhere \u2014 canvas, landing, ad \u2014 until you keep it. \`baker studio keep ${id} ${slotArg(unkeptClips)}\` puts it in the video library; takes nobody keeps are never ingested.${chooseFirst(unkeptClips)}`
+    );
+  }
+  if (generation.status === "partial" && failed.length > 0) {
+    hints.push(
+      `${failed.length === 1 ? "This take" : "These takes"} did not render \u2014 ${failed.map((variant) => `take ${variant.slot}: ${variant.error ?? "no reason given"}`).join("; ")}. Use the ones that did and carry on; do not re-run the whole batch.`
+    );
+  }
+  if (generation.status === "failed") {
+    hints.push(
+      `No take rendered \u2014 ${failed[0]?.error ?? "no reason given"}. Continue the job with a sourced or existing asset rather than stopping.`
+    );
+  }
+  return hints;
+}
+function waitingHint(outcome, generationId, maxWaitMs) {
+  const collect = `Run \`baker studio get ${generationId}\` to pick it up \u2014 the batch is still going, so do not start it again.`;
+  if (outcome.kind === "unreachable") {
+    return `The batch started and is rendering, but reading it back failed (${outcome.reason}). ${collect}`;
+  }
+  return `Still rendering after ${Math.round(maxWaitMs / 1e3)}s. ${collect}`;
+}
+var FALSEY_FLAG_VALUES = /* @__PURE__ */ new Set(["false", "0", "no", "off"]);
+function resolveMaxWaitMs(wait, maxWait, defaultMs) {
+  if (typeof wait === "string" && FALSEY_FLAG_VALUES.has(wait.trim().toLowerCase())) return 0;
+  if (wait === false) return 0;
+  if (maxWait === void 0 || maxWait === "") return defaultMs;
+  const parsed = Number(maxWait);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;
+}
+var POLL_INTERVAL_MS = 3e3;
+var defaultPollDeps = {
+  get: async (generationId) => {
+    const response = await apiGet(`/api/studio/generations/${generationId}`);
+    return response.generation;
+  },
+  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+};
+async function pollBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
+  const deadline = Date.now() + maxWaitMs;
+  while (Date.now() < deadline) {
+    const generation = await deps.get(generationId);
+    if (generation.status !== "running") return generation;
+    await deps.sleep(POLL_INTERVAL_MS);
+  }
+  return null;
+}
+async function awaitBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
+  try {
+    const generation = await pollBatch(generationId, maxWaitMs, deps);
+    return generation ? { kind: "settled", generation } : { kind: "still-running" };
+  } catch (error) {
+    return { kind: "unreachable", reason: error instanceof Error ? error.message : "the read failed" };
+  }
+}
+
+export {
+  projectBatch,
+  batchHints,
+  waitingHint,
+  resolveMaxWaitMs,
+  awaitBatch
+};
+//# sourceMappingURL=chunk-MZQ5DX6S.js.map

package/dist/chunk-MZQ5DX6S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/batch.ts"],"sourcesContent":["import type { StudioGeneration, StudioGetResponse } from \"@baker/api\";\nimport { apiGet } from \"../../client.ts\";\n\n/**\n * Compact projection: what the agent needs to DECIDE what happened to a batch —\n * which takes rendered, where each one lives, and why a take is missing. The\n * settings echo, the reference list and the attribution are `--full` only,\n * because a four-take batch would otherwise repeat the whole request back.\n */\nexport function projectBatch(generation: StudioGeneration, full: boolean): Record<string, unknown> {\n  const compact: Record<string, unknown> = {\n    generationId: generation.generationId,\n    kind: generation.kind,\n    status: generation.status,\n    prompt: generation.prompt,\n    model: generation.model,\n    aspectRatio: generation.aspectRatio,\n    variants: generation.variants.map((variant) => ({\n      slot: variant.slot,\n      status: variant.status,\n      ...(variant.imageId ? { imageId: variant.imageId } : {}),\n      ...(variant.videoId ? { videoId: variant.videoId } : {}),\n      ...(variant.url ? { url: variant.url } : {}),\n      inLibrary: variant.inLibrary,\n      ...(variant.error ? { error: variant.error } : {}),\n    })),\n  };\n  if (!full) return compact;\n  return {\n    ...compact,\n    ...(generation.skillId ? { skillId: generation.skillId } : {}),\n    ...(generation.imageSettings ? { imageSettings: generation.imageSettings } : {}),\n    ...(generation.clipSettings ? { clipSettings: generation.clipSettings } : {}),\n    ...(generation.referenceImageIds ? { referenceImageIds: generation.referenceImageIds } : {}),\n    ...(generation.chatId ? { chatId: generation.chatId } : {}),\n    createdAt: generation.createdAt,\n  };\n}\n\n/**\n * The `--slot` argument to show in a keep hint.\n *\n * A hint carrying a complete, paste-ready command gets pasted — that is what a\n * hint is for. So it may only name a slot when there is no choice to make.\n * Naming the first ready take out of several turned \"keep the one you chose\"\n * into \"keep slot 0\", on every batch, which makes the star meaningless: the\n * client sees one starred take per batch whether or not anyone judged them.\n */\nfunction slotArg(candidates: { slot: number }[]): string {\n  return candidates.length === 1 ? `--slot ${candidates[0]?.slot}` : \"--slot <n>\";\n}\n\n/** Says out loud that the choice is the agent's, only when there is one. */\nfunction chooseFirst(candidates: unknown[]): string {\n  return candidates.length === 1 ? \"\" : \" Look at the takes and pick one — do not default to the first.\";\n}\n\n/**\n * What to do next with this batch.\n *\n * The two misuses worth spending a hint on: starting the same batch again while\n * it is still rendering, and treating a rendered clip as usable. A clip is only\n * ingested when it is kept, so an agent that hands the URL to a canvas is\n * pointing at something the library never took.\n */\nexport function batchHints(generation: StudioGeneration): string[] {\n  const id = generation.generationId;\n  if (generation.status === \"running\") {\n    return [\n      `Still rendering. Run \\`baker studio get ${id}\\` when you need the result — do not start the same batch again.`,\n    ];\n  }\n\n  const hints: string[] = [];\n  const ready = generation.variants.filter((variant) => variant.status === \"ready\");\n  const failed = generation.variants.filter((variant) => variant.status === \"failed\");\n\n  if (generation.kind === \"image\" && ready.length > 0) {\n    hints.push(\n      'Every rendered image is already in the media library and searchable — `baker images library \"<what it shows>\"` finds it, and you can use its image id straight away.',\n    );\n    hints.push(\n      `Mark the take you are using: \\`baker studio keep ${id} ${slotArg(ready)}\\` stars it so the client reviews the right one.${chooseFirst(ready)}`,\n    );\n  }\n\n  const unkeptClips = ready.filter((variant) => !variant.inLibrary);\n  if (generation.kind === \"video\" && unkeptClips.length > 0) {\n    hints.push(\n      `A clip is not usable anywhere — canvas, landing, ad — until you keep it. \\`baker studio keep ${id} ${slotArg(unkeptClips)}\\` puts it in the video library; takes nobody keeps are never ingested.${chooseFirst(unkeptClips)}`,\n    );\n  }\n\n  if (generation.status === \"partial\" && failed.length > 0) {\n    hints.push(\n      `${failed.length === 1 ? \"This take\" : \"These takes\"} did not render — ${failed\n        .map((variant) => `take ${variant.slot}: ${variant.error ?? \"no reason given\"}`)\n        .join(\"; \")}. Use the ones that did and carry on; do not re-run the whole batch.`,\n    );\n  }\n\n  if (generation.status === \"failed\") {\n    hints.push(\n      `No take rendered — ${failed[0]?.error ?? \"no reason given\"}. Continue the job with a sourced or existing asset rather than stopping.`,\n    );\n  }\n\n  return hints;\n}\n\n/**\n * What to tell a caller still holding a batch that has not settled — whether it\n * simply outlasted the wait, or the read stopped answering. Both end the same\n * way, and that ending is the point: the takes are paid for and still coming, so\n * collect them by id rather than starting again.\n */\nexport function waitingHint(outcome: BatchOutcome, generationId: string, maxWaitMs: number): string {\n  const collect = `Run \\`baker studio get ${generationId}\\` to pick it up — the batch is still going, so do not start it again.`;\n  if (outcome.kind === \"unreachable\") {\n    return `The batch started and is rendering, but reading it back failed (${outcome.reason}). ${collect}`;\n  }\n  return `Still rendering after ${Math.round(maxWaitMs / 1000)}s. ${collect}`;\n}\n\nconst FALSEY_FLAG_VALUES = new Set([\"false\", \"0\", \"no\", \"off\"]);\n\n/**\n * How long to hold the command open, in ms — 0 meaning \"return the id now\".\n *\n * Two ways to say the same thing because agents reach for both: `--wait false`\n * (don't block) and `--max-wait 0` (block for nothing).\n */\nexport function resolveMaxWaitMs(wait: unknown, maxWait: unknown, defaultMs: number): number {\n  if (typeof wait === \"string\" && FALSEY_FLAG_VALUES.has(wait.trim().toLowerCase())) return 0;\n  if (wait === false) return 0;\n  if (maxWait === undefined || maxWait === \"\") return defaultMs;\n  const parsed = Number(maxWait);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;\n}\n\nconst POLL_INTERVAL_MS = 3_000;\n\nexport type PollDeps = {\n  get: (generationId: string) => Promise<StudioGeneration>;\n  sleep: (ms: number) => Promise<void>;\n};\n\nexport const defaultPollDeps: PollDeps = {\n  get: async (generationId) => {\n    const response = await apiGet<StudioGetResponse>(`/api/studio/generations/${generationId}`);\n    return response.generation;\n  },\n  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),\n};\n\n/**\n * Poll until the batch stops running, or give up and hand the id back.\n *\n * Running out of patience is NOT a failure here: the batch is still rendering on\n * the backend and will land in the dashboard either way, so the honest answer is\n * the id plus \"pick it up with `baker studio get`\". Exiting non-zero would make a\n * slow provider look like a broken command and push the agent into re-running a\n * generation the company already paid for.\n */\nexport async function pollBatch(\n  generationId: string,\n  maxWaitMs: number,\n  deps: PollDeps = defaultPollDeps,\n): Promise<StudioGeneration | null> {\n  const deadline = Date.now() + maxWaitMs;\n  while (Date.now() < deadline) {\n    const generation = await deps.get(generationId);\n    if (generation.status !== \"running\") return generation;\n    await deps.sleep(POLL_INTERVAL_MS);\n  }\n  return null;\n}\n\n/** What became of a batch that was successfully STARTED — and therefore billed. */\nexport type BatchOutcome =\n  | { kind: \"settled\"; generation: StudioGeneration }\n  | { kind: \"still-running\" }\n  | { kind: \"unreachable\"; reason: string };\n\n/**\n * Wait for a started batch without ever throwing.\n *\n * Once the POST returns, the takes are rendering and the company has paid. A\n * read that fails after that point says nothing about the request — the batch is\n * fine, we just could not see it — so it must not surface as a refused start,\n * which is advice to change a setting and run the whole thing again. Losing the\n * `generationId` here is what turns one transient GET into a second charge.\n */\nexport async function awaitBatch(\n  generationId: string,\n  maxWaitMs: number,\n  deps: PollDeps = defaultPollDeps,\n): Promise<BatchOutcome> {\n  try {\n    const generation = await pollBatch(generationId, maxWaitMs, deps);\n    return generation ? { kind: \"settled\", generation } : { kind: \"still-running\" };\n  } catch (error) {\n    return { kind: \"unreachable\", reason: error instanceof Error ? error.message : \"the read failed\" };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-NFSLRRIE.js

@@ -0,0 +1,77 @@
+import {
+  classifyAudience
+} from "./chunk-5HYSKH77.js";
+
+// src/audience-names.ts
+var BUYERS_QUESTION = `\`name\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it made of people who have already bought from the brand: purchasers, paying customers, clients, a customer list? People who only visited, engaged, signed up, started a checkout or are leads or prospects have not bought. A lookalike of buyers is not buyers.`;
+var BUYERS_HELD = 0.42;
+var LOOKALIKE_QUESTION = `\`name\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it a lookalike audience: new people Meta finds because they resemble a seed audience (often named "Lookalike (GB, 1%)", "LAL 3%", "Similar to\u2026")?`;
+var LOOKALIKE_HELD = 0.4;
+async function readAudienceNames(names, ask) {
+  const distinct = [...new Set(names.map((n) => n.trim()).filter(Boolean))];
+  if (distinct.length === 0) return () => void 0;
+  const answers = await ask(
+    distinct.flatMap((name) => [
+      { instructions: { name, question: BUYERS_QUESTION } },
+      { instructions: { name, question: LOOKALIKE_QUESTION } }
+    ])
+  );
+  if (answers === null) return () => void 0;
+  const read = new Map(
+    distinct.map((name, i) => [
+      name,
+      { buyers: (answers[2 * i] ?? 0) >= BUYERS_HELD, lookalike: (answers[2 * i + 1] ?? 0) >= LOOKALIKE_HELD }
+    ])
+  );
+  return (name) => read.get(name.trim());
+}
+
+// src/commands/ads/meta/adset-viewers.ts
+function adSetViewerRows(adSets, audiences, campaigns, readName) {
+  const campaignById = new Map(campaigns.map((campaign) => [campaign.id, campaign]));
+  return adSets.map((adSet) => ({
+    id: adSet.id,
+    name: adSet.name,
+    campaign_id: adSet.campaign_id,
+    effective_status: adSet.effective_status,
+    viewer: classifyAudience(adSet, audiences, campaignById.get(adSet.campaign_id), readName)
+  }));
+}
+var VIEWER_TABLE_COLUMNS = [
+  "id",
+  "name",
+  "effective_status",
+  "temperature",
+  "knows",
+  "placements",
+  "why"
+];
+function flattenViewerRows(rows) {
+  return rows.map(({ viewer, ...row }) => ({
+    id: row.id,
+    name: row.name,
+    effective_status: row.effective_status,
+    temperature: viewer.temperature,
+    knows: viewer.knows.length > 0 ? viewer.knows.join(", ") : "nothing yet",
+    placements: viewer.placements.join(", "),
+    why: viewer.reasons.join(" ")
+  }));
+}
+function audienceNamesOf(adSets, audiences) {
+  const refs = adSets.flatMap((adSet) => {
+    const targeting = adSet.targeting ?? {};
+    return [targeting.custom_audiences, targeting.excluded_custom_audiences].flatMap(
+      (list) => Array.isArray(list) ? list.map((ref) => ref?.name) : []
+    );
+  });
+  return [...refs, ...audiences.map((a) => a.name)].filter((n) => typeof n === "string" && n.length > 0);
+}
+
+export {
+  readAudienceNames,
+  adSetViewerRows,
+  VIEWER_TABLE_COLUMNS,
+  flattenViewerRows,
+  audienceNamesOf
+};
+//# sourceMappingURL=chunk-NFSLRRIE.js.map

package/dist/chunk-NFSLRRIE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audience-names.ts","../src/commands/ads/meta/adset-viewers.ts"],"sourcesContent":["/**\n * What a Meta custom audience's name says its members are, read by the decision model (Jev) in\n * the advertiser's own language: buyers (\"Compradores 180d\", \"Kunden-Liste\", \"購入者\"), or a\n * lookalike of a seed. It replaced a regex of the words for \"buyer\" in five languages, which read\n * \"Clientes potenciales\" (leads) as buyers and missed every other language. Thresholds were\n * measured on scripts/audience-names-evals (docs/decision-model.md).\n */\nimport type { AskNouls } from \"./engine/lib/remembered-nouls.ts\";\nimport type { AudienceNameReading } from \"./viewer-profile.ts\";\n\nexport const BUYERS_QUESTION = `\\`name\\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it made of people who have already bought from the brand: purchasers, paying customers, clients, a customer list? People who only visited, engaged, signed up, started a checkout or are leads or prospects have not bought. A lookalike of buyers is not buyers.`;\nconst BUYERS_HELD = 0.42;\n\nexport const LOOKALIKE_QUESTION = `\\`name\\` is the name an advertiser gave a custom audience in their Meta ad account, in any language. Is it a lookalike audience: new people Meta finds because they resemble a seed audience (often named \"Lookalike (GB, 1%)\", \"LAL 3%\", \"Similar to…\")?`;\nconst LOOKALIKE_HELD = 0.4;\n\n/** Each name's reading, in one request; undefined for every name when the model could not answer. */\nexport async function readAudienceNames(names: readonly string[], ask: AskNouls): Promise<AudienceNameReading> {\n  const distinct = [...new Set(names.map((n) => n.trim()).filter(Boolean))];\n  if (distinct.length === 0) return () => undefined;\n  const answers = await ask(\n    distinct.flatMap((name) => [\n      { instructions: { name, question: BUYERS_QUESTION } },\n      { instructions: { name, question: LOOKALIKE_QUESTION } },\n    ]),\n  );\n  if (answers === null) return () => undefined;\n  const read = new Map(\n    distinct.map((name, i) => [\n      name,\n      { buyers: (answers[2 * i] ?? 0) >= BUYERS_HELD, lookalike: (answers[2 * i + 1] ?? 0) >= LOOKALIKE_HELD },\n    ]),\n  );\n  return (name) => read.get(name.trim());\n}\n","import {\n  type AudienceNameReading,\n  type CustomAudienceInput,\n  classifyAudience,\n  type ViewerProfile,\n} from \"../../../viewer-profile.ts\";\n\ntype MetaRow = Record<string, unknown>;\n\nexport interface AdSetViewerRow {\n  id: unknown;\n  name: unknown;\n  campaign_id: unknown;\n  effective_status: unknown;\n  viewer: ViewerProfile;\n}\n\n/**\n * `baker ads meta adsets --audience`: who each ad set reaches, read off its own\n * targeting, the account's audience list (for each audience's subtype) and its\n * campaign's objective, and what each audience's name says its members are\n * (`readAudienceNames`; read by subtype alone without it). The row keeps only\n * what names the ad set, so the viewer is the one thing it adds.\n */\nexport function adSetViewerRows(\n  adSets: readonly MetaRow[],\n  audiences: readonly CustomAudienceInput[],\n  campaigns: readonly MetaRow[],\n  readName?: AudienceNameReading,\n): AdSetViewerRow[] {\n  const campaignById = new Map(campaigns.map((campaign) => [campaign.id, campaign]));\n  return adSets.map((adSet) => ({\n    id: adSet.id,\n    name: adSet.name,\n    campaign_id: adSet.campaign_id,\n    effective_status: adSet.effective_status,\n    viewer: classifyAudience(adSet, audiences, campaignById.get(adSet.campaign_id), readName),\n  }));\n}\n\nexport const VIEWER_TABLE_COLUMNS = [\n  \"id\",\n  \"name\",\n  \"effective_status\",\n  \"temperature\",\n  \"knows\",\n  \"placements\",\n  \"why\",\n] as const;\n\n/** The table and csv writers print one scalar per cell, so the viewer is spelled out column by column. */\nexport function flattenViewerRows(rows: readonly AdSetViewerRow[]): Array<Record<string, unknown>> {\n  return rows.map(({ viewer, ...row }) => ({\n    id: row.id,\n    name: row.name,\n    effective_status: row.effective_status,\n    temperature: viewer.temperature,\n    knows: viewer.knows.length > 0 ? viewer.knows.join(\", \") : \"nothing yet\",\n    placements: viewer.placements.join(\", \"),\n    why: viewer.reasons.join(\" \"),\n  }));\n}\n\n/** Every audience name an ad set includes or excludes, and every name in the account's list. Pure. */\nexport function audienceNamesOf(adSets: readonly MetaRow[], audiences: readonly CustomAudienceInput[]): string[] {\n  const refs = adSets.flatMap((adSet) => {\n    const targeting = (adSet.targeting ?? {}) as Record<string, unknown>;\n    return [targeting.custom_audiences, targeting.excluded_custom_audiences].flatMap((list) =>\n      Array.isArray(list) ? list.map((ref) => (ref as { name?: unknown })?.name) : [],\n    );\n  });\n  return [...refs, ...audiences.map((a) => a.name)].filter((n): n is string => typeof n === \"string\" && n.length > 0);\n}\n"],"mappings":";;;;;AAUO,IAAM,kBAAkB;AAC/B,IAAM,cAAc;AAEb,IAAM,qBAAqB;AAClC,IAAM,iBAAiB;AAGvB,eAAsB,kBAAkB,OAA0B,KAA6C;AAC7G,QAAM,WAAW,CAAC,GAAG,IAAI,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC;AACxE,MAAI,SAAS,WAAW,EAAG,QAAO,MAAM;AACxC,QAAM,UAAU,MAAM;AAAA,IACpB,SAAS,QAAQ,CAAC,SAAS;AAAA,MACzB,EAAE,cAAc,EAAE,MAAM,UAAU,gBAAgB,EAAE;AAAA,MACpD,EAAE,cAAc,EAAE,MAAM,UAAU,mBAAmB,EAAE;AAAA,IACzD,CAAC;AAAA,EACH;AACA,MAAI,YAAY,KAAM,QAAO,MAAM;AACnC,QAAM,OAAO,IAAI;AAAA,IACf,SAAS,IAAI,CAAC,MAAM,MAAM;AAAA,MACxB;AAAA,MACA,EAAE,SAAS,QAAQ,IAAI,CAAC,KAAK,MAAM,aAAa,YAAY,QAAQ,IAAI,IAAI,CAAC,KAAK,MAAM,eAAe;AAAA,IACzG,CAAC;AAAA,EACH;AACA,SAAO,CAAC,SAAS,KAAK,IAAI,KAAK,KAAK,CAAC;AACvC;;;ACVO,SAAS,gBACd,QACA,WACA,WACA,UACkB;AAClB,QAAM,eAAe,IAAI,IAAI,UAAU,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;AACjF,SAAO,OAAO,IAAI,CAAC,WAAW;AAAA,IAC5B,IAAI,MAAM;AAAA,IACV,MAAM,MAAM;AAAA,IACZ,aAAa,MAAM;AAAA,IACnB,kBAAkB,MAAM;AAAA,IACxB,QAAQ,iBAAiB,OAAO,WAAW,aAAa,IAAI,MAAM,WAAW,GAAG,QAAQ;AAAA,EAC1F,EAAE;AACJ;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,kBAAkB,MAAiE;AACjG,SAAO,KAAK,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,OAAO;AAAA,IACvC,IAAI,IAAI;AAAA,IACR,MAAM,IAAI;AAAA,IACV,kBAAkB,IAAI;AAAA,IACtB,aAAa,OAAO;AAAA,IACpB,OAAO,OAAO,MAAM,SAAS,IAAI,OAAO,MAAM,KAAK,IAAI,IAAI;AAAA,IAC3D,YAAY,OAAO,WAAW,KAAK,IAAI;AAAA,IACvC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAAA,EAC9B,EAAE;AACJ;AAGO,SAAS,gBAAgB,QAA4B,WAAqD;AAC/G,QAAM,OAAO,OAAO,QAAQ,CAAC,UAAU;AACrC,UAAM,YAAa,MAAM,aAAa,CAAC;AACvC,WAAO,CAAC,UAAU,kBAAkB,UAAU,yBAAyB,EAAE;AAAA,MAAQ,CAAC,SAChF,MAAM,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,QAAS,KAA4B,IAAI,IAAI,CAAC;AAAA,IAChF;AAAA,EACF,CAAC;AACD,SAAO,CAAC,GAAG,MAAM,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,MAAmB,OAAO,MAAM,YAAY,EAAE,SAAS,CAAC;AACpH;","names":[]}