tsquare 0.7.0 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.7.1
4
+
5
+ - **`share_wireframe` returns only the links asked for.** A new `links` option takes the kinds from the playground's Copy link menu, with the same names: `share`, `svg`, `png`, `markdown`, `html`. The default is `["svg", "share"]`, an image link and the link to edit it; before, every call returned four links. Each link carries the whole wireframe (about 1,200 characters for a three-screen board), and the model has to write out every link it passes on, exactly, so fewer links means less to write and fewer chances to break one. A wireframe too long for an image link gets its share link instead, with a note saying why. New exports: `LINK_KINDS`, `DEFAULT_LINKS`, `LinkKind`.
6
+
7
+ - **Invalid values name the prop and the value.** A wrong `key=value` used to come back as Zod's bare message, which didn't say which prop on the line was wrong: `Input: Invalid option: expected one of "text"|"password"|…`. Now: `Input: type=otp isn't an option; use one of text, password, search, email, date, code`. Likewise `level=4 isn't an option; use one of 1, 2, 3`, `height=tall should be a number`, `columns=Name should be a list like [a, b]`, `range=[1] needs at least 2 items`, `columns=0 is too small (at least 1)`. This matters most in the MCP repair loop, where the model fixes what the messages say.
8
+ - **Fix: the HTML link escapes `&`** (and `<`, `>`) in the board title, in both the playground's Copy link → HTML and the MCP share tool, which now share one helper. A title like `Tom &amp; Jerry` used to show as "Tom & Jerry".
9
+ - **One wrong value is one error.** A check that uses a prop's value is skipped when that value is already invalid: `input type=otp digits=6` no longer also says "digits only applies to type=code". Checks that only notice a prop is set still run (`leadingIcon` on an avatar item is wrong whatever the icon's name).
10
+
3
11
  ## 0.7.0
4
12
 
5
13
  ### MCP tools
@@ -2684,6 +2684,38 @@ function listItemKindHint(el, path) {
2684
2684
  if (value === "icon" || !kinds.includes(value)) return void 0;
2685
2685
  return `${value} is a ${side} kind, not an icon name: write ${side}=${value} instead of ${prop}=${value}`;
2686
2686
  }
