tsquare 0.3.0 → 0.3.2

package/dist/share.d.ts

@@ -1,4 +1,8 @@
 /** Largest decoded text accepted, in bytes. Plenty for a board; stops a tiny URL from inflating into megabytes. */
 export declare const MAX_SHARED_TEXT = 64000;
 export declare function encodeWireframe(text: string): string;
+/**
+ * The wireframe a link carries, upgraded to the current language: a link made
+ * by an older version means today what it meant then (see upgrade.ts).
+ */
 export declare function decodeWireframe(data: string): string;

package/dist/upgrade.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Everything tsquare does for wireframes written in an older version of the
+ * language, kept in one place so the parser, catalog and renderer only know
+ * the current language.
+ *
+ *   upgradeWireframe(text)                    always-safe rewrites (renamed props);
+ *                                             compileWireframe runs it first
+ *   upgradeWireframe(text, { fromLink: true }) also the rules for text that came
+ *                                             from a link made by an older version;
+ *                                             decodeWireframe runs it
+ *   upgradeSpec(spec)                         the renames, for JSON specs
+ *
+ * Rewrites keep every line where it was (except moving a comment onto its own
+ * line, which only happens for links), so problems still point at the right line.
+ *
+ * Adding an upgrade: a rename goes in RENAMED_PROPS. A change in meaning goes
+ * here only if old text can be recognised without guessing; otherwise new links
+ * get a new prefix letter in share.ts and the upgrade applies to the old letter.
+ */
+/** Props renamed in 0.3.0. The prompt, docs and autocomplete only teach the new names; `tsquare fmt` rewrites old ones. */
+export declare const RENAMED_PROPS: Record<string, Record<string, string>>;
+export interface UpgradeOptions {
+    /** The text came from a link (share link or render URL), which may predate 0.3.0. */
+    fromLink?: boolean;
+}
+/** Rewrites older syntax to the current language. Text that's already current comes back unchanged. */
+export declare function upgradeWireframe(text: string, options?: UpgradeOptions): string;
+/** The renames, for a JSON spec. In place; safe to call more than once. */
+export declare function upgradeSpec<S extends {
+    elements: Record<string, {
+        type: string;
+        props?: Record<string, unknown>;
+    }>;
+}>(spec: S): S;
+/**
+ * Components whose main text may be a plain word (`avatar JD`, `icon search`), the parser's
+ * WORD_PRIMARY. Neither has option words, so their first plain word is always the main text.
+ * Kept here rather than imported, so the playground's browser bundle doesn't pull in the parser
+ * and catalog; scripts/build.ts fails if this drifts from the parser.
+ */
+export declare const PLAIN_WORD_MAIN_TEXT: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsquare",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Wireframes in plain text: easy for LLMs to write, fast to render as SVG or PNG.",
   "keywords": [
     "wireframe",
@@ -44,7 +44,8 @@
     "examples/*.tsq",
     "assets/mark.png",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=20"
@@ -62,7 +63,8 @@
     "eval:prompts": "tsx eval/prompts.ts",
     "eval:score": "tsx eval/score.ts",
     "build": "tsx scripts/build.ts",
-    "prepare": "npm run build"
+    "prepare": "npm run build",
+    "test": "tsx --test test/*.test.ts"
   },
   "dependencies": {
     "@fontsource/inter": "5.3.0",

package/skill/tsquare/reference.md

@@ -142,6 +142,7 @@ Dropdown field (closed state).
 - label: string (main text)
 - value: string
 - placeholder: string
+- grow: boolean — Fill the remaining space in a row
 - width: number | string — Fixed width, e.g. 320. Default fills the space.
 
 ### NavBar