@12ui/design 0.2.80 → 0.2.82

package/dist/slate-site-references-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-capture.d.ts","sourceRoot":"","sources":["../src/slate-site-references-capture.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,eAAO,MAAM,gBAAgB;;;CAAwC,CAAC;AAUtE,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AA4E7F,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAwCtI,CAAC"}

package/dist/slate-site-references-capture.js

@@ -0,0 +1,119 @@
+import sharp from 'sharp';
+import { resolvePrototypeBrowserProvisioning } from './prototype-browsers.js';
+/**
+ * The capture step of the References tab: each suggested site opened headless in the Playwright Chromium the CLI
+ * already ships, at a desktop viewport, and photographed above the fold once the page has settled, with a trivial
+ * cookie banner accepted first. A page that does not open, answers an error, or stays blank is skipped (null).
+ */
+export const CAPTURE_VIEWPORT = { width: 1440, height: 900 };
+const THUMB_WIDTH = 640;
+const GOTO_TIMEOUT_MS = 25_000;
+const LOAD_WAIT_MS = 10_000;
+const IDLE_WAIT_MS = 4_000;
+/** Marketing pop-ups arrive on a timer (atlascoffeeclub.com's email form shows about 11 s after navigation): keep looking until then. */
+const POPUP_SETTLE_MS = 13_000;
+/** A real desktop Chrome's user agent: some sites turn a "HeadlessChrome" one away. */
+const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36';
+/**
+ * Page scripts, as plain source so no transpiler helper leaks into the page. CLEAR_OVERLAYS accepts a cookie banner and
+ * closes an overlay (a newsletter or region pop-up) when either is plainly marked and sits in fixed chrome or a dialog,
+ * looking into open shadow roots too, and answers how many it clicked. A close control may be icon-only: a button whose
+ * aria-label or title says close or dismiss, or a close-classed element inside a dialog or modal. HIDE_OVERLAYS then
+ * hides a fixed, viewport-sized dialog or modal that is still up. HAS_CONTENT answers whether the page painted.
+ */
+const CLEAR_OVERLAYS = String.raw `(() => {
+  var known = ["#onetrust-accept-btn-handler", "#CybotCookiebotDialogBodyLevelButtonLevelOptinAllowAll", "#truste-consent-button", "[data-testid=uc-accept-all-button]", ".cc-allow", ".cky-btn-accept", "#didomi-notice-agree-button"];
+  var accept = /^(accept|accept all|accept all cookies|accept cookies|allow all|allow all cookies|allow cookies|i agree|i accept|agree|agree and close|got it|ok|okay|i understand)$/i;
+  var dismiss = /^(no thanks|no, thanks|no thank you|not now|maybe later|close|close dialog|close modal|dismiss|×|✕|x|no thank you, i'm fine here|no thanks, i'm fine here|stay here)$/i;
+  var roots = [document];
+  document.querySelectorAll("*").forEach(function (node) { if (node.shadowRoot) roots.push(node.shadowRoot); });
+  function visible(node) { var box = node.getBoundingClientRect(); return box.width > 0 && box.height > 0 && getComputedStyle(node).visibility !== "hidden"; }
+  function label(node) { return ((node.textContent || "").replace(/\s+/g, " ").trim() || node.getAttribute("aria-label") || node.value || "").trim(); }
+  function overlaid(node) {
+    for (var at = node; at && at.nodeType === 1; at = at.parentElement || (at.getRootNode && at.getRootNode().host) || null) {
+      var position = getComputedStyle(at).position;
+      if (position === "fixed" || position === "sticky" || at.getAttribute("role") === "dialog" || at.getAttribute("aria-modal") === "true") return true;
+    }
+    return false;
+  }
+  function iconClose(node) {
+    var name = node.getAttribute("aria-label") || node.getAttribute("title") || "";
+    return /\b(close|dismiss)\b/i.test(name) && node.tagName !== "A";
+  }
+  function closeClassed(node) {
+    return /(^|[\s_-])close([\s_-]|$)/i.test(String(node.getAttribute("class") || "")) && !!node.closest("[role=dialog], [aria-modal=true], [class*=modal], [class*=popup], [class*=dialog]");
+  }
+  var clicked = 0;
+  roots.forEach(function (root) {
+    known.forEach(function (selector) { var node = root.querySelector(selector); if (node && visible(node)) { node.click(); clicked += 1; } });
+    root.querySelectorAll("button, [role=button], a, input[type=button], input[type=submit]").forEach(function (node) {
+      if (!visible(node)) return;
+      var text = label(node);
+      // A link only ever accepts: a close word on a link (an X profile, say) could leave the page.
+      if ((accept.test(text) || (dismiss.test(text) && node.tagName !== "A") || iconClose(node)) && overlaid(node)) { node.click(); clicked += 1; }
+    });
+    root.querySelectorAll("[class*=close]").forEach(function (node) {
+      if (visible(node) && closeClassed(node) && node.tagName !== "A" && !node.querySelector("button, [role=button]")) { node.click(); clicked += 1; }
+    });
+  });
+  return clicked;
+})()`;
+const HIDE_OVERLAYS = String.raw `(() => {
+  var hidden = 0;
+  var marked = /modal|popup|dialog|overlay|backdrop|lightbox/i;
+  document.querySelectorAll("body *").forEach(function (node) {
+    var style = getComputedStyle(node);
+    if (style.position !== "fixed" || style.display === "none" || style.visibility === "hidden") return;
+    var box = node.getBoundingClientRect();
+    if (box.width < innerWidth * 0.9 || box.height < innerHeight * 0.9) return;
+    var named = node.getAttribute("role") === "dialog" || node.getAttribute("aria-modal") === "true" || marked.test(String(node.getAttribute("class") || "") + " " + node.id);
+    if (named) { node.style.setProperty("display", "none", "important"); hidden += 1; }
+  });
+  return hidden;
+})()`;
+const HAS_CONTENT = '((document.body && document.body.innerText || "").trim().length > 40 || document.images.length > 2)';
+const quietly = async (work) => { await work.catch(() => undefined); };
+export const openSiteCapture = async () => {
+    const provisioning = await resolvePrototypeBrowserProvisioning();
+    process.env.PLAYWRIGHT_BROWSERS_PATH = provisioning.browsersPath;
+    const { chromium } = await import('@playwright/test');
+    const browser = await chromium.launch();
+    const capture = async (url) => {
+        const context = await browser.newContext({ viewport: CAPTURE_VIEWPORT, deviceScaleFactor: 1, userAgent: USER_AGENT, locale: 'en-US', colorScheme: 'light' });
+        try {
+            const page = await context.newPage();
+            const startedAt = Date.now();
+            const response = await page.goto(url, { waitUntil: 'domcontentloaded', timeout: GOTO_TIMEOUT_MS });
+            if (!response || response.status() >= 400)
+                return null;
+            await quietly(page.waitForLoadState('load', { timeout: LOAD_WAIT_MS }));
+            await quietly(page.waitForLoadState('networkidle', { timeout: IDLE_WAIT_MS }));
+            // Banners and pop-ups often arrive a moment after load, some on a timer: clear them, then look again until the
+            // settle time has passed.
+            for (let pass = 0; pass === 0 || Date.now() - startedAt < POPUP_SETTLE_MS; pass += 1) {
+                await page.waitForTimeout(pass === 0 ? 800 : 1_000);
+                await page.evaluate(CLEAR_OVERLAYS).catch(() => 0);
+                // A pop-up that listens for Escape closes with it.
+                await quietly(page.keyboard.press('Escape'));
+            }
+            // A dialog that survived every click is hidden rather than photographed.
+            await quietly(page.evaluate(HIDE_OVERLAYS));
+            // Above the fold: a click or a focus may have scrolled the page.
+            await quietly(page.evaluate('window.scrollTo(0, 0)'));
+            await page.waitForTimeout(500);
+            if (!(await page.evaluate(HAS_CONTENT).catch(() => false)))
+                return null;
+            const image = await page.screenshot({ type: 'jpeg', quality: 82, clip: { x: 0, y: 0, ...CAPTURE_VIEWPORT } });
+            const thumb = await sharp(image).resize({ width: THUMB_WIDTH }).jpeg({ quality: 78, mozjpeg: true }).toBuffer();
+            return { image, thumb, title: (await page.title().catch(() => '')).trim(), finalUrl: page.url() };
+        }
+        catch {
+            return null;
+        }
+        finally {
+            await quietly(context.close());
+        }
+    };
+    return { capture, close: async () => { await quietly(browser.close()); } };
+};
+//# sourceMappingURL=slate-site-references-capture.js.map

