hd-garden 0.3.13 → 0.4.1

package/ui/garden/enhance.mjs

@@ -0,0 +1,89 @@
+/**
+ * Pure enhancements shared by the renderer and `garden check`.
+ * Math identifiers, code/diff pairing, table breakout and TOC shift.
+ */
+
+const IDENTIFIER = /(^|[^\\A-Za-z])([A-Za-z]{2,})_([A-Za-z][A-Za-z0-9]*)/gu;
+
+/** `group_num` becomes one identifier. `W_q` and `H_kv` stay real subscripts. */
+export function protectMathIdentifiers(tex) {
+  return String(tex ?? "").replace(IDENTIFIER, (_, prefix, base, rest) => `${prefix}\\mathrm{${base}\\_${rest}}`);
+}
+
+/** New-file text of a unified diff: additions and context, deletions dropped. */
+export function diffToNewCode(diff) {
+  return String(diff ?? "")
+    .replace(/\n$/u, "")
+    .split("\n")
+    .flatMap((line) => {
+      if (line.startsWith("+")) return [line.slice(1)];
+      if (line.startsWith("-") || line.startsWith("\\")) return [];
+      return [line.startsWith(" ") ? line.slice(1) : line];
+    })
+    .join("\n");
+}
+
+export function isTrivialFormula(formula) {
+  const compact = String(formula ?? "").replace(/\s+/gu, "");
+  if (!compact || (compact.match(/\*/gu) || []).length !== 1) return false;
+  const outside = compact.replace(/\([^()]*\)/gu, "");
+  return !/[+\-/]/u.test(outside);
+}
+
+export function interactiveFormulas(source) {
+  const text = String(source ?? "");
+  const found = [];
+  for (const match of text.matchAll(/^formula:\s*(.+)$/gmu)) found.push(match[1]);
+  for (const match of text.matchAll(/<Let\b[^>]*?\{([^{}]+)\}/gu)) found.push(match[1]);
+  return found;
+}
+
+export function isTrivialInteractive(source) {
+  const formulas = interactiveFormulas(source);
+  return formulas.length > 0 && formulas.every((formula) => isTrivialFormula(formula));
+}
+
+/** Steps that only restyle prose: a stepper and no input the reader can change. */
+export function isProseSteps(source) {
+  const text = String(source ?? "");
+  const body = text.includes("\n---\n") ? text.split("\n---\n").slice(1).join("\n---\n") : text;
+  if (!/<(Steps|Stepper|Step)\b/u.test(body)) return false;
+  return !/<(State|Slider|Choice|Toggle|Input|Range)\b/u.test(body);
+}
+
+/**
+ * How far a table may break out of the text column.
+ * Symmetric, at most `cap` per side, never closer than `edge` to the viewport,
+ * and only when the viewport is at least `minViewport`.
+ */
+export function tableBreakout({
+  viewport,
+  articleLeft,
+  articleRight,
+  tableClient,
+  tableScroll,
+  minViewport = 900,
+  cap = 300,
+  edge = 24,
+}) {
+  if (viewport < minViewport) return { left: 0, right: 0 };
+  const room = Math.max(0, Math.min(cap, articleLeft - edge, viewport - edge - articleRight));
+  const need = tableScroll - tableClient;
+  if (need <= 1 || room <= 0) return { left: 0, right: 0 };
+  const margin = Math.min(room, Math.ceil(need / 2) + 4);
+  return { left: margin, right: margin };
+}
+
+/**
+ * Slide the TOC right of a wide element measured against the TOC's original
+ * position. Hide it when the shifted TOC would not fit on screen.
+ */
+export function tocShift({ tocLeft, tocWidth, viewport, overlapRights, edge = 12 }) {
+  if (!overlapRights?.length) return { shift: 0, hide: false };
+  const maxRight = Math.max(...overlapRights);
+  let shift = Math.ceil(maxRight + 16 - tocLeft);
+  const hide = tocLeft + shift + tocWidth > viewport - edge;
+  if (hide) shift = Math.ceil(viewport - tocLeft + 8);
+  if (shift < 0) shift = 0;
+  return { shift, hide };
+}

package/ui/garden/parse.mjs

