zugzbot 1.0.21 → 1.0.23

package/.opencode/oh-my-design/web/src/lib/fonts/designmd-export.ts

@@ -1,104 +0,0 @@
-/**
- * Font Playground → DESIGN.md §3 snippet generator.
- *
- * Emits a copy-ready Typography section compatible with OmD v0.1. Intended
- * to be pasted into a project's DESIGN.md or handed to an AI coding agent
- * (Claude Code, Cursor) as brand context.
- */
-
-import type { FontEntry } from "./types";
-import type { LiveSelection } from "./tweaks";
-import { buildGoogleFontsHref, buildVariationSettings } from "./loaders";
-
-export function buildDesignMdSnippet(
-  font: FontEntry,
-  selection: LiveSelection,
-): string {
-  const loaderLine =
-    font.loader.kind === "google"
-      ? `Google Fonts — ${buildGoogleFontsHref([font])}`
-      : `jsdelivr @font-face (see snippet)`;
-
-  const lines: string[] = [];
-  lines.push(`## 3. Typography Rules`);
-  lines.push("");
-  lines.push(`### Family`);
-  lines.push("");
-  lines.push(`- **Primary**: \`${font.cssFamily}\``);
-  lines.push(`- **Source**: ${loaderLine}`);
-  lines.push(`- **License**: ${font.license} — [${font.source}](${font.source})`);
-  if (font.designer) lines.push(`- **Designer**: ${font.designer}`);
-  lines.push(`- **Scripts supported**: ${font.scripts.join(", ")}`);
-  lines.push("");
-
-  lines.push(`### Weight`);
-  lines.push("");
-  if (font.variable) {
-    const wght = selection.axisValues.wght;
-    const axis = font.axes.find((a) => a.tag === "wght");
-    if (axis) {
-      lines.push(`- **Selected**: \`${Math.round(wght)}\``);
-      lines.push(`- **Range**: \`${axis.min}–${axis.max}\` (variable)`);
-    }
-  } else if (font.weights) {
-    lines.push(`- **Selected**: \`${selection.staticWeight}\``);
-    lines.push(`- **Available weights**: ${font.weights.map((w) => `\`${w}\``).join(", ")}`);
-  }
-  lines.push("");
-
-  if (font.variable && font.axes.length > 0) {
-    lines.push(`### Variable axes`);
-    lines.push("");
-    lines.push(`| Axis | Tag | Value |`);
-    lines.push(`|---|---|---|`);
-    for (const a of font.axes) {
-      const v = selection.axisValues[a.tag];
-      const display = v == null ? "—" : Number.isInteger(v) ? String(v) : v.toFixed(2);
-      lines.push(`| ${a.name} | \`${a.tag}\` | \`${display}\` |`);
-    }
-    lines.push("");
-    const vs = buildVariationSettings(selection.axisValues);
-    if (vs) {
-      lines.push(`CSS:`);
-      lines.push("");
-      lines.push("```css");
-      lines.push(`font-variation-settings: ${vs};`);
-      lines.push("```");
-      lines.push("");
-    }
-  }
-
-  if (selection.letterSpacing !== 0) {
-    lines.push(`### Letter-spacing`);
-    lines.push("");
-    const em = selection.letterSpacing.toFixed(3);
-    lines.push(`- **Tracking**: \`${em}em\` (${selection.letterSpacing < 0 ? "tighter" : "looser"} than default)`);
-    lines.push("");
-  }
-
-  lines.push(`### Line-height`);
-  lines.push("");
-  lines.push(
-    `- **Default**: \`${selection.lineHeight.toFixed(2)}\` (unitless, scales with font-size)`,
-  );
-  lines.push(
-    `- **Guidance**: body copy usually 1.5–1.6, display/heading 1.05–1.2, captions 1.3–1.4`,
-  );
-  lines.push("");
-
-  lines.push(`### Do's and Don'ts`);
-  lines.push("");
-  lines.push(`- Keep body text in this family for rhythm consistency`);
-  lines.push(
-    `- Avoid mixing more than two weights on a single surface (use only the selected weight + a display weight)`,
-  );
-  lines.push(
-    `- Respect the license: **${font.license}** requires that the license text travel with any font file redistribution`,
-  );
-  lines.push("");
-
-  lines.push(
-    `<!-- Exported via oh-my-design Font Playground. Font is ${font.license}-licensed; output files inherit the license. -->`,
-  );
-  return lines.join("\n");
-}

package/.opencode/oh-my-design/web/src/lib/fonts/loaders.test.ts