package/dist/slate-site-references-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-capture.js","sourceRoot":"","sources":["../src/slate-site-references-capture.ts"],"names":[],"mappings":"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"}

package/dist/slate-site-references-client.d.ts

@@ -0,0 +1,35 @@
+import { type DrawFetch } from './workspace-draw-client.js';
+/**
+ * The References tab's two calls on design.12ui.com, authenticated by the workspace's upload token like the draw
+ * command's: what to look for (the brief, and the sites already added), and one captured site.
+ */
+export type SitesBrief = {
+    concept: string;
+    corpusQuery: string | null;
+    sites: {
+        id: string;
+        url: string;
+    }[];
+    max: number;
+};
+export type SitePush = {
+    url: string;
+    title: string;
+    why: string;
+    image: Buffer;
+    thumb: Buffer;
+};
+export declare const createSitesClient: (args: {
+    origin: string;
+    token: string;
+    cliVersion: string;
+    fetch?: DrawFetch;
+}) => {
+    brief: () => Promise<SitesBrief>;
+    push: (site: SitePush) => Promise<{
+        id: string;
+        replayed: boolean;
+    }>;
+};
+export type SitesClient = ReturnType<typeof createSitesClient>;
+//# sourceMappingURL=slate-site-references-client.d.ts.map

package/dist/slate-site-references-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-client.d.ts","sourceRoot":"","sources":["../src/slate-site-references-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5G;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5H,MAAM,MAAM,QAAQ,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,eAAO,MAAM,iBAAiB,GAAI,MAAM;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE;iBAa3F,OAAO,CAAC,UAAU,CAAC;iBAUjB,QAAQ,KAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAW3E,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/slate-site-references-client.js

@@ -0,0 +1,36 @@
+import { CLI_HEADER, NO_REDIRECT, PUSH_HEADER, readBody } from './workspace-draw-client.js';
+export const createSitesClient = (args) => {
+    const fetcher = args.fetch ?? ((url, init) => fetch(url, init));
+    const url = `${args.origin}/api/v1/slate/sites`;
+    const headers = { [PUSH_HEADER]: args.token, [CLI_HEADER]: args.cliVersion };
+    const call = async (init) => {
+        const response = await fetcher(url, { ...init, redirect: NO_REDIRECT, headers: { ...headers, ...init.headers } });
+        const body = await readBody(response);
+        if (!response.ok || !body || typeof body !== 'object')
+            throw new Error(`${url} answered ${response.status}${typeof body === 'object' && body ? ` ${JSON.stringify(body.error ?? '')}` : ''}`);
+        return body;
+    };
+    return {
+        brief: async () => {
+            const body = await call({ method: 'GET' });
+            const brief = (body.brief ?? {});
+            return {
+                concept: typeof brief.concept === 'string' ? brief.concept : '',
+                corpusQuery: typeof brief.corpusQuery === 'string' ? brief.corpusQuery : null,
+                sites: Array.isArray(body.sites) ? body.sites : [],
+                max: typeof body.max === 'number' ? body.max : 12,
+            };
+        },
+        push: async (site) => {
+            const form = new FormData();
+            form.append('url', site.url);
+            form.append('title', site.title);
+            form.append('why', site.why);
+            form.append('image', new Blob([new Uint8Array(site.image)], { type: 'image/jpeg' }), 'image.jpg');
+            form.append('thumb', new Blob([new Uint8Array(site.thumb)], { type: 'image/jpeg' }), 'thumb.jpg');
+            const body = await call({ method: 'POST', body: form });
+            return { id: String(body.id), replayed: body.replayed === true };
+        },
+    };
+};
+//# sourceMappingURL=slate-site-references-client.js.map

