@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/screenshot-EIGC6SZB.js

@@ -0,0 +1,102 @@
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-LWAEHLKV.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/screenshot.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.screenshot",
+  description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
+  args: {
+    url: { type: "string", description: "URL to capture", required: true },
+    "full-page": { type: "boolean", description: "Full-page capture", required: false, default: false },
+    viewport: { type: "string", description: "WxH (e.g. 1440x900)", required: false },
+    format: { type: "string", description: "webp | png | jpg", required: false, default: "webp" },
+    context: {
+      type: "string",
+      description: "Free-text hint passed to Gemini describe (e.g. 'competitor pricing page screenshot')",
+      required: false
+    },
+    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 }
+  }
+});
+var screenshotCommand = defineCommand({
+  meta: {
+    name: "screenshot",
+    description: "Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\n\nExample: baker images screenshot https://stripe.com --full-page"
+  },
+  args: {
+    url: { type: "positional", description: "URL to capture", required: false },
+    "full-page": { type: "boolean", description: "Full-page capture", required: false },
+    viewport: { type: "string", description: "WxH viewport (e.g. 1440x900)", required: false },
+    format: { type: "string", description: "webp|png|jpg", required: false },
+    context: { type: "string", description: "Description context hint", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const url = args.url;
+      if (!url) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+        process.exit(1);
+      }
+      const body = { url };
+      if (args["full-page"]) body.fullPage = true;
+      if (args.format) body.format = args.format;
+      const viewport = args.viewport;
+      if (viewport) {
+        const match = viewport.match(/^(\d+)x(\d+)$/);
+        if (!match) {
+          writeJson({
+            ok: false,
+            error: { code: "VALIDATION_ERROR", message: "--viewport must be WxH (e.g. 1440x900)" }
+          });
+          process.exit(1);
+        }
+        body.viewportWidth = Number(match[1]);
+        body.viewportHeight = Number(match[2]);
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/screenshot", body);
+      writeProviderHits(data, data.hits, args, []);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const isUrlProblem = err.code === "VALIDATION_ERROR" || err.code === "NOT_FOUND";
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            ...isUrlProblem ? {
+              fix: {
+                action: "reject",
+                explanation: "Verify the URL is correct and publicly reachable, then retry with a working address. If the page can't be captured, continue without this screenshot rather than stopping the job."
+              }
+            } : {}
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  screenshotCommand
+};
+//# sourceMappingURL=screenshot-EIGC6SZB.js.map

package/dist/screenshot-EIGC6SZB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/screenshot.ts"],"sourcesContent":["import type { ImagesScreenshotRequest, ImagesScreenshotResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { OUTPUT_ARGS, writeProviderHits } from \"./providerHits.ts\";\n\nregisterSchema({\n  command: \"images.screenshot\",\n  description: \"Capture a website screenshot via ScreenshotOne. Auto-ingests on success.\",\n  args: {\n    url: { type: \"string\", description: \"URL to capture\", required: true },\n    \"full-page\": { type: \"boolean\", description: \"Full-page capture\", required: false, default: false },\n    viewport: { type: \"string\", description: \"WxH (e.g. 1440x900)\", required: false },\n    format: { type: \"string\", description: \"webp | png | jpg\", required: false, default: \"webp\" },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint passed to Gemini describe (e.g. 'competitor pricing page screenshot')\",\n      required: false,\n    },\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  },\n});\n\nexport const screenshotCommand = defineCommand({\n  meta: {\n    name: \"screenshot\",\n    description:\n      \"Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\\n\\nExample: baker images screenshot https://stripe.com --full-page\",\n  },\n  args: {\n    url: { type: \"positional\", description: \"URL to capture\", required: false },\n    \"full-page\": { type: \"boolean\", description: \"Full-page capture\", required: false },\n    viewport: { type: \"string\", description: \"WxH viewport (e.g. 1440x900)\", required: false },\n    format: { type: \"string\", description: \"webp|png|jpg\", required: false },\n    context: { type: \"string\", description: \"Description context hint\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const url = args.url as string | undefined;\n      if (!url) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"URL is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesScreenshotRequest = { url };\n      if (args[\"full-page\"]) body.fullPage = true;\n      if (args.format) body.format = args.format as ImagesScreenshotRequest[\"format\"];\n      const viewport = args.viewport as string | undefined;\n      if (viewport) {\n        const match = viewport.match(/^(\\d+)x(\\d+)$/);\n        if (!match) {\n          writeJson({\n            ok: false,\n            error: { code: \"VALIDATION_ERROR\", message: \"--viewport must be WxH (e.g. 1440x900)\" },\n          });\n          process.exit(1);\n        }\n        body.viewportWidth = Number(match[1]);\n        body.viewportHeight = Number(match[2]);\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesScreenshotResponse>(\"/api/images/screenshot\", body);\n      writeProviderHits(data, data.hits, args as Record<string, unknown>, []);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        // A bad/unreachable URL comes back as a 4xx (VALIDATION_ERROR / NOT_FOUND).\n        // Tell the agent how to recover and to keep going rather than aborting the job.\n        const isUrlProblem = err.code === \"VALIDATION_ERROR\" || err.code === \"NOT_FOUND\";\n        writeJson({\n          ok: false,\n          error: {\n            code: err.code,\n            message: err.message,\n            ...(isUrlProblem\n              ? {\n                  fix: {\n                    action: \"reject\",\n                    explanation:\n                      \"Verify the URL is correct and publicly reachable, then retry with a working address. If the page can't be captured, continue without this screenshot rather than stopping the job.\",\n                  },\n                }\n              : {}),\n          },\n        });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/search-2SVUDZIX.js

@@ -0,0 +1,224 @@
+import {
+  READABLE_SHOT,
+  downloadReadableShot
+} from "./chunk-DNCLWSHO.js";
+import {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  parseNumber,
+  reportError,
+  splitList
+} from "./chunk-Z7MWSXLG.js";
+import {
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/search.ts
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.search",
+  description: "Search the shared library of real landing-page sections for reference before you design. Start here: baker landing inspiration search 'pricing with a monthly/annual toggle'. Returns the idea behind each section plus a downloaded screenshot you can Read. Defaults to this company's saved sections; pass --scope all for the whole library.",
+  args: {
+    query: { type: "string", description: "What you want to see, in plain English", required: false },
+    type: {
+      type: "string",
+      description: "Comma list of section types: hero,pricing,faq,testimonials,\u2026",
+      required: false
+    },
+    composition: {
+      type: "string",
+      description: "Comma list of composition patterns (references/composition.md)",
+      required: false
+    },
+    register: {
+      type: "string",
+      description: "Comma list of visual registers: dev-tool-minimal,luxury-high-end,\u2026",
+      required: false
+    },
+    interaction: { type: "string", description: "Comma list of interaction patterns", required: false },
+    motion: {
+      type: "string",
+      description: "Comma list of motion kinds: scroll-reveal,marquee,parallax,\u2026",
+      required: false
+    },
+    media: { type: "string", description: "Comma list of media kinds", required: false },
+    device: { type: "string", description: "Comma list of content devices", required: false },
+    theme: { type: "string", description: "light | dark | mixed", required: false },
+    "max-rank": {
+      type: "number",
+      description: "Show>Tell rank ceiling 1-7; 3 means 'rank 3 or better'",
+      required: false
+    },
+    "min-craft": { type: "number", description: "Craft floor 0-1", required: false },
+    "min-fidelity": {
+      type: "number",
+      description: "Only sections whose markup reproduces this well (0-1)",
+      required: false
+    },
+    domain: { type: "string", description: "Restrict to one site", required: false },
+    "similar-to": {
+      type: "string",
+      description: "Section id \u2014 find sections that look like this one",
+      required: false
+    },
+    scope: { type: "string", description: "favorites (default) | all", required: false },
+    limit: { type: "number", description: "Max results (default 8)", required: false },
+    "no-images": { type: "boolean", description: "Skip downloading screenshots", required: false },
+    full: {
+      type: "boolean",
+      description: "Add every classification facet (theme, density, rank, interactions, media, devices, tags, headline)",
+      required: false
+    }
+  }
+});
+function buildSearchBody(args) {
+  const body = {};
+  const setList = (key, value) => {
+    const list = splitList(value);
+    if (list) Object.assign(body, { [key]: list });
+  };
+  if (args.query) body.query = String(args.query);
+  if (args["similar-to"]) body.similarToSectionId = String(args["similar-to"]);
+  setList("sectionType", args.type);
+  setList("composition", args.composition);
+  setList("visualRegister", args.register);
+  setList("interaction", args.interaction);
+  setList("motion", args.motion);
+  setList("mediaKind", args.media);
+  setList("contentDevice", args.device);
+  if (args.theme) body.theme = String(args.theme);
+  if (args.domain) body.domain = String(args.domain);
+  const maxRank = parseNumber(args["max-rank"]);
+  if (maxRank !== void 0) body.maxShowTellRank = maxRank;
+  const minCraft = parseNumber(args["min-craft"]);
+  if (minCraft !== void 0) body.minCraftScore = minCraft;
+  const minFidelity = parseNumber(args["min-fidelity"]);
+  if (minFidelity !== void 0) body.minFidelity = minFidelity;
+  const limit = parseNumber(args.limit);
+  body.limit = limit ?? 8;
+  body.scope = args.scope === "all" ? "all" : "favorites";
+  return body;
+}
+async function downloadShots(results) {
+  const dir = path.join(process.cwd(), ".baker", "inspiration");
+  const saved = /* @__PURE__ */ new Map();
+  await Promise.all(
+    results.map(async (result) => {
+      const file = await downloadReadableShot(
+        result.desktopShotUrl,
+        path.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
+      );
+      if (file) saved.set(result.id, file);
+    })
+  );
+  return saved;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all"
+  },
+  args: {
+    query: { type: "positional", description: "What you want to see, in plain English", required: false },
+    type: { type: "string", description: "Comma list of section types", required: false },
+    composition: { type: "string", description: "Comma list of composition patterns", required: false },
+    register: { type: "string", description: "Comma list of visual registers", required: false },
+    interaction: { type: "string", description: "Comma list of interaction patterns", required: false },
+    motion: { type: "string", description: "Comma list of motion kinds", required: false },
+    media: { type: "string", description: "Comma list of media kinds", required: false },
+    device: { type: "string", description: "Comma list of content devices", required: false },
+    theme: { type: "string", description: "light | dark | mixed", required: false },
+    "max-rank": { type: "string", description: "Show>Tell rank ceiling 1-7", required: false },
+    "min-craft": { type: "string", description: "Craft floor 0-1", required: false },
+    "min-fidelity": { type: "string", description: "Reproduction-fidelity floor 0-1", required: false },
+    domain: { type: "string", description: "Restrict to one site", required: false },
+    "similar-to": { type: "string", description: "Section id to find lookalikes of", required: false },
+    scope: { type: "string", description: "favorites (default) | all", required: false, default: "favorites" },
+    limit: { type: "string", description: "Max results (default 8)", required: false },
+    "no-images": { type: "boolean", description: "Skip downloading screenshots", required: false, default: false },
+    full: { type: "boolean", description: "Include every classification facet", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = buildSearchBody(args);
+      const data = await apiPost("/api/landing-inspiration/search", body);
+      const results = Array.isArray(data?.results) ? data.results : [];
+      const shots = args["no-images"] ? /* @__PURE__ */ new Map() : await downloadShots(results);
+      const full = args.full;
+      const rows = results.map((result) => ({
+        id: result.id,
+        // The id `page` takes. Its own schema says "from a search result's source
+        // id", and until this line no projection emitted one — so the ordering
+        // view could only be reached straight after `add`, never from a search.
+        page_id: result.sourceId,
+        section: result.sectionType,
+        composition: result.composition,
+        look: result.visualRegister,
+        motion: result.motionSummary,
+        why_it_works: result.whyItWorks,
+        craft: Number(result.craftScore?.toFixed?.(2) ?? result.craftScore),
+        fidelity: result.fidelity,
+        domain: result.domain,
+        // Only worth saying when it means something: >1 marks a section the site
+        // reuses across its pages, which is a stronger signal than a one-off.
+        ...result.pageCount > 1 ? { used_on_pages: result.pageCount } : {},
+        // With --no-images there is no file, so hand back the URL instead. A row
+        // with neither is a section the agent is asked to judge sight unseen,
+        // which is the one thing a visual library must never produce.
+        ...args["no-images"] ? { screenshot_url: result.desktopShotUrl ?? null } : { screenshot: shots.get(result.id) ?? null },
+        ...full ? {
+          theme: result.theme,
+          density: result.density,
+          show_tell_rank: result.showTellRank,
+          interactions: result.interactions,
+          media: result.mediaKinds,
+          devices: result.contentDevices,
+          tags: result.tags,
+          headline: result.headline,
+          source_url: result.sourceUrl
+        } : {}
+      }));
+      const hints = [INSPIRATION_HINTS.adapt];
+      const scopeHints = body.scope === "favorites" ? favoritesScopeHints(data.favoritesHealth, rows.length) : [];
+      if (scopeHints.length > 0) {
+        hints.push(...scopeHints);
+      } else if (rows.length === 0) {
+        hints.push(
+          body.scope === "favorites" ? "No matches in this company's saved sections. Retry with --scope all to search the whole library, or add a page with `baker landing inspiration add <url>`." : "No matches. Loosen the filters, or add reference pages with `baker landing inspiration add <url>`."
+        );
+      }
+      if (rows.length > 0 && data.moreInFullLibrary > 0) {
+        hints.push(`${data.moreInFullLibrary} more match in the full library \u2014 re-run with --scope all.`);
+      }
+      if (shots.size > 0) hints.push(`Screenshots saved to .baker/inspiration/ \u2014 Read them before deciding.`);
+      writeJson({
+        ok: true,
+        data: {
+          results: rows,
+          scope: data.scope,
+          more_in_full_library: data.moreInFullLibrary,
+          total: data.total,
+          // Only present when there was something to explain, so a healthy
+          // search pays nothing for it.
+          ...data.favoritesHealth ? { saved_pages: data.favoritesHealth } : {}
+        },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  buildSearchBody,
+  searchCommand
+};
+//# sourceMappingURL=search-2SVUDZIX.js.map

package/dist/search-2SVUDZIX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/inspiration/search.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { InspirationSearchRequest, InspirationSearchResponse } from \"@baker/api/landing-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeJson } from \"../../../output.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { favoritesScopeHints, INSPIRATION_HINTS, parseNumber, reportError, splitList } from \"./shared.ts\";\nimport { downloadReadableShot, READABLE_SHOT } from \"./shot.ts\";\n\nregisterSchema({\n  command: \"landing.inspiration.search\",\n  description:\n    \"Search the shared library of real landing-page sections for reference before you design. Start here: baker landing inspiration search 'pricing with a monthly/annual toggle'. Returns the idea behind each section plus a downloaded screenshot you can Read. Defaults to this company's saved sections; pass --scope all for the whole library.\",\n  args: {\n    query: { type: \"string\", description: \"What you want to see, in plain English\", required: false },\n    type: {\n      type: \"string\",\n      description: \"Comma list of section types: hero,pricing,faq,testimonials,…\",\n      required: false,\n    },\n    composition: {\n      type: \"string\",\n      description: \"Comma list of composition patterns (references/composition.md)\",\n      required: false,\n    },\n    register: {\n      type: \"string\",\n      description: \"Comma list of visual registers: dev-tool-minimal,luxury-high-end,…\",\n      required: false,\n    },\n    interaction: { type: \"string\", description: \"Comma list of interaction patterns\", required: false },\n    motion: {\n      type: \"string\",\n      description: \"Comma list of motion kinds: scroll-reveal,marquee,parallax,…\",\n      required: false,\n    },\n    media: { type: \"string\", description: \"Comma list of media kinds\", required: false },\n    device: { type: \"string\", description: \"Comma list of content devices\", required: false },\n    theme: { type: \"string\", description: \"light | dark | mixed\", required: false },\n    \"max-rank\": {\n      type: \"number\",\n      description: \"Show>Tell rank ceiling 1-7; 3 means 'rank 3 or better'\",\n      required: false,\n    },\n    \"min-craft\": { type: \"number\", description: \"Craft floor 0-1\", required: false },\n    \"min-fidelity\": {\n      type: \"number\",\n      description: \"Only sections whose markup reproduces this well (0-1)\",\n      required: false,\n    },\n    domain: { type: \"string\", description: \"Restrict to one site\", required: false },\n    \"similar-to\": {\n      type: \"string\",\n      description: \"Section id — find sections that look like this one\",\n      required: false,\n    },\n    scope: { type: \"string\", description: \"favorites (default) | all\", required: false },\n    limit: { type: \"number\", description: \"Max results (default 8)\", required: false },\n    \"no-images\": { type: \"boolean\", description: \"Skip downloading screenshots\", required: false },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Add every classification facet (theme, density, rank, interactions, media, devices, tags, headline)\",\n      required: false,\n    },\n  },\n});\n\nexport function buildSearchBody(args: Record<string, unknown>): InspirationSearchRequest {\n  const body: InspirationSearchRequest = {};\n  const setList = (key: keyof InspirationSearchRequest, value: unknown) => {\n    const list = splitList(value as string | undefined);\n    if (list) Object.assign(body, { [key]: list });\n  };\n\n  if (args.query) body.query = String(args.query);\n  if (args[\"similar-to\"]) body.similarToSectionId = String(args[\"similar-to\"]);\n  setList(\"sectionType\", args.type);\n  setList(\"composition\", args.composition);\n  setList(\"visualRegister\", args.register);\n  setList(\"interaction\", args.interaction);\n  setList(\"motion\", args.motion);\n  setList(\"mediaKind\", args.media);\n  setList(\"contentDevice\", args.device);\n  if (args.theme) body.theme = String(args.theme) as InspirationSearchRequest[\"theme\"];\n  if (args.domain) body.domain = String(args.domain);\n\n  const maxRank = parseNumber(args[\"max-rank\"] as string | undefined);\n  if (maxRank !== undefined) body.maxShowTellRank = maxRank;\n  const minCraft = parseNumber(args[\"min-craft\"] as string | undefined);\n  if (minCraft !== undefined) body.minCraftScore = minCraft;\n  const minFidelity = parseNumber(args[\"min-fidelity\"] as string | undefined);\n  if (minFidelity !== undefined) body.minFidelity = minFidelity;\n  const limit = parseNumber(args.limit as string | undefined);\n  body.limit = limit ?? 8;\n  body.scope = args.scope === \"all\" ? \"all\" : \"favorites\";\n  return body;\n}\n\n/**\n * Put the screenshots on disk.\n *\n * The whole library is a visual one, and an agent that can only read a text\n * description of a section is working from exactly the second-hand doctrine this\n * was built to replace. Downloading each hit so it can be `Read` is the point.\n *\n * At the readable size, not the archive size — see `shot.ts`. This runs at the\n * default limit of eight hits, so the difference is eight 2x PNGs of context\n * against eight design-width renditions.\n */\nasync function downloadShots(results: InspirationSearchResponse[\"results\"]): Promise<Map<string, string>> {\n  const dir = path.join(process.cwd(), \".baker\", \"inspiration\");\n  const saved = new Map<string, string>();\n  await Promise.all(\n    results.map(async (result) => {\n      const file = await downloadReadableShot(\n        result.desktopShotUrl,\n        path.join(dir, `${result.id}.${READABLE_SHOT.extension}`),\n      );\n      if (file) saved.set(result.id, file);\n    }),\n  );\n  return saved;\n}\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description:\n      \"Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"What you want to see, in plain English\", required: false },\n    type: { type: \"string\", description: \"Comma list of section types\", required: false },\n    composition: { type: \"string\", description: \"Comma list of composition patterns\", required: false },\n    register: { type: \"string\", description: \"Comma list of visual registers\", required: false },\n    interaction: { type: \"string\", description: \"Comma list of interaction patterns\", required: false },\n    motion: { type: \"string\", description: \"Comma list of motion kinds\", required: false },\n    media: { type: \"string\", description: \"Comma list of media kinds\", required: false },\n    device: { type: \"string\", description: \"Comma list of content devices\", required: false },\n    theme: { type: \"string\", description: \"light | dark | mixed\", required: false },\n    \"max-rank\": { type: \"string\", description: \"Show>Tell rank ceiling 1-7\", required: false },\n    \"min-craft\": { type: \"string\", description: \"Craft floor 0-1\", required: false },\n    \"min-fidelity\": { type: \"string\", description: \"Reproduction-fidelity floor 0-1\", required: false },\n    domain: { type: \"string\", description: \"Restrict to one site\", required: false },\n    \"similar-to\": { type: \"string\", description: \"Section id to find lookalikes of\", required: false },\n    scope: { type: \"string\", description: \"favorites (default) | all\", required: false, default: \"favorites\" },\n    limit: { type: \"string\", description: \"Max results (default 8)\", required: false },\n    \"no-images\": { type: \"boolean\", description: \"Skip downloading screenshots\", required: false, default: false },\n    full: { type: \"boolean\", description: \"Include every classification facet\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const body = buildSearchBody(args as Record<string, unknown>);\n      const data = await apiPost<InspirationSearchResponse>(\"/api/landing-inspiration/search\", body);\n      const results = Array.isArray(data?.results) ? data.results : [];\n      const shots = (args[\"no-images\"] as boolean) ? new Map<string, string>() : await downloadShots(results);\n\n      const full = args.full as boolean;\n      const rows = results.map((result) => ({\n        id: result.id,\n        // The id `page` takes. Its own schema says \"from a search result's source\n        // id\", and until this line no projection emitted one — so the ordering\n        // view could only be reached straight after `add`, never from a search.\n        page_id: result.sourceId,\n        section: result.sectionType,\n        composition: result.composition,\n        look: result.visualRegister,\n        motion: result.motionSummary,\n        why_it_works: result.whyItWorks,\n        craft: Number(result.craftScore?.toFixed?.(2) ?? result.craftScore),\n        fidelity: result.fidelity,\n        domain: result.domain,\n        // Only worth saying when it means something: >1 marks a section the site\n        // reuses across its pages, which is a stronger signal than a one-off.\n        ...(result.pageCount > 1 ? { used_on_pages: result.pageCount } : {}),\n        // With --no-images there is no file, so hand back the URL instead. A row\n        // with neither is a section the agent is asked to judge sight unseen,\n        // which is the one thing a visual library must never produce.\n        ...((args[\"no-images\"] as boolean)\n          ? { screenshot_url: result.desktopShotUrl ?? null }\n          : { screenshot: shots.get(result.id) ?? null }),\n        ...(full\n          ? {\n              theme: result.theme,\n              density: result.density,\n              show_tell_rank: result.showTellRank,\n              interactions: result.interactions,\n              media: result.mediaKinds,\n              devices: result.contentDevices,\n              tags: result.tags,\n              headline: result.headline,\n              source_url: result.sourceUrl,\n            }\n          : {}),\n      }));\n\n      const hints = [INSPIRATION_HINTS.adapt];\n      // A thin favorites result is explained by the state of the saved set, not\n      // by the search — and the three states it can be in call for opposite\n      // next moves. The scope is never widened here; it is only made legible.\n      const scopeHints = body.scope === \"favorites\" ? favoritesScopeHints(data.favoritesHealth, rows.length) : [];\n      if (scopeHints.length > 0) {\n        hints.push(...scopeHints);\n      } else if (rows.length === 0) {\n        hints.push(\n          body.scope === \"favorites\"\n            ? \"No matches in this company's saved sections. Retry with --scope all to search the whole library, or add a page with `baker landing inspiration add <url>`.\"\n            : \"No matches. Loosen the filters, or add reference pages with `baker landing inspiration add <url>`.\",\n        );\n      }\n      if (rows.length > 0 && data.moreInFullLibrary > 0) {\n        hints.push(`${data.moreInFullLibrary} more match in the full library — re-run with --scope all.`);\n      }\n      if (shots.size > 0) hints.push(`Screenshots saved to .baker/inspiration/ — Read them before deciding.`);\n\n      writeJson({\n        ok: true,\n        data: {\n          results: rows,\n          scope: data.scope,\n          more_in_full_library: data.moreInFullLibrary,\n          total: data.total,\n          // Only present when there was something to explain, so a healthy\n          // search pays nothing for it.\n          ...(data.favoritesHealth ? { saved_pages: data.favoritesHealth } : {}),\n        },\n        hints,\n      });\n    } catch (error) {\n      reportError(error);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/search-34NFJ5F6.js

@@ -0,0 +1,26 @@
+import {
+  buildSearchBody,
+  designedByDefault,
+  searchCommand,
+  searchErrorFix,
+  searchHints,
+  searchRejection,
+  unknownCountryFix
+} from "./chunk-NOK7MSVJ.js";
+import "./chunk-BR32GHYD.js";
+import "./chunk-OIL6PU5W.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildSearchBody,
+  designedByDefault,
+  searchCommand,
+  searchErrorFix,
+  searchHints,
+  searchRejection,
+  unknownCountryFix
+};
+//# sourceMappingURL=search-34NFJ5F6.js.map

package/dist/search-34NFJ5F6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/search-AOFAN5NB.js

@@ -0,0 +1,174 @@
+import {
+  measureEmptyCorpus
+} from "./chunk-44VXKO65.js";
+import {
+  activeFilterFlags
+} from "./chunk-Q6ULQMWG.js";
+import {
+  testimonialSourceTypeSchema
+} from "./chunk-O6XZIQXZ.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema,
+  testimonialNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/search.ts
+import { defineCommand } from "citty";
+var FILTER_FLAGS = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
+function languageBiasHint(results, requestedLanguage) {
+  if (requestedLanguage) {
+    return null;
+  }
+  const withLang = results.filter((r) => typeof r.language === "string" && r.language.length > 0);
+  if (withLang.length < 3) {
+    return null;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const r of withLang) {
+    const lang = r.language;
+    counts.set(lang, (counts.get(lang) ?? 0) + 1);
+  }
+  const [topLang, topCount] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? ["", 0];
+  if (topLang && topCount / withLang.length >= 0.8) {
+    return `Results skew ${topLang} (${topCount}/${withLang.length}). If you're sourcing quotes for a specific market, pass --language <code> (e.g. --language en) so the ad's language matches its audience.`;
+  }
+  return null;
+}
+registerSchema({
+  command: "testimonials.search",
+  description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results to return", required: false, default: 10 },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false,
+      enum: [...testimonialSourceTypeSchema.options]
+    },
+    "rating-min": { type: "number", description: "Minimum star rating (1-5)", required: false },
+    "rating-max": { type: "number", description: "Maximum star rating (1-5)", required: false },
+    status: {
+      type: "string",
+      description: "Filter by status: pending|processing|ready|error",
+      required: false,
+      enum: ["pending", "processing", "ready", "error"]
+    },
+    sentiment: {
+      type: "string",
+      description: "Filter: positive|neutral|negative",
+      required: false,
+      enum: ["positive", "neutral", "negative"]
+    },
+    language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
+  }
+});
+function buildSearchRequest(query, args) {
+  const body = { query };
+  if (args.limit !== void 0) {
+    body.limit = Number(args.limit);
+  }
+  if (args.source) {
+    body.source = args.source;
+  }
+  if (args["rating-min"] !== void 0) {
+    body.rating_min = Number(args["rating-min"]);
+  }
+  if (args["rating-max"] !== void 0) {
+    body.rating_max = Number(args["rating-max"]);
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  if (args.sentiment) {
+    body.sentiment = args.sentiment;
+  }
+  if (args.language) {
+    body.language = args.language;
+  }
+  if (args.tags) {
+    body.tags = args.tags.split(",").filter(Boolean);
+  }
+  return body;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 10)", required: false },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false
+    },
+    "rating-min": { type: "string", description: "Minimum star rating (1-5)", required: false },
+    "rating-max": { type: "string", description: "Maximum star rating (1-5)", required: false },
+    status: { type: "string", description: "Filter by status: pending|processing|ready|error", required: false },
+    sentiment: { type: "string", description: "Filter: positive|neutral|negative", required: false },
+    language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    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 }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = buildSearchRequest(query, args);
+      const data = await apiPost("/api/testimonials/search", body);
+      const languageHint = languageBiasHint(data, body.language);
+      const { hints: emptyHints, empty } = await measureEmptyCorpus({
+        command: "search",
+        resultCount: data.length,
+        activeFilters: activeFilterFlags(args, FILTER_FLAGS)
+      });
+      const hints = [...emptyHints, ...languageHint ? [languageHint] : []];
+      const outputFormat = args.output || "json";
+      writeOutput(
+        { ok: true, data, ...empty ? { meta: { empty } } : {}, ...hints.length > 0 ? { hints } : {} },
+        outputFormat,
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        testimonialNormalizer
+      );
+      if (outputFormat !== "json") {
+        for (const hint of hints) {
+          process.stderr.write(`${hint}
+`);
+        }
+      }
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  searchCommand
+};
+//# sourceMappingURL=search-AOFAN5NB.js.map

package/dist/search-AOFAN5NB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/testimonials/search.ts"],"sourcesContent":["import {\n  type TestimonialsSearchRequest,\n  type TestimonialsSearchResponse,\n  testimonialSourceTypeSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { type OutputFormat, testimonialNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { activeFilterFlags } from \"../images/searchHints.ts\";\nimport { measureEmptyCorpus } from \"./emptyCorpusHints.ts\";\n\nconst FILTER_FLAGS = [\"source\", \"rating-min\", \"rating-max\", \"status\", \"sentiment\", \"language\", \"tags\"];\n\n/**\n * Hybrid search reranks over this company's whole corpus with no language\n * awareness, so a corpus seeded in one language returns that language even for\n * an English query. When the caller didn't pin a `--language` and the results\n * clearly skew to one, nudge them to scope by the target market's language —\n * otherwise a Spanish/French-heavy corpus silently starves a market-specific ad\n * of on-language quotes.\n */\nfunction languageBiasHint(results: TestimonialsSearchResponse, requestedLanguage: string | undefined): string | null {\n  if (requestedLanguage) {\n    return null;\n  }\n  const withLang = results.filter((r) => typeof r.language === \"string\" && r.language.length > 0);\n  if (withLang.length < 3) {\n    return null;\n  }\n  const counts = new Map<string, number>();\n  for (const r of withLang) {\n    const lang = r.language as string;\n    counts.set(lang, (counts.get(lang) ?? 0) + 1);\n  }\n  const [topLang, topCount] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? [\"\", 0];\n  if (topLang && topCount / withLang.length >= 0.8) {\n    return `Results skew ${topLang} (${topCount}/${withLang.length}). If you're sourcing quotes for a specific market, pass --language <code> (e.g. --language en) so the ad's language matches its audience.`;\n  }\n  return null;\n}\n\nregisterSchema({\n  command: \"testimonials.search\",\n  description: \"Search testimonials by text query. Uses hybrid BM25 + vector + reranking.\",\n  args: {\n    query: { type: \"string\", description: \"Search query text\", required: true },\n    limit: { type: \"number\", description: \"Maximum results to return\", required: false, default: 10 },\n    source: {\n      type: \"string\",\n      description: `Filter by source: ${testimonialSourceTypeSchema.options.join(\"|\")}`,\n      required: false,\n      enum: [...testimonialSourceTypeSchema.options],\n    },\n    \"rating-min\": { type: \"number\", description: \"Minimum star rating (1-5)\", required: false },\n    \"rating-max\": { type: \"number\", description: \"Maximum star rating (1-5)\", required: false },\n    status: {\n      type: \"string\",\n      description: \"Filter by status: pending|processing|ready|error\",\n      required: false,\n      enum: [\"pending\", \"processing\", \"ready\", \"error\"],\n    },\n    sentiment: {\n      type: \"string\",\n      description: \"Filter: positive|neutral|negative\",\n      required: false,\n      enum: [\"positive\", \"neutral\", \"negative\"],\n    },\n    language: { type: \"string\", description: \"Filter by language code (e.g. en, es)\", required: false },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n  },\n});\n\n/** Assemble the search request body from CLI args, applying only the flags that were provided. */\nfunction buildSearchRequest(query: string, args: Record<string, unknown>): TestimonialsSearchRequest {\n  const body: TestimonialsSearchRequest = { query };\n  if (args.limit !== undefined) {\n    body.limit = Number(args.limit);\n  }\n  if (args.source) {\n    body.source = args.source as TestimonialsSearchRequest[\"source\"];\n  }\n  if (args[\"rating-min\"] !== undefined) {\n    body.rating_min = Number(args[\"rating-min\"]);\n  }\n  if (args[\"rating-max\"] !== undefined) {\n    body.rating_max = Number(args[\"rating-max\"]);\n  }\n  if (args.status) {\n    body.status = args.status as TestimonialsSearchRequest[\"status\"];\n  }\n  if (args.sentiment) {\n    body.sentiment = args.sentiment as TestimonialsSearchRequest[\"sentiment\"];\n  }\n  if (args.language) {\n    body.language = args.language as string;\n  }\n  if (args.tags) {\n    body.tags = (args.tags as string).split(\",\").filter(Boolean);\n  }\n  return body;\n}\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description:\n      \"Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query text\", required: false },\n    limit: { type: \"string\", description: \"Max results (default 10)\", required: false },\n    source: {\n      type: \"string\",\n      description: `Filter by source: ${testimonialSourceTypeSchema.options.join(\"|\")}`,\n      required: false,\n    },\n    \"rating-min\": { type: \"string\", description: \"Minimum star rating (1-5)\", required: false },\n    \"rating-max\": { type: \"string\", description: \"Maximum star rating (1-5)\", required: false },\n    status: { type: \"string\", description: \"Filter by status: pending|processing|ready|error\", required: false },\n    sentiment: { type: \"string\", description: \"Filter: positive|neutral|negative\", required: false },\n    language: { type: \"string\", description: \"Filter by language code (e.g. en, es)\", required: false },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\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  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Search query is required\" } });\n        process.exit(1);\n      }\n\n      const body = buildSearchRequest(query, args);\n      const data = await apiPost<TestimonialsSearchResponse>(\"/api/testimonials/search\", body);\n      const languageHint = languageBiasHint(data, body.language);\n      const { hints: emptyHints, empty } = await measureEmptyCorpus({\n        command: \"search\",\n        resultCount: data.length,\n        activeFilters: activeFilterFlags(args, FILTER_FLAGS),\n      });\n      const hints = [...emptyHints, ...(languageHint ? [languageHint] : [])];\n      const outputFormat = (args.output as OutputFormat) || \"json\";\n      writeOutput(\n        { ok: true, data, ...(empty ? { meta: { empty } } : {}), ...(hints.length > 0 ? { hints } : {}) },\n        outputFormat,\n        args.fields ? args.fields.split(\",\") : undefined,\n        args.full as boolean,\n        testimonialNormalizer,\n      );\n      // md/files render only the table, so hints (which never reach the table)\n      // go to stderr — otherwise `--output md` hides the language skew, and an\n      // empty result prints a header row and nothing else.\n      if (outputFormat !== \"json\") {\n        for (const hint of hints) {\n          process.stderr.write(`${hint}\\n`);\n        }\n      }\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,SAAS,qBAAqB;AAO9B,IAAM,eAAe,CAAC,UAAU,cAAc,cAAc,UAAU,aAAa,YAAY,MAAM;AAUrG,SAAS,iBAAiB,SAAqC,mBAAsD;AACnH,MAAI,mBAAmB;AACrB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,QAAQ,OAAO,CAAC,MAAM,OAAO,EAAE,aAAa,YAAY,EAAE,SAAS,SAAS,CAAC;AAC9F,MAAI,SAAS,SAAS,GAAG;AACvB,WAAO;AAAA,EACT;AACA,QAAM,SAAS,oBAAI,IAAoB;AACvC,aAAW,KAAK,UAAU;AACxB,UAAM,OAAO,EAAE;AACf,WAAO,IAAI,OAAO,OAAO,IAAI,IAAI,KAAK,KAAK,CAAC;AAAA,EAC9C;AACA,QAAM,CAAC,SAAS,QAAQ,IAAI,CAAC,GAAG,OAAO,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;AAC1F,MAAI,WAAW,WAAW,SAAS,UAAU,KAAK;AAChD,WAAO,gBAAgB,OAAO,KAAK,QAAQ,IAAI,SAAS,MAAM;AAAA,EAChE;AACA,SAAO;AACT;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,UAAU,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAC1E,OAAO,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,GAAG;AAAA,IAChG,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa,qBAAqB,4BAA4B,QAAQ,KAAK,GAAG,CAAC;AAAA,MAC/E,UAAU;AAAA,MACV,MAAM,CAAC,GAAG,4BAA4B,OAAO;AAAA,IAC/C;AAAA,IACA,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM,CAAC,WAAW,cAAc,SAAS,OAAO;AAAA,IAClD;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM,CAAC,YAAY,WAAW,UAAU;AAAA,IAC1C;AAAA,IACA,UAAU,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IAClG,MAAM,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,EAC5F;AACF,CAAC;AAGD,SAAS,mBAAmB,OAAe,MAA0D;AACnG,QAAM,OAAkC,EAAE,MAAM;AAChD,MAAI,KAAK,UAAU,QAAW;AAC5B,SAAK,QAAQ,OAAO,KAAK,KAAK;AAAA,EAChC;AACA,MAAI,KAAK,QAAQ;AACf,SAAK,SAAS,KAAK;AAAA,EACrB;AACA,MAAI,KAAK,YAAY,MAAM,QAAW;AACpC,SAAK,aAAa,OAAO,KAAK,YAAY,CAAC;AAAA,EAC7C;AACA,MAAI,KAAK,YAAY,MAAM,QAAW;AACpC,SAAK,aAAa,OAAO,KAAK,YAAY,CAAC;AAAA,EAC7C;AACA,MAAI,KAAK,QAAQ;AACf,SAAK,SAAS,KAAK;AAAA,EACrB;AACA,MAAI,KAAK,WAAW;AAClB,SAAK,YAAY,KAAK;AAAA,EACxB;AACA,MAAI,KAAK,UAAU;AACjB,SAAK,WAAW,KAAK;AAAA,EACvB;AACA,MAAI,KAAK,MAAM;AACb,SAAK,OAAQ,KAAK,KAAgB,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,EAC7D;AACA,SAAO;AACT;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,cAAc,aAAa,qBAAqB,UAAU,MAAM;AAAA,IAC/E,OAAO,EAAE,MAAM,UAAU,aAAa,4BAA4B,UAAU,MAAM;AAAA,IAClF,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa,qBAAqB,4BAA4B,QAAQ,KAAK,GAAG,CAAC;AAAA,MAC/E,UAAU;AAAA,IACZ;AAAA,IACA,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,QAAQ,EAAE,MAAM,UAAU,aAAa,oDAAoD,UAAU,MAAM;AAAA,IAC3G,WAAW,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IAC/F,UAAU,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IAClG,MAAM,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IAC1F,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,IACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IACjG,MAAM,EAAE,MAAM,WAAW,aAAa,yBAAyB,UAAU,OAAO,SAAS,MAAM;AAAA,EACjG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,QAAQ,KAAK;AACnB,UAAI,CAAC,OAAO;AACV,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,2BAA2B,EAAE,CAAC;AACjG,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,OAAO,mBAAmB,OAAO,IAAI;AAC3C,YAAM,OAAO,MAAM,QAAoC,4BAA4B,IAAI;AACvF,YAAM,eAAe,iBAAiB,MAAM,KAAK,QAAQ;AACzD,YAAM,EAAE,OAAO,YAAY,MAAM,IAAI,MAAM,mBAAmB;AAAA,QAC5D,SAAS;AAAA,QACT,aAAa,KAAK;AAAA,QAClB,eAAe,kBAAkB,MAAM,YAAY;AAAA,MACrD,CAAC;AACD,YAAM,QAAQ,CAAC,GAAG,YAAY,GAAI,eAAe,CAAC,YAAY,IAAI,CAAC,CAAE;AACrE,YAAM,eAAgB,KAAK,UAA2B;AACtD;AAAA,QACE,EAAE,IAAI,MAAM,MAAM,GAAI,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAI,GAAI,MAAM,SAAS,IAAI,EAAE,MAAM,IAAI,CAAC,EAAG;AAAA,QAChG;AAAA,QACA,KAAK,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI;AAAA,QACvC,KAAK;AAAA,QACL;AAAA,MACF;AAIA,UAAI,iBAAiB,QAAQ;AAC3B,mBAAW,QAAQ,OAAO;AACxB,kBAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAAA,QAClC;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}