@@ -0,0 +1,198 @@
+import { parse as parseYaml } from "yaml";
+import { CATALOG, knownName, legacyOf } from "./catalog.mjs";
+
+const FENCE_RE = /^( {0,3})(`{3,}|~{3,})(.*)$/u;
+
+/** Fences in document order. Line numbers are 1-based in `markdown`. */
+export function scanFences(markdown) {
+  const lines = String(markdown ?? "").split(/\r?\n/u);
+  const fences = [];
+  let open = null;
+  lines.forEach((line, index) => {
+    const match = FENCE_RE.exec(line);
+    if (open) {
+      const closer = match
+        && match[2][0] === open.marker[0]
+        && match[2].length >= open.marker.length
+        && !match[3].trim()
+        && match[1].length <= open.indent;
+      if (closer) {
+        fences.push({
+          indent: open.indent,
+          marker: open.marker,
+          info: open.info,
+          lang: open.lang,
+          meta: open.meta,
+          line: open.line,
+          endLine: index + 1,
+          body: open.body.join("\n"),
+        });
+        open = null;
+      } else {
+        open.body.push(line);
+      }
+      return;
+    }
+    if (!match) return;
+    const info = match[3].trim();
+    const lang = info.split(/\s+/u)[0] ?? "";
+    open = {
+      indent: match[1].length,
+      marker: match[2],
+      info,
+      lang: lang.toLowerCase(),
+      meta: info.slice(lang.length).trim(),
+      line: index + 1,
+      body: [],
+    };
+  });
+  if (open) {
+    fences.push({ ...open, endLine: lines.length, body: open.body.join("\n"), unclosed: true });
+  }
+  return fences;
+}
+
+export function isGardenLang(lang) {
+  return lang === "garden" || String(lang || "").startsWith("garden:");
+}
+
+/** `garden`, `garden stat`, `garden stat #id`, or legacy `garden:stat`. */
+export function parseGardenInfo(info) {
+  const raw = String(info ?? "").trim();
+  const legacy = /^garden:([a-z][\w-]*)$/iu.exec(raw.split(/\s+/u)[0] ?? "");
+  if (legacy) {
+    const id = /#([\w-]+)/u.exec(raw)?.[1] ?? null;
+    return { legacy: true, legacyLang: legacy[0].toLowerCase(), name: legacy[1].toLowerCase(), id };
+  }
+  if (!/^garden(?:\s|$)/iu.test(raw)) return null;
+  const rest = raw.slice("garden".length).trim();
+  if (!rest) return { legacy: false, name: "", id: null };
+  const match = /^([a-z][\w-]*)(?:\s+#([\w-]+))?$/iu.exec(rest);
+  if (!match) return { legacy: false, name: rest.split(/\s+/u)[0].toLowerCase(), id: null, bad: true };
+  return { legacy: false, name: match[1].toLowerCase(), id: match[2] ?? null };
+}
+
+export function splitPropsAndChildren(body) {
+  const text = String(body ?? "").replace(/\s+$/u, "");
+  const lines = text.split("\n");
+  const sep = lines.findIndex((line, index) => index > 0 && /^---\s*$/u.test(line));
+  if (sep === -1) return { yamlText: text, children: "" };
+  return { yamlText: lines.slice(0, sep).join("\n"), children: lines.slice(sep + 1).join("\n").replace(/^\n/u, "") };
+}
+
+function asObject(value) {
+  if (Array.isArray(value)) return { items: value };
+  if (value && typeof value === "object") return value;
+  return null;
+}
+
+/**
+ * One node: { name, props, children }.
+ * An empty name is an idea. Invalid YAML or an unknown name is still returned,
+ * with `error` set, so the checker and the renderer share one parse.
+ */
+export function parseGardenBlock(info, body) {
+  const header = parseGardenInfo(info);
+  if (!header) return null;
+  const { yamlText, children } = splitPropsAndChildren(body);
+  if (!header.name) {
+    const text = String(body ?? "").trim();
+    return { name: "", props: header.id ? { id: header.id } : {}, children: text, idea: text, legacy: header.legacy, legacyLang: header.legacyLang };
+  }
+  let parsed;
+  try {
+    parsed = yamlText.trim() ? parseYaml(yamlText) : {};
+  } catch (error) {
+    return {
+      name: header.name,
+      props: {},
+      children,
+      id: header.id,
+      legacy: header.legacy,
+      legacyLang: header.legacyLang,
+      error: { code: "garden-yaml", message: `YAML 解析失败：${error.message}` },
+    };
+  }
+  const props = asObject(parsed);
+  if (!props) {
+    return {
+      name: header.name,
+      props: {},
+      children,
+      id: header.id,
+      legacy: header.legacy,
+      error: { code: "garden-yaml", message: "YAML 必须是一组键值，或条目列表。" },
+    };
+  }
+  if (header.id && props.id == null) props.id = header.id;
+  const spec = CATALOG[header.name];
+  if (!knownName(header.name) || !spec) {
+    return {
+      name: header.name,
+      props,
+      children,
+      id: header.id ?? props.id ?? null,
+      legacy: header.legacy,
+      legacyLang: header.legacyLang,
+      error: { code: "garden-name", message: `未知名字 ${header.name}` },
+    };
+  }
+  const unknown = Object.keys(props).filter((key) => key !== "id" && !spec.keys.includes(key));
+  if (unknown.length) {
+    return {
+      name: header.name,
+      props,
+      children,
+      id: header.id ?? props.id ?? null,
+      legacy: header.legacy,
+      error: { code: "garden-yaml", message: `不支持的键 ${unknown.join("、")}`, unknown, allowed: spec.keys },
+    };
+  }
+  return {
+    name: header.name,
+    props,
+    children,
+    id: header.id ?? props.id ?? null,
+    legacy: Boolean(header.legacy),
+    legacyLang: header.legacyLang,
+  };
+}
+
+export function fenceInfo(fence) {
+  if (!fence) return "";
+  if (fence.lang === "garden") return `garden${fence.meta ? ` ${fence.meta}` : ""}`.trim();
+  return fence.info || fence.lang;
+}
+
+export function classifyFence(fence) {
+  const legacy = legacyOf(fence.lang);
+  if (legacy) return { kind: "legacy", ...legacy, fence };
+  if (fence.lang === "html" && /\bgarden\b/u.test(fence.meta)) {
+    return { kind: "legacy", lang: "html", name: "html", suggestion: "`html garden` 已改为 `garden html`", fence };
+  }
+  if (isGardenLang(fence.lang)) {
+    const block = parseGardenBlock(fenceInfo(fence), fence.body);
+    return { kind: "garden", block, fence };
+  }
+  if (fence.lang === "diff") return { kind: "diff", fence };
+  if (fence.lang === "mermaid") return { kind: "mermaid", fence };
+  return { kind: "code", fence };
+}
+
+const COMPONENT_LANGS = new Set(["mermaid", "diff", "embed", "widget", "intent", "ui", "ui-error", "html"]);
+
+export function isFullCodeFence(fence) {
+  if (!fence || fence.kind && fence.kind !== "code") return false;
+  const lang = fence.lang ?? fence.fence?.lang;
+  if (!lang) return true;
+  if (COMPONENT_LANGS.has(lang) || isGardenLang(lang)) return false;
+  return true;
+}
+
+export function blanksBetween(markdown, fromLine, toLine) {
+  const lines = String(markdown).split(/\r?\n/u);
+  for (let line = fromLine; line < toLine - 1; line += 1) {
+    if (lines[line]?.trim()) return false;
+  }
+  return true;
+}

package/ui/garden/snippets.mjs

@@ -0,0 +1,109 @@
+import { CATALOG, GARDEN_NAMES, IDEA } from "./catalog.mjs";
+
+function fenceLines(example) {
+  return example.replace(/\\`/gu, "`").split("\n");
+}
+
+function snippetBody(example) {
+  const lines = fenceLines(example);
+  const cursorAt = lines.findIndex((line) => line.includes("让读者"));
+  if (cursorAt === -1) return [...lines.slice(0, -1), "$0", lines.at(-1)];
+  return lines.map((line, index) => (index === cursorAt ? line.replace("让读者……；想让读者看出……", "${1:让读者……；想让读者看出……}") : line));
+}
+
+export function vscodeSnippets() {
+  const snippets = {
+    "Garden 块": {
+      prefix: "garden",
+      body: ["```garden ${1|idea,card,stat,compare,timeline,chart,figure,html,interactive|}", "$0", "```"],
+      description: "选择 Garden 块：想法 / card / stat / compare / timeline / chart / figure / html / interactive",
+    },
+  };
+  for (const trigger of IDEA.triggers) {
+    snippets[`Garden ${IDEA.label} ${trigger}`] = {
+      prefix: trigger,
+      body: snippetBody(IDEA.example),
+      description: IDEA.when,
+    };
+  }
+  for (const name of GARDEN_NAMES) {
+    const spec = CATALOG[name];
+    for (const trigger of spec.triggers) {
+      snippets[`Garden ${spec.label} ${trigger}`] = {
+        prefix: trigger,
+        body: fenceLines(spec.example),
+        description: `${spec.when} 不该用：${spec.whenNot}`,
+      };
+    }
+  }
+  snippets["Garden 代码与对比"] = {
+    prefix: "gdiff",
+    body: ["```${1:lang}", "$0", "```", "", "```diff", "", "```"],
+    description: "完整代码块，紧跟它的 diff。站点收成「代码 / 对比上一版」。",
+  };
+  return snippets;
+}
+
+export function gardenBlocksMarkdown() {
+  const sections = [
+    ["想法", IDEA],
+    ...GARDEN_NAMES.map((name) => [name, CATALOG[name]]),
+  ];
+  return [
+    "# Garden 块模板",
+    "",
+    "从这里复制。触发词和 VS Code 片段、macOS 文本替换是同一份目录生成的。",
+    "",
+    ...sections.flatMap(([name, spec]) => [
+      `## ${name === "想法" ? "想法" : name} · ${spec.label}`,
+      "",
+      spec.when,
+      "",
+      `不该用：${spec.whenNot}`,
+      "",
+      spec.example,
+      "",
+    ]),
+  ].join("\n");
+}
+
+function xmlEscape(value) {
+  return String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+
+export function textReplacementPlist() {
+  const items = [
+    ...IDEA.triggers.map((trigger) => ({ shortcut: `;${trigger}`, phrase: IDEA.example })),
+    ...GARDEN_NAMES.flatMap((name) => CATALOG[name].triggers.map((trigger) => ({
+      shortcut: `;${trigger}`,
+      phrase: CATALOG[name].example,
+    }))),
+  ];
+  const dicts = items.map((item) => `  <dict>
+    <key>phrase</key>
+    <string>${xmlEscape(item.phrase)}</string>
+    <key>shortcut</key>
+    <string>${xmlEscape(item.shortcut)}</string>
+  </dict>`);
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array>
+${dicts.join("\n")}
+</array>
+</plist>
+`;
+}
+
+export function pickerItems() {
+  return [
+    { name: "", label: `想法 · ${IDEA.label}`, body: IDEA.example, when: IDEA.when, whenNot: IDEA.whenNot },
+    ...GARDEN_NAMES.map((name) => ({
+      name,
+      label: `${name} · ${CATALOG[name].label}`,
+      body: CATALOG[name].example,
+      when: CATALOG[name].when,
+      whenNot: CATALOG[name].whenNot,
+    })),
+  ];
+}

package/ui/garden/title.mjs

@@ -0,0 +1,37 @@
+const SEPARATOR = /丨|｜| \| /gu;
+
+/**
+ * A title splits into exactly two lines when it contains one 丨, ｜ or " | ".
+ * Anything else stays one line. The separator stays in the accessible name.
+ */
+export function splitTitle(title) {
+  const text = String(title ?? "");
+  const matches = [...text.matchAll(SEPARATOR)];
+  if (matches.length === 0) return { split: false, title: text, lines: [text], separator: null, issue: null };
+  if (matches.length > 1) {
+    return { split: false, title: text, lines: [text], separator: null, issue: "multiple" };
+  }
+  const match = matches[0];
+  const before = text.slice(0, match.index).trim();
+  const after = text.slice(match.index + match[0].length).trim();
+  const separator = match[0] === " | " ? " | " : match[0];
+  if (!before || !after) {
+    return { split: false, title: text, lines: [text], separator, issue: "empty" };
+  }
+  return { split: true, title: text, lines: [before, after], separator, issue: null };
+}
+
+/** Estimated line width in hero-em units. CJK is 1, capitals 0.68, spaces 0.3. */
+export function titleWidthUnits(line) {
+  return [...String(line ?? "")].reduce((sum, char) => {
+    if (/[\u2E80-\uFFFF]/u.test(char)) return sum + 1;
+    if (/[A-Z]/u.test(char)) return sum + 0.68;
+    if (char === " ") return sum + 0.3;
+    return sum + 0.58;
+  }, 0);
+}
+
+export function titleLineScale(lines) {
+  const width = Math.max(...lines.map((line) => titleWidthUnits(line)), 0.01);
+  return Number(width.toFixed(2));
+}