package/dist/slate-site-references-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-client.js","sourceRoot":"","sources":["../src/slate-site-references-client.ts"],"names":[],"mappings":"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"}

package/dist/slate-site-references-local.d.ts

@@ -0,0 +1,6 @@
+import type { SitePush } from './slate-site-references-client.js';
+export declare const localSiteId: (url: string) => string;
+export declare const addLocalSite: (root: string, site: SitePush) => Promise<string>;
+/** Gather once per workspace per server process; a workspace that already has its sites gathers nothing. */
+export declare const startLocalReferences: (root: string, env?: NodeJS.ProcessEnv) => void;
+//# sourceMappingURL=slate-site-references-local.d.ts.map

package/dist/slate-site-references-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-local.d.ts","sourceRoot":"","sources":["../src/slate-site-references-local.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAgBlE,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAuD,CAAC;AAOlG,eAAO,MAAM,YAAY,GAAU,MAAM,MAAM,EAAE,MAAM,QAAQ,KAAG,OAAO,CAAC,MAAM,CAe/E,CAAC;AAIF,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,MAAK,MAAM,CAAC,UAAwB,KAAG,IAezF,CAAC"}

package/dist/slate-site-references-local.js

@@ -0,0 +1,63 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import sharp from 'sharp';
+import { sha256Hex } from './slate-ids.js';
+import { referenceFile } from './slate-paths.js';
+import { gatherSiteReferences, SITE_TARGET } from './slate-site-references.js';
+import { loadWorkspaceAt, mutateWorkspace, NoWrite } from './slate-workspace-store.js';
+/**
+ * The local plugin's References tab: the same gathering as the hosted workspace's, started by the local MCP server the
+ * first time it shows a workspace with fewer than a dozen sites. Each site's screenshot is cached as that reference's
+ * pictures (`inspiration/<id>.ref.png` and `.thumb.png`), so the reference tool, the selection and the local runner's
+ * draws take it like any reference, and the record names it in `sites`.
+ */
+/** `site-` and 16 hex of sha256 of the page address without its fragment: the hosted server's id for the same page. */
+const pageOf = (url) => {
+    const page = new URL(url);
+    page.hash = '';
+    return page.href;
+};
+export const localSiteId = (url) => `site-${sha256Hex(pageOf(url)).slice(0, 16)}`;
+const writePng = async (file, jpeg) => {
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    await writeFile(file, await sharp(jpeg).png().toBuffer(), { mode: 0o600 });
+};
+export const addLocalSite = async (root, site) => {
+    const id = localSiteId(site.url);
+    // The same page again keeps its first screenshot.
+    if (((await loadWorkspaceAt(root, () => new Date())).workspace.sites ?? []).some((entry) => entry.referenceId === id))
+        return id;
+    await writePng(referenceFile(root, id, 'ref'), site.image);
+    await writePng(referenceFile(root, id, 'thumb'), site.thumb);
+    const { width, height } = await sharp(site.image).metadata();
+    await mutateWorkspace(root, (workspace) => {
+        const sites = workspace.sites ?? [];
+        if (sites.some((entry) => entry.referenceId === id))
+            return new NoWrite(undefined);
+        workspace.sites = [...sites, { referenceId: id, url: pageOf(site.url), title: site.title.slice(0, 200), why: site.why ? site.why.slice(0, 500) : null }];
+        workspace.references[id] = { referenceId: id, aspect: 'landscape', width: width ?? null, height: height ?? null, description: site.title.slice(0, 200), uiType: 'website' };
+        return undefined;
+    });
+    return id;
+};
+const started = new Set();
+/** Gather once per workspace per server process; a workspace that already has its sites gathers nothing. */
+export const startLocalReferences = (root, env = process.env) => {
+    if (started.has(root))
+        return;
+    started.add(root);
+    void (async () => {
+        const { workspace } = await loadWorkspaceAt(root, () => new Date());
+        const existing = (workspace.sites ?? []).map((site) => site.url);
+        if (existing.length >= SITE_TARGET)
+            return;
+        await gatherSiteReferences({
+            brief: workspace.brief.concept,
+            existing,
+            env,
+            progress: (line) => { process.stderr.write(`${line}\n`); },
+            push: async (site) => { await addLocalSite(root, site); },
+        });
+    })().catch((error) => { process.stderr.write(`12ui references: stopped: ${error instanceof Error ? error.message : String(error)}\n`); });
+};
+//# sourceMappingURL=slate-site-references-local.js.map