2687
+ function written(v) {
2688
+ if (typeof v === "string") return /^[^\s"[\]{}=,]+$/.test(v) ? v : JSON.stringify(v);
2689
+ if (Array.isArray(v)) return `[${v.map(written).join(", ")}]`;
2690
+ return JSON.stringify(v) ?? String(v);
2691
+ }
2692
+ function propIssueMessage(props, issue) {
2693
+ const path = issue.path ?? [];
2694
+ if (!path.length || issue.code === "custom") return issue.message;
2695
+ const key = path.map(String).join(".");
2696
+ const value = path.reduce((v, k) => v == null ? v : v[k], props);
2697
+ const given = `${key}=${written(value)}`;
2698
+ switch (issue.code) {
2699
+ case "invalid_value":
2700
+ return `${given} isn't an option; use one of ${(issue.values ?? []).map(written).join(", ")}`;
2701
+ case "invalid_union": {
2702
+ const options = (issue.errors ?? []).flat().flatMap((e) => e.code === "invalid_value" ? e.values : []);
2703
+ if (options.length) return `${given} isn't an option; use one of ${options.map(written).join(", ")}`;
2704
+ return `${given} isn't a valid value`;
2705
+ }
2706
+ case "invalid_type":
2707
+ return `${given} should be ${issue.expected === "array" ? "a list like [a, b]" : `a ${issue.expected}`}`;
2708
+ case "too_small":
2709
+ case "too_big": {
2710
+ const [bound, n] = issue.code === "too_small" ? ["at least", issue.minimum] : ["at most", issue.maximum];
2711
+ if (issue.origin === "array") return `${given} needs ${bound} ${n} item${n == 1 ? "" : "s"}`;
2712
+ if (issue.origin === "string") return `${given} needs ${bound} ${n} character${n == 1 ? "" : "s"}`;
2713
+ return `${given} is too ${issue.code === "too_small" ? "small" : "large"} (${bound} ${n})`;
2714
+ }
2715
+ default:
2716
+ return `${given}: ${issue.message}`;
2717
+ }
2718
+ }
2687
2719
  function checkSpec(spec) {
2688
2720
  upgradeSpec(spec);
2689
2721
  const issues = [];
@@ -2705,13 +2737,16 @@ function checkSpec(spec) {
2705
2737
  if (root.type !== "Board") issues.push(`root must be a Board (got ${root.type})`);
2706
2738
  for (const [id, el] of Object.entries(spec.elements)) {
2707
2739
  const def = componentDefinitions[el.type];
2740
+ const bad = /* @__PURE__ */ new Set();
2741
+ const failed = (...keys) => keys.some((k) => bad.has(k));
2708
2742
  if (!def) {
2709
2743
  issues.push(`${id}: ${unknownComponentMessage(el.type, Object.keys(componentDefinitions))}`);
2710
2744
  } else {
2711
2745
  const parsed = def.props.safeParse(el.props ?? {});
2712
2746
  if (!parsed.success) {
2713
2747
  for (const i of parsed.error.issues) {
2714
- issues.push(`${id}.props${i.path.length ? "." + i.path.join(".") : ""}: ${listItemKindHint(el, i.path) ?? i.message}`);
2748
+ if (i.path.length) bad.add(String(i.path[0]));
2749
+ issues.push(`${id}.props${i.path.length ? "." + i.path.join(".") : ""}: ${listItemKindHint(el, i.path) ?? propIssueMessage(el.props ?? {}, i)}`);
2715
2750
  }
2716
2751
  }
2717
2752
  for (const key of Object.keys(el.props ?? {})) {
@@ -2750,50 +2785,50 @@ function checkSpec(spec) {
2750
2785
  const p = el.props ?? {};
2751
2786
  const { leading, trailing } = listItemEnds(p);
2752
2787
  const conflict = (prop, needs, kind, has) => issues.push(`${id}: ${prop} only shows with ${needs} (this item has ${kind}=${has}); remove one of them`);
2753
- if (p.leadingIcon && leading !== "icon") conflict("leadingIcon", "leading=icon", "leading", leading);
2754
- if (p.trailingIcon && trailing !== "icon") conflict("trailingIcon", "trailing=icon", "trailing", trailing);
2755
- if (p.trailingText && trailing !== "text" && trailing !== "badge") conflict("trailingText", "trailing=text or badge", "trailing", trailing);
2788
+ if (p.leadingIcon && leading !== "icon" && !failed("leading")) conflict("leadingIcon", "leading=icon", "leading", leading);
2789
+ if (p.trailingIcon && trailing !== "icon" && !failed("trailing")) conflict("trailingIcon", "trailing=icon", "trailing", trailing);
2790
+ if (p.trailingText && trailing !== "text" && trailing !== "badge" && !failed("trailing")) conflict("trailingText", "trailing=text or badge", "trailing", trailing);
2756
2791
  }
2757
2792
  {
2758
2793
  const p = el.props ?? {};
2759
- const say = (msg) => issues.push(`${id}: ${msg}`);
2794
+ const say = (msg, ...reads) => !failed(...reads) && issues.push(`${id}: ${msg}`);
2760
2795
  const backwards = (r) => Array.isArray(r) && r.length === 2 && r[0] > r[1];
2761
2796
  if (el.type === "Progress") {
2762
- if (p.step != null && p.steps == null) say(`step only shows with steps (e.g. steps=4 step=${p.step})`);
2763
- if (p.step != null && p.steps != null && p.step > p.steps) say(`step=${p.step} is past the last step (steps=${p.steps})`);
2764
- if (p.steps != null && p.shape === "circle") say("a stepper (steps) can't also be a circle; remove one of them");
2797
+ if (p.step != null && p.steps == null) say(`step only shows with steps (e.g. steps=4 step=${typeof p.step === "number" ? p.step : 2})`);
2798
+ if (p.step != null && p.steps != null && p.step > p.steps) say(`step=${p.step} is past the last step (steps=${p.steps})`, "step", "steps");
2799
+ if (p.steps != null && p.shape === "circle") say("a stepper (steps) can't also be a circle; remove one of them", "shape");
2765
2800
  }
2766
2801
  if (el.type === "Pagination" && p.current != null && p.pages != null && p.current > p.pages) {
2767
- say(`current=${p.current} is past the last page (pages=${p.pages})`);
2802
+ say(`current=${p.current} is past the last page (pages=${p.pages})`, "current", "pages");
2768
2803
  }
2769
- if (el.type === "Slider" && backwards(p.range)) say(`range=[${p.range.join(", ")}] goes backwards; write the smaller number first`);
2804
+ if (el.type === "Slider" && backwards(p.range)) say(`range=[${p.range.join(", ")}] goes backwards; write the smaller number first`, "range");
2770
2805
  if (el.type === "Slider" && p.range && p.value != null) say("a slider has value (one handle) or range (two), not both");
2771
2806
  if (el.type === "Calendar") {
2772
2807
  const { days } = monthGrid(p.month);
2773
2808
  const all = [p.selected, ...p.range ?? [], ...p.marked ?? []].filter((d) => typeof d === "number");
2774
2809
  const late = all.find((d) => d > days);
2775
- if (late) say(`day ${late} isn't in ${p.month ?? "the month"} (it has ${days} days)`);
2776
- if (backwards(p.range)) say(`range=[${p.range.join(", ")}] goes backwards; write the earlier day first`);
2810
+ if (late) say(`day ${late} isn't in ${p.month ?? "the month"} (it has ${days} days)`, "month", "selected", "range", "marked");
2811
+ if (backwards(p.range)) say(`range=[${p.range.join(", ")}] goes backwards; write the earlier day first`, "range");
2777
2812
  if (p.range && p.selected != null) say("a calendar has selected (one day) or range (several), not both");
2778
2813
  }
2779
2814
  if (el.type === "Input" && p.type === "code" && p.value != null && String(p.value).length > (p.digits ?? 6)) {
2780
- say(`value has ${String(p.value).length} characters but the code has ${p.digits ?? 6} boxes (digits)`);
2815
+ say(`value has ${String(p.value).length} characters but the code has ${p.digits ?? 6} boxes (digits)`, "type", "value", "digits");
2781
2816
  }
2782
- if (el.type === "Input" && p.digits != null && p.type !== "code") say("digits only applies to type=code");
2783
- if (el.type === "Input" && p.open && p.type !== "date") say("open shows a date picker, so it needs type=date");
2784
- if ((el.type === "Button" || el.type === "ListItem" || el.type === "NavBar") && p.open && !(Array.isArray(p.menu) && p.menu.length)) say("open shows the menu; add menu=[\u2026] with its items");
2785
- if (el.type === "Select" && p.open && !(Array.isArray(p.options) && p.options.length)) say("open shows the options list; add options=[\u2026] with the choices");
2817
+ if (el.type === "Input" && p.digits != null && p.type !== "code") say("digits only applies to type=code", "type");
2818
+ if (el.type === "Input" && p.open && p.type !== "date") say("open shows a date picker, so it needs type=date", "type");
2819
+ if ((el.type === "Button" || el.type === "ListItem" || el.type === "NavBar") && p.open && !(Array.isArray(p.menu) && p.menu.length)) say("open shows the menu; add menu=[\u2026] with its items", "menu");
2820
+ if (el.type === "Select" && p.open && !(Array.isArray(p.options) && p.options.length)) say("open shows the options list; add options=[\u2026] with the choices", "options");
2786
2821
  }
2787
2822
  if (el.type === "Table") {
2788
2823
  const { columns, data } = el.props ?? {};
2789
2824
  if (Array.isArray(columns) && Array.isArray(data)) {
2790
- const bad = data.map((row, i) => ({ row: i + 1, cells: Array.isArray(row) ? row.length : 1 })).filter((r) => r.cells !== columns.length);
2791
- if (bad.length) {
2825
+ const bad2 = data.map((row, i) => ({ row: i + 1, cells: Array.isArray(row) ? row.length : 1 })).filter((r) => r.cells !== columns.length);
2826
+ if (bad2.length) {
2792
2827
  const cells = (n) => `${n} cell${n === 1 ? "" : "s"}`;
2793
- const rows = bad.length === 1 ? `data row ${bad[0].row} has ${cells(bad[0].cells)}` : `data rows ${bad.map((r) => `${r.row} (${cells(r.cells)})`).join(", ")} don't match`;
2828
+ const rows = bad2.length === 1 ? `data row ${bad2[0].row} has ${cells(bad2[0].cells)}` : `data rows ${bad2.map((r) => `${r.row} (${cells(r.cells)})`).join(", ")} don't match`;
2794
2829
  const hints = [
2795
- bad.some((r) => r.cells > columns.length) && `quote cells that contain a comma, e.g. ["$1,200", Paid]`,
2796
- bad.some((r) => r.cells < columns.length) && `use "" for an empty cell`
2830
+ bad2.some((r) => r.cells > columns.length) && `quote cells that contain a comma, e.g. ["$1,200", Paid]`,
2831
+ bad2.some((r) => r.cells < columns.length) && `use "" for an empty cell`
2797
2832
  ].filter(Boolean);
2798
2833
  issues.push(`${id}: Table has ${columns.length} columns, but ${rows} (${hints.join("; ")})`);
2799
2834
  }
@@ -2808,7 +2843,7 @@ function checkSpec(spec) {
2808
2843
  if (other) issues.push(`${key}: the id #${ref} is also used by ${spec.elements[other.key].type} "${other.key}"${other.id === ref ? "" : ` (as #${other.id}; ids ignore case)`}; ids must be unique`);
2809
2844
  else owners.set(ref.toLowerCase(), { key, id: ref });
2810
2845
  }
2811
- const written = [...owners.values()].map((o2) => o2.id);
2846
+ const written2 = [...owners.values()].map((o2) => o2.id);
2812
2847
  const parentOf = /* @__PURE__ */ new Map();
2813
2848
  for (const [k, el] of Object.entries(spec.elements)) for (const c of el.children ?? []) parentOf.set(c, k);
2814
2849
  for (const [key, el] of Object.entries(spec.elements)) {
@@ -2828,9 +2863,9 @@ function checkSpec(spec) {
2828
2863
  }
2829
2864
  continue;
2830
2865
  }
2831
- const close = closeMatches(p[end], written);
2866
+ const close = closeMatches(p[end], written2);
2832
2867
  issues.push(
2833
- `${key}: no element has the id #${p[end]}` + (close.length ? ` (did you mean ${close.map((c) => "#" + c).join(", ")}?)` : owners.size ? ` (ids on this board: ${written.map((c) => "#" + c).join(", ")})` : "; name an element by writing #name after it")
2868
+ `${key}: no element has the id #${p[end]}` + (close.length ? ` (did you mean ${close.map((c) => "#" + c).join(", ")}?)` : owners.size ? ` (ids on this board: ${written2.map((c) => "#" + c).join(", ")})` : "; name an element by writing #name after it")
2834
2869
  );
2835
2870
  }
2836
2871
  if (typeof p.from === "string" && typeof p.to === "string" && p.from.toLowerCase() === p.to.toLowerCase()) issues.push(`${key}: a flow needs two different ends (both are #${p.from})`);
package/dist/cli.js CHANGED
@@ -6,7 +6,7 @@ import {
6
6
  printWireframeText,
7
7
  renderWireframe,
8
8
  wireframePrompt
9
- } from "./chunks/chunk-Z4RBFAOM.js";
9
+ } from "./chunks/chunk-ZLVSCEWO.js";
10
10
 
11
11
  // src/cli.ts
12
12
  import { readFile, writeFile } from "node:fs/promises";
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Escaping for HTML attribute values, shared by the playground's Copy link → HTML and the MCP
3
+ * share tool, so the two give the same <img> tag. & first, or the entities it adds get escaped again.
4
+ */
5
+ export declare const escapeAttr: (s: string) => string;
package/dist/index.d.ts CHANGED
@@ -3,7 +3,7 @@ export { renderWireframe, compileWireframe, formatIssues, WireframeError, type C
3
3
  export { wireframePrompt, repairPrompt } from "./prompt.js";
4
4
  export { printWireframeText as formatWireframe } from "./print.js";
5
5
  export { encodeWireframe, decodeWireframe, MAX_SHARED_TEXT } from "./share.js";
6
- export { mcpTools, MCP_INSTRUCTIONS, wireframeGuide, renderWireframeTool, shareWireframeTool, callMcpTool, type ToolResult, type ToolContent, type ToolOptions, type McpToolName } from "./mcp.js";
6
+ export { mcpTools, MCP_INSTRUCTIONS, LINK_KINDS, DEFAULT_LINKS, type LinkKind, wireframeGuide, renderWireframeTool, shareWireframeTool, callMcpTool, type ToolResult, type ToolContent, type ToolOptions, type McpToolName } from "./mcp.js";
7
7
  export { upgradeWireframe, upgradeSpec, RENAMED_PROPS, type UpgradeOptions } from "./upgrade.js";
8
8
  export { renderWireframeSvg, renderWireframePng, checkSpec, boardSize, boardLayout, type BoardItem, type RenderWireframeOptions } from "./render.js";
9
9
  export { parseWireframeText, type TextIssue, type ParseResult } from "./text.js";
package/dist/index.js CHANGED
@@ -21,7 +21,7 @@ import {
21
21
  upgradeSpec,
22
22
  upgradeWireframe,
23
23
  wireframePrompt
24
- } from "./chunks/chunk-Z4RBFAOM.js";
24
+ } from "./chunks/chunk-ZLVSCEWO.js";
25
25
 
26
26
  // src/share.ts
27
27
  import { deflateRawSync, inflateRawSync } from "node:zlib";
@@ -45,19 +45,36 @@ function decodeWireframe(data) {
45
45
 
46
46
  // src/mcp.ts
47
47
  import { z } from "zod";
48
+
49
+ // src/escape.ts
50
+ var escapeAttr = (s) => s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/[\r\n]+/g, " ");
51
+
52
+ // src/mcp.ts
48
53
  var MODEL_IMAGE_MAX = 1600;
49
54
  var MAX_IMAGE_LINK_DATA = 16e3;
50
55
  var DEFAULT_BASE = "https://tsquare.dev";
51
56
  var MCP_INSTRUCTIONS = "tsquare draws low-fidelity UI wireframes from a small text language: multi-screen boards with notes and flow arrows, grayscale by default. Call wireframe_guide once before writing your first wireframe, then render_wireframe to check and see it, and share_wireframe to give the user links.";
52
57
  var textInput = z.string().max(MAX_SHARED_TEXT).describe("The wireframe in tsquare text (a ```tsquare code fence around it is fine).");
53
58
  var flowsInput = z.boolean().optional().describe("Draw flow arrows (default true). false leaves them out, as if there were no flow lines.");
59
+ var LINK_KINDS = ["share", "svg", "png", "markdown", "html"];
60
+ var DEFAULT_LINKS = ["svg", "share"];
61
+ var LINK_LABELS = {
62
+ share: "Share link (opens it in the playground to view and edit)",
63
+ svg: "Image link (SVG)",
64
+ png: "Image link (PNG)",
65
+ markdown: "Markdown",
66
+ html: "HTML"
67
+ };
68
+ var linksInput = z.array(z.enum(LINK_KINDS)).min(1).optional().describe(
69
+ "Which links to return; ask only for what the user needs, since each link is long. share: open and edit it in the playground. svg: an image link to view or embed (Notion, GitHub, docs). png: an image link for tools that don't show SVG. markdown: an image for READMEs and docs. html: an <img> tag for web pages. Default [svg, share]."
70
+ );
54
71
  var GUIDE_HEADER = `# Writing tsquare wireframes
55
72
 
56
73
  Workflow:
57
74
  1. Write the wireframe text for the user's request, following the language below.
58
75
  2. Call render_wireframe with it. If it reports problems, fix every line it names and render again.
59
76
  3. Look at the image for what the checker can't see: content cut off at the bottom of a screen (make the screen taller with height=\u2026 or remove content), cramped rows, text that wraps badly. Fix and render again.
60
- 4. Call share_wireframe and give the user the links: the image link to look at or embed, and the playground link to edit. Show the wireframe text too, in a \`\`\`tsquare code block, so they can keep it.
77
+ 4. Call share_wireframe with only the links the user needs (links=[\u2026]; by default an image link and the share link to edit it), and give them to the user exactly as returned: each link carries the whole wireframe, so one changed character breaks it. Show the wireframe text too, in a \`\`\`tsquare code block, so they can keep it.
61
78
  `;
62
79
  var mcpTools = {
63
80
  wireframe_guide: {
@@ -74,8 +91,8 @@ var mcpTools = {
74
91
  },
75
92
  share_wireframe: {
76
93
  title: "Share a wireframe",
77
- description: "Links for valid tsquare wireframe text: an image link (SVG or PNG) to show or embed in Markdown, Notion or docs, and a playground link to edit it. The links contain the wireframe text itself (compressed), so anyone with a link can read it.",
78
- inputSchema: z.object({ text: textInput, flows: flowsInput }),
94
+ description: "Links for valid tsquare wireframe text, the same kinds as the playground's Copy link menu: a share link to edit it in the playground, image links (SVG, PNG), Markdown and HTML. Ask only for the links the user needs (default: an SVG image link and the share link). Each link contains the whole wireframe text (compressed), so anyone with a link can read it.",
95
+ inputSchema: z.object({ text: textInput, flows: flowsInput, links: linksInput }),
79
96
  annotations: { readOnlyHint: true, openWorldHint: false }
80
97
  }
81
98
  };
@@ -113,28 +130,28 @@ function shareWireframeTool(args, opts = {}) {
113
130
  return { content: [text(`This wireframe is too long to share as a link (over ${MAX_SHARED_TEXT / 1e3} KB of text). Split it into smaller boards.`)], isError: true };
114
131
  const data = encodeWireframe(bare);
115
132
  const query = args.flows === false ? "?flows=0" : "";
116
- const title = String(spec.elements[spec.root]?.props?.title ?? "Wireframe").replace(/[[\]\n]/g, " ");
117
- const playground = `${base}/playground#${data}`;
118
- if (data.length > MAX_IMAGE_LINK_DATA)
119
- return { content: [text(`Playground (to view and edit): ${playground}
120
-
121
- This wireframe is too long for an image link; the playground link still works. To get image links, split it into smaller boards.`)] };
133
+ const title = String(spec.elements[spec.root]?.props?.title ?? "Wireframe");
134
+ const kinds = [...new Set(args.links?.length ? args.links : DEFAULT_LINKS)];
135
+ const share = `${base}/playground#${data}`;
136
+ const lines = [];
137
+ const notes = ["Give each link exactly as written: it carries the whole wireframe, so anyone with it can read the wireframe, and one changed character breaks it."];
138
+ if (data.length > MAX_IMAGE_LINK_DATA && kinds.some((k) => k !== "share")) {
139
+ if (!kinds.includes("share")) kinds.unshift("share");
140
+ notes.unshift("This wireframe is too long for an image link, so only the share link is included. To get image links, split it into smaller boards.");
141
+ }
122
142
  const svg = `${base}/svg/${data}${query}`;
123
- const png = `${base}/png/${data}${query}`;
124
- return {
125
- content: [
126
- text(
127
- [
128
- `Image (SVG): ${svg}`,
129
- `Image (PNG): ${png}`,
130
- `Playground (to view and edit): ${playground}`,
131
- `Markdown: ![${title}](${svg})`,
132
- "",
133
- "The links contain the wireframe text, so anyone with a link can read it."
134
- ].join("\n")
135
- )
136
- ]
137
- };
143
+ for (const kind of kinds) {
144
+ if (kind !== "share" && data.length > MAX_IMAGE_LINK_DATA) continue;
145
+ const link = {
146
+ share,
147
+ svg,
148
+ png: `${base}/png/${data}${query}`,
149
+ markdown: `![${title.replace(/[[\]\n]/g, " ")}](${svg})`,
150
+ html: `<img src="${svg}" alt="${escapeAttr(title)}">`
151
+ }[kind];
152
+ lines.push(`${LINK_LABELS[kind]}: ${link}`);
153
+ }
154
+ return { content: [text([...lines, "", ...notes].join("\n"))] };
138
155
  }
139
156
  async function callMcpTool(name, args = {}, opts = {}) {
140
157
  if (name === "wireframe_guide") return wireframeGuide();
@@ -145,7 +162,9 @@ async function callMcpTool(name, args = {}, opts = {}) {
145
162
  return name === "render_wireframe" ? renderWireframeTool(parsed.data) : shareWireframeTool(parsed.data, opts);
146
163
  }
147
164
  export {
165
+ DEFAULT_LINKS,
148
166
  DEVICES,
167
+ LINK_KINDS,
149
168
  MAX_SHARED_TEXT,
150
169
  MCP_INSTRUCTIONS,
151
170
  RENAMED_PROPS,
package/dist/mcp.d.ts CHANGED
@@ -30,6 +30,11 @@ export declare const MODEL_IMAGE_MAX = 1600;
30
30
  export declare const MAX_IMAGE_LINK_DATA = 16000;
31
31
  /** Short server instructions: what the tools are for and the order to use them in. */
32
32
  export declare const MCP_INSTRUCTIONS: string;
33
+ /** The link kinds share_wireframe offers: the playground's Copy link menu, with the same names. */
34
+ export declare const LINK_KINDS: readonly ["share", "svg", "png", "markdown", "html"];
35
+ export type LinkKind = (typeof LINK_KINDS)[number];
36
+ /** What a plain "share it" gets: one image link and the link to edit it. */
37
+ export declare const DEFAULT_LINKS: LinkKind[];
33
38
  export declare const mcpTools: {
34
39
  readonly wireframe_guide: {
35
40
  readonly title: "tsquare language guide";
@@ -54,10 +59,17 @@ export declare const mcpTools: {
54
59
  };
55
60
  readonly share_wireframe: {
56
61
  readonly title: "Share a wireframe";
57
- readonly description: "Links for valid tsquare wireframe text: an image link (SVG or PNG) to show or embed in Markdown, Notion or docs, and a playground link to edit it. The links contain the wireframe text itself (compressed), so anyone with a link can read it.";
62
+ readonly description: "Links for valid tsquare wireframe text, the same kinds as the playground's Copy link menu: a share link to edit it in the playground, image links (SVG, PNG), Markdown and HTML. Ask only for the links the user needs (default: an SVG image link and the share link). Each link contains the whole wireframe text (compressed), so anyone with a link can read it.";
58
63
  readonly inputSchema: z.ZodObject<{
59
64
  text: z.ZodString;
60
65
  flows: z.ZodOptional<z.ZodBoolean>;
66
+ links: z.ZodOptional<z.ZodArray<z.ZodEnum<{
67
+ html: "html";
68
+ markdown: "markdown";
69
+ png: "png";
70
+ share: "share";
71
+ svg: "svg";
72
+ }>>>;
61
73
  }, z.core.$strip>;
62
74
  readonly annotations: {
63
75
  readonly readOnlyHint: true;
@@ -77,6 +89,7 @@ export declare function renderWireframeTool(args: {
77
89
  export declare function shareWireframeTool(args: {
78
90
  text: string;
79
91
  flows?: boolean;
92
+ links?: LinkKind[];
80
93
  }, opts?: ToolOptions): ToolResult;
81
94
  /** Run a tool by name, for servers that dispatch by name. Unknown names come back as an error result. */
82
95
  export declare function callMcpTool(name: string, args?: Record<string, unknown>, opts?: ToolOptions): Promise<ToolResult>;
@@ -13,7 +13,7 @@ import {
13
13
  renderWireframeSvg,
14
14
  takesUniversalProps,
15
15
  wireframePrompt
16
- } from "../chunks/chunk-Z4RBFAOM.js";
16
+ } from "../chunks/chunk-ZLVSCEWO.js";
17
17
 
18
18
  // src/playground/index.ts
19
19
  import { createServer } from "node:http";