@@ -1,169 +0,0 @@
-/**
- * Loader + export-CSS builder tests. These are the artefacts users copy
- * straight into their projects, so the output has to be stable —
- * regressions here would silently ship broken stylesheets.
- */
-
-import { describe, expect, it } from "vitest";
-import type { FontEntry } from "./types";
-import {
-  buildExportCss,
-  buildGoogleFontsHref,
-  buildJsdelivrCss,
-  buildVariationSettings,
-} from "./loaders";
-
-function googleVariableFont(): FontEntry {
-  return {
-    id: "x-inter",
-    name: "Inter",
-    family: "sans",
-    scripts: ["latin"],
-    cssFamily: `"Inter", sans-serif`,
-    variable: true,
-    axes: [{ tag: "wght", name: "Weight", min: 100, max: 900, default: 400 }],
-    license: "OFL-1.1",
-    source: "https://fonts.google.com/specimen/Inter",
-    description: "",
-    loader: { kind: "google", family: "Inter:wght@100..900" },
-    tags: { mood: [], era: [], use: [], personality: [] },
-    sampleText: { latin: "Aa" },
-  };
-}
-
-function jsdelivrFont(): FontEntry {
-  return {
-    id: "x-gmarket",
-    name: "Gmarket Sans",
-    family: "sans",
-    scripts: ["hangul"],
-    cssFamily: `"Gmarket Sans", sans-serif`,
-    variable: false,
-    axes: [],
-    weights: [300, 500, 700],
-    license: "GmarketSans Free License",
-    source: "https://noonnu.cc",
-    description: "",
-    loader: {
-      kind: "jsdelivr",
-      fontFaceCss: "@font-face { font-family: 'Gmarket Sans'; src: url(...); }",
-    },
-    tags: { mood: [], era: [], use: [], personality: [] },
-    sampleText: { hangul: "가" },
-  };
-}
-
-describe("buildGoogleFontsHref", () => {
-  it("returns null when no google-loader entries are present", () => {
-    expect(buildGoogleFontsHref([])).toBeNull();
-    expect(buildGoogleFontsHref([jsdelivrFont()])).toBeNull();
-  });
-
-  it("emits a css2 URL with display=swap", () => {
-    const url = buildGoogleFontsHref([googleVariableFont()]);
-    expect(url).toContain("fonts.googleapis.com/css2?");
-    expect(url).toContain("display=swap");
-  });
-
-  it("sorts family segments so the URL is deterministic (cache-friendly)", () => {
-    const b = { ...googleVariableFont(), id: "b", loader: { kind: "google", family: "B" } as const };
-    const a = { ...googleVariableFont(), id: "a", loader: { kind: "google", family: "A" } as const };
-    const out1 = buildGoogleFontsHref([a, b])!;
-    const out2 = buildGoogleFontsHref([b, a])!;
-    expect(out1).toBe(out2);
-    // A= segment appears before B= in the final URL
-    expect(out1.indexOf("family=A")).toBeLessThan(out1.indexOf("family=B"));
-  });
-
-  it("ignores jsdelivr entries when assembling the URL", () => {
-    const url = buildGoogleFontsHref([googleVariableFont(), jsdelivrFont()])!;
-    expect(url).toContain("Inter");
-    expect(url).not.toContain("Gmarket");
-  });
-});
-
-describe("buildJsdelivrCss", () => {
-  it("concatenates every jsdelivr entry's @font-face block", () => {
-    const css = buildJsdelivrCss([googleVariableFont(), jsdelivrFont()]);
-    expect(css).toContain("@font-face");
-    expect(css).toContain("Gmarket Sans");
-  });
-
-  it("returns empty string when none are present", () => {
-    expect(buildJsdelivrCss([googleVariableFont()])).toBe("");
-  });
-});
-
-describe("buildVariationSettings", () => {
-  it("returns comma-separated tag/value pairs", () => {
-    expect(buildVariationSettings({ wght: 500, CASL: 0.5 })).toBe('"wght" 500, "CASL" 0.50');
-  });
-
-  it("returns '' for empty axis map", () => {
-    expect(buildVariationSettings({})).toBe("");
-  });
-});
-
-describe("buildExportCss", () => {
-  it("includes @import for google-hosted fonts", () => {
-    const css = buildExportCss(googleVariableFont(), {
-      axisValues: { wght: 500 },
-      staticWeight: 500,
-      letterSpacing: 0,
-      lineHeight: 1.2,
-    });
-    expect(css).toContain("@import");
-    expect(css).toContain("fonts.googleapis.com");
-    expect(css).toContain(`font-family: "Inter"`);
-    expect(css).toContain("font-weight: 500");
-  });
-
-  it("embeds @font-face directly for jsdelivr fonts (no @import)", () => {
-    const css = buildExportCss(jsdelivrFont(), {
-      axisValues: {},
-      staticWeight: 500,
-      letterSpacing: 0,
-      lineHeight: 1.2,
-    });
-    expect(css).toContain("@font-face");
-    expect(css).not.toMatch(/@import\s+url\("https:\/\/fonts\.googleapis/);
-  });
-
-  it("emits font-variation-settings for variable fonts", () => {
-    const css = buildExportCss(googleVariableFont(), {
-      axisValues: { wght: 700 },
-      letterSpacing: 0,
-      lineHeight: 1.2,
-    });
-    expect(css).toContain("font-variation-settings");
-    expect(css).toContain('"wght" 700');
-  });
-
-  it("omits letter-spacing when it's 0", () => {
-    const css = buildExportCss(googleVariableFont(), {
-      axisValues: { wght: 400 },
-      staticWeight: 400,
-      letterSpacing: 0,
-      lineHeight: 1.2,
-    });
-    expect(css).not.toContain("letter-spacing");
-  });
-
-  it("includes letter-spacing as em when non-zero", () => {
-    const css = buildExportCss(googleVariableFont(), {
-      axisValues: { wght: 400 },
-      letterSpacing: -0.02,
-      lineHeight: 1.2,
-    });
-    expect(css).toContain("letter-spacing: -0.020em");
-  });
-
-  it("includes line-height when provided", () => {
-    const css = buildExportCss(googleVariableFont(), {
-      axisValues: { wght: 400 },
-      letterSpacing: 0,
-      lineHeight: 1.5,
-    });
-    expect(css).toContain("line-height: 1.50");
-  });
-});

package/.opencode/oh-my-design/web/src/lib/fonts/loaders.ts

@@ -1,90 +0,0 @@
-/**
- * Font loading — builds URLs / CSS to pull a catalog entry's font into the
- * page. Catalog supports two loaders:
- *   - `google`: single Google Fonts css2 URL (many families per request OK)
- *   - `jsdelivr`: raw @font-face CSS text, injected via <style>
- *
- * Google-hosted fonts are preferred (CDN-optimized, OFL-vetted, HTTP/2
- * multiplexing). jsdelivr is the fallback for Korean display fonts not on
- * Google Fonts (Gmarket Sans, Galmuri, etc.).
- */
-
-import type { FontEntry } from "./types";
-
-/** Build a single Google Fonts css2 URL that loads every google-loader
- *  catalog entry at once. Dramatically reduces request count vs per-font
- *  links. Families are alphabetized so the URL is deterministic (cache
- *  friendly). */
-export function buildGoogleFontsHref(entries: FontEntry[]): string | null {
-  const googleFamilies = entries
-    .filter((e) => e.loader.kind === "google")
-    .map((e) => (e.loader as { kind: "google"; family: string }).family)
-    .sort();
-  if (googleFamilies.length === 0) return null;
-  const params = googleFamilies
-    .map((f) => `family=${encodeURIComponent(f)}`)
-    .join("&");
-  return `https://fonts.googleapis.com/css2?${params}&display=swap`;
-}
-
-/** Concatenate raw @font-face CSS for every jsdelivr-loader catalog entry.
- *  Returned string is safe to inject inside a `<style>` element. */
-export function buildJsdelivrCss(entries: FontEntry[]): string {
-  return entries
-    .filter((e) => e.loader.kind === "jsdelivr")
-    .map((e) => (e.loader as { kind: "jsdelivr"; fontFaceCss: string }).fontFaceCss)
-    .join("\n\n");
-}
-
-/** Generate a copy-ready `font-variation-settings` CSS snippet for a
- *  variable-font selection. Returns "" for static fonts. */
-export function buildVariationSettings(axisValues: Record<string, number>): string {
-  const entries = Object.entries(axisValues);
-  if (entries.length === 0) return "";
-  return entries
-    .map(([tag, v]) => `"${tag}" ${Number.isInteger(v) ? v : v.toFixed(2)}`)
-    .join(", ");
-}
-
-/** User-facing CSS snippet for a font selection. Meant to be pasted into
- *  a project's stylesheet. Includes the loader directive + font-family
- *  rule. Omits per-selector usage — the user's caller wires that. */
-export function buildExportCss(entry: FontEntry, selection: {
-  axisValues: Record<string, number>;
-  staticWeight?: number;
-  letterSpacing?: number;
-  lineHeight?: number;
-}): string {
-  const parts: string[] = [];
-  if (entry.loader.kind === "google") {
-    parts.push(`@import url("${buildGoogleFontsHref([entry])}");`);
-  } else {
-    parts.push(entry.loader.fontFaceCss);
-  }
-
-  const useBlock: string[] = [`/* Apply to a selector of your choice */`];
-  useBlock.push(`.your-text {`);
-  useBlock.push(`  font-family: ${entry.cssFamily};`);
-
-  if (entry.variable) {
-    const vs = buildVariationSettings(selection.axisValues);
-    if (vs) useBlock.push(`  font-variation-settings: ${vs};`);
-    // Surface the weight axis as a first-class CSS property when present —
-    // this lets the cascade interact naturally with utility classes.
-    const wght = selection.axisValues.wght;
-    if (wght != null) useBlock.push(`  font-weight: ${Math.round(wght)};`);
-  } else if (selection.staticWeight) {
-    useBlock.push(`  font-weight: ${selection.staticWeight};`);
-  }
-
-  if (selection.letterSpacing != null && selection.letterSpacing !== 0) {
-    useBlock.push(`  letter-spacing: ${selection.letterSpacing.toFixed(3)}em;`);
-  }
-  if (selection.lineHeight != null) {
-    useBlock.push(`  line-height: ${selection.lineHeight.toFixed(2)};`);
-  }
-
-  useBlock.push(`}`);
-  parts.push(useBlock.join("\n"));
-  return parts.join("\n\n");
-}

package/.opencode/oh-my-design/web/src/lib/fonts/match-intent.test.ts

@@ -1,93 +0,0 @@
-/**
- * Deterministic match engine — the Stage 2 fallback when Haiku is
- * unavailable. Regressions here create silent empty-result UX, so three
- * invariants are worth freezing:
- *
- *   1. Common Korean/English keywords parse into the expected tags
- *   2. Catalog-name references boost their own entry
- *   3. Gibberish queries still return 3 safe-default picks (never empty)
- */
-
-import { describe, expect, it } from "vitest";
-import { FONT_CATALOG } from "./catalog";
-import { matchQuery, parseIntent } from "./match-intent";
-
-describe("parseIntent — keyword coverage", () => {
-  it("maps Korean 따뜻 to the warm mood", () => {
-    const intent = parseIntent("따뜻한 폰트");
-    expect(intent.tags.mood).toContain("warm");
-  });
-
-  it("maps English 'serif' to serif family", () => {
-    const intent = parseIntent("a clean serif for reading");
-    expect(intent.family).toBe("serif");
-  });
-
-  it("filters on hangul when '한글' appears", () => {
-    const intent = parseIntent("한글 세리프");
-    expect(intent.scripts).toContain("hangul");
-    expect(intent.family).toBe("serif");
-  });
-
-  it("picks up soft/rounded Korean onomatopoeia (몽글몽글, 동글동글)", () => {
-    const a = parseIntent("몽글몽글한 느낌");
-    const b = parseIntent("동글동글한 폰트");
-    expect(a.tags.mood).toContain("soft");
-    expect(b.tags.mood).toContain("soft");
-  });
-
-  it("dedupes overlapping tags from multiple rules", () => {
-    const intent = parseIntent("따뜻한 몽글몽글한 폰트");
-    // Both rules push "warm"; dedupe keeps only one
-    const warms = intent.tags.mood.filter((m) => m === "warm").length;
-    expect(warms).toBe(1);
-  });
-});
-
-describe("parseIntent — reference detection", () => {
-  it("detects when a catalog font is named in the query", () => {
-    const intent = parseIntent("like Pretendard but warmer");
-    expect(intent.referenceFontId).toBe("pretendard");
-  });
-
-  it("returns no referenceFontId when no catalog name appears", () => {
-    const intent = parseIntent("a warm serif");
-    expect(intent.referenceFontId).toBeUndefined();
-  });
-});
-
-describe("matchQuery — result guarantees", () => {
-  it("returns 3+ picks even for gibberish (safe defaults)", () => {
-    const res = matchQuery("asdf qwerty jkl", FONT_CATALOG, 3);
-    expect(res.length).toBeGreaterThanOrEqual(3);
-    expect(res.every((r) => r.font && r.font.id)).toBe(true);
-  });
-
-  it("returns empty array for empty string", () => {
-    expect(matchQuery("   ", FONT_CATALOG, 3)).toEqual([]);
-    expect(matchQuery("", FONT_CATALOG, 3)).toEqual([]);
-  });
-
-  it("hard-filters on requiredScripts — all results include the script", () => {
-    const res = matchQuery("warm modern", FONT_CATALOG, 5, ["hangul"]);
-    expect(res.length).toBeGreaterThan(0);
-    for (const r of res) {
-      expect(r.font.scripts).toContain("hangul");
-    }
-  });
-
-  it("respects both-scripts filter (union of intent + UI)", () => {
-    const res = matchQuery("clean", FONT_CATALOG, 5, ["hangul", "latin"]);
-    for (const r of res) {
-      // Every result must cover *both* scripts since requiredScripts has both
-      expect(r.font.scripts).toContain("hangul");
-      expect(r.font.scripts).toContain("latin");
-    }
-  });
-
-  it("a keyword-rich query beats the safe-default confidence floor", () => {
-    const generic = matchQuery("xxxxx", FONT_CATALOG, 3)[0];
-    const specific = matchQuery("warm korean sans", FONT_CATALOG, 3)[0];
-    expect(specific.confidence).toBeGreaterThan(generic.confidence);
-  });
-});