package/dist/slate-site-references-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-local.js","sourceRoot":"","sources":["../src/slate-site-references-local.ts"],"names":[],"mappings":"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"}

package/dist/slate-site-references-suggest.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The suggest step of the References tab: the person's own agent CLI, with live web search, names real websites that
+ * are relevant to the design request. Several run at once, each from its own angle, so the tab mixes direct
+ * competitors, the best of the category and design-forward neighbours. It costs the person their own agent's usage and
+ * nothing on 12ui.
+ *
+ * Codex runs `codex exec` without the person's config (their instructions and MCP servers are not this task's), in a
+ * read-only sandbox, ephemeral, with web search live and a JSON schema for the answer. Claude runs `claude -p` with
+ * only its web tools.
+ */
+export type SiteSuggestion = {
+    url: string;
+    name: string;
+    why: string;
+    angle: SuggestAngle;
+};
+export type SuggestAngle = 'competitors' | 'best' | 'adjacent';
+export type SuggestEngine = {
+    kind: 'codex' | 'claude';
+    binary: string;
+};
+export declare const SUGGEST_ANGLES: readonly SuggestAngle[];
+export declare const SITES_PER_ANGLE = 6;
+export declare const suggestPrompt: (brief: string, angle: SuggestAngle) => string;
+/** Claude when this runs under Claude Code, else Codex; whichever exists when the preferred one does not. */
+export declare const chooseSuggestEngine: (env: NodeJS.ProcessEnv) => SuggestEngine | null;
+/** The first JSON object in a text that has a `sites` list. */
+export declare const parseSites: (text: string, angle: SuggestAngle) => SiteSuggestion[];
+/** One angle's suggestions; an agent that fails or answers nothing gives none. */
+export declare const suggestSites: (args: {
+    engine: SuggestEngine;
+    brief: string;
+    angle: SuggestAngle;
+    env: NodeJS.ProcessEnv;
+}) => Promise<SiteSuggestion[]>;
+//# sourceMappingURL=slate-site-references-suggest.d.ts.map

package/dist/slate-site-references-suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-suggest.d.ts","sourceRoot":"","sources":["../src/slate-site-references-suggest.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAC7F,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAwC,CAAC;AAC3F,eAAO,MAAM,eAAe,IAAI,CAAC;AASjC,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,OAAO,YAAY,KAAG,MAOvD,CAAC;AAiCb,6GAA6G;AAC7G,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,CAAC,UAAU,KAAG,aAAa,GAAG,IAO5E,CAAC;AAcF,+DAA+D;AAC/D,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,OAAO,YAAY,KAAG,cAAc,EAwB5E,CAAC;AAgCF,kFAAkF;AAClF,eAAO,MAAM,YAAY,GAAU,MAAM;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAAG,OAAO,CAAC,cAAc,EAAE,CAKxJ,CAAC"}

package/dist/slate-site-references-suggest.js

@@ -0,0 +1,144 @@
+import { spawn } from 'node:child_process';
+import { accessSync, constants } from 'node:fs';
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { locateCodexBinary } from './codex-binary.js';
+export const SUGGEST_ANGLES = ['competitors', 'best', 'adjacent'];
+export const SITES_PER_ANGLE = 6;
+const SUGGEST_TIMEOUT_MS = 240_000;
+const ANGLE_ASK = {
+    competitors: 'direct competitors: companies that offer the same kind of product or service to the same people',
+    best: 'the best-designed websites in this category, the ones designers point to as the standard',
+    adjacent: 'design-forward websites from neighbouring categories whose look and layout would inspire this design',
+};
+export const suggestPrompt = (brief, angle) => [
+    `A designer is about to design this: ${brief}`,
+    '',
+    `Find ${SITES_PER_ANGLE} real, live websites that are ${ANGLE_ASK[angle]}.`,
+    'Use web search to make sure each one exists today. Give the exact page to look at (usually the homepage), the brand',
+    'name, and one short line on what is worth seeing in its design. Only public websites a browser can open without',
+    'signing in: no marketplaces, app stores, articles, directories or social media. Be quick: a few searches are enough.',
+].join('\n');
+const SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['sites'],
+    properties: {
+        sites: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['url', 'name', 'why'],
+                properties: { url: { type: 'string' }, name: { type: 'string' }, why: { type: 'string' } },
+            },
+        },
+    },
+};
+const onPath = (env, name) => {
+    for (const directory of (env.PATH ?? '').split(path.delimiter)) {
+        if (directory === '')
+            continue;
+        const candidate = path.join(directory, name);
+        try {
+            accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch {
+            // not here
+        }
+    }
+    return null;
+};
+/** Claude when this runs under Claude Code, else Codex; whichever exists when the preferred one does not. */
+export const chooseSuggestEngine = (env) => {
+    const codex = locateCodexBinary(env)?.binary ?? null;
+    const claude = onPath(env, 'claude');
+    const preferClaude = env.CLAUDECODE === '1';
+    if (preferClaude && claude)
+        return { kind: 'claude', binary: claude };
+    if (codex)
+        return { kind: 'codex', binary: codex };
+    return claude ? { kind: 'claude', binary: claude } : null;
+};
+const run = (binary, args, options) => (new Promise((resolve, reject) => {
+    const child = spawn(binary, args, { cwd: options.cwd, env: options.env, stdio: ['ignore', 'pipe', 'pipe'] });
+    let stdout = '';
+    child.stdout.setEncoding('utf8').on('data', (chunk) => { stdout += chunk; });
+    child.stderr.resume();
+    const timer = setTimeout(() => { child.kill('SIGTERM'); }, SUGGEST_TIMEOUT_MS);
+    child.on('error', (error) => { clearTimeout(timer); reject(error); });
+    child.on('close', (code) => { clearTimeout(timer); resolve({ code, stdout }); });
+}));
+/** The first JSON object in a text that has a `sites` list. */
+export const parseSites = (text, angle) => {
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    if (start < 0 || end <= start)
+        return [];
+    let value;
+    try {
+        value = JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        return [];
+    }
+    const sites = value.sites;
+    if (!Array.isArray(sites))
+        return [];
+    return sites.flatMap((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return [];
+        const { url, name, why } = entry;
+        if (typeof url !== 'string')
+            return [];
+        try {
+            const parsed = new URL(url.trim());
+            if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:')
+                return [];
+            return [{ url: parsed.href, name: typeof name === 'string' ? name.trim() : '', why: typeof why === 'string' ? why.trim() : '', angle }];
+        }
+        catch {
+            return [];
+        }
+    });
+};
+const suggestWithCodex = async (engine, prompt, angle, env) => {
+    const dir = await mkdtemp(path.join(tmpdir(), '12ui-sites-'));
+    try {
+        const schema = path.join(dir, 'schema.json');
+        const out = path.join(dir, 'answer.json');
+        await writeFile(schema, JSON.stringify(SCHEMA));
+        await run(engine.binary, [
+            'exec', '--ignore-user-config', '--ephemeral', '--skip-git-repo-check', '-s', 'read-only',
+            '-c', 'web_search="live"', '-c', 'model_reasoning_effort="low"',
+            '--output-schema', schema, '-o', out, prompt,
+        ], { cwd: dir, env });
+        return parseSites(await readFile(out, 'utf8').catch(() => ''), angle);
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+};
+const suggestWithClaude = async (engine, prompt, angle, env) => {
+    const dir = await mkdtemp(path.join(tmpdir(), '12ui-sites-'));
+    try {
+        const answer = await run(engine.binary, [
+            '-p', `${prompt}\n\nAnswer with only this JSON and nothing else: {"sites":[{"url":"...","name":"...","why":"..."}]}`,
+            '--allowedTools', 'WebSearch,WebFetch', '--output-format', 'text', '--model', 'sonnet',
+        ], { cwd: dir, env });
+        return parseSites(answer.stdout, angle);
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+};
+/** One angle's suggestions; an agent that fails or answers nothing gives none. */
+export const suggestSites = async (args) => {
+    const prompt = suggestPrompt(args.brief, args.angle);
+    return args.engine.kind === 'codex'
+        ? await suggestWithCodex(args.engine, prompt, args.angle, args.env)
+        : await suggestWithClaude(args.engine, prompt, args.angle, args.env);
+};
+//# sourceMappingURL=slate-site-references-suggest.js.map

package/dist/slate-site-references-suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references-suggest.js","sourceRoot":"","sources":["../src/slate-site-references-suggest.ts"],"names":[],"mappings":"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"}

package/dist/slate-site-references.d.ts

@@ -0,0 +1,57 @@
+import { type CapturedSite } from './slate-site-references-capture.js';
+import { type SitePush } from './slate-site-references-client.js';
+import { type SiteSuggestion, type SuggestAngle, type SuggestEngine } from './slate-site-references-suggest.js';
+import type { DrawFetch } from './workspace-draw-client.js';
+/**
+ * The References tab's gathering, start to finish: several agents suggest real sites from different angles at once,
+ * each suggestion is captured as soon as its agent answers, and each screenshot is pushed the moment it is taken, so
+ * the tab fills while the person looks at it. About a dozen sites, one per domain, the angles interleaved; a site that
+ * fails is skipped and the next suggestion takes its place.
+ */
+export declare const SITE_TARGET = 12;
+export type GatherReport = {
+    engine: SuggestEngine['kind'] | null;
+    suggested: number;
+    pushed: number;
+    firstMs: number | null;
+    lastMs: number | null;
+};
+export type GatherDependencies = {
+    suggest?: (args: {
+        engine: SuggestEngine;
+        brief: string;
+        angle: SuggestAngle;
+        env: NodeJS.ProcessEnv;
+    }) => Promise<SiteSuggestion[]>;
+    openCapture?: () => Promise<{
+        capture: (url: string) => Promise<CapturedSite | null>;
+        close: () => Promise<void>;
+    }>;
+    now?: () => number;
+};
+/** What the agents are told the design is: the request, plus the short visual caption when there is one. */
+export declare const briefText: (concept: string, corpusQuery: string | null) => string;
+export declare const gatherSiteReferences: (args: {
+    brief: string;
+    /** Pages already in the workspace: their domains are not suggested again, and they count toward the target. */
+    existing: string[];
+    target?: number;
+    env: NodeJS.ProcessEnv;
+    progress: (line: string) => void;
+    push: (site: SitePush) => Promise<void>;
+    deps?: GatherDependencies;
+}) => Promise<GatherReport>;
+/**
+ * The hosted workspace's gathering: reads the request and the sites already added through the upload token, gathers,
+ * and pushes each site to design.12ui.com. A workspace that already has its references gathers nothing.
+ */
+export declare const gatherWorkspaceReferences: (args: {
+    origin: string;
+    token: string;
+    cliVersion: string;
+    env: NodeJS.ProcessEnv;
+    progress: (line: string) => void;
+    fetch?: DrawFetch;
+    deps?: GatherDependencies;
+}) => Promise<GatherReport | null>;
+//# sourceMappingURL=slate-site-references.d.ts.map

package/dist/slate-site-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-site-references.d.ts","sourceRoot":"","sources":["../src/slate-site-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AACrF,OAAO,EAAqD,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnK,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,KAAK,CAAC;AAK9B,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEtJ,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACrI,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;IACpH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAUF,4GAA4G;AAC5G,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,EAAE,aAAa,MAAM,GAAG,IAAI,KAAG,MAEvE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,KAAG,OAAO,CAAC,YAAY,CAgFvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAY9B,CAAC"}