@jxsuite/starters 2.0.0 → 3.0.0

package/README.md

@@ -67,7 +67,7 @@ bun create @jxsuite my-site --template restaurant
 - **`package.json` is rebuilt from scratch** with current dependency ranges, so a clone never inherits whatever the in-repo starter pinned.
 - `--template` resolves built-in template ids first, then registry starter ids; an unknown id falls back to `blank`.
 
-Two other consumers read the registry live: the dev server exposes it to Studio's picker at `GET /__studio/starters`, returning `listStarters()` verbatim (specs/server.md §4.1), and the desktop app imports `listStarters` directly in both its Electrobun and Chromium window layers.
+Two other consumers read the registry live: the dev server exposes it to Studio's picker at `GET /__studio/starters`, returning `listStarters()` verbatim (specs/server.md §4.1), and the desktop app imports `listStarters` directly in its Chromium window layer and its Electron hub.
 
 ## Authoring or modifying a starter
 
@@ -95,7 +95,7 @@ Adding a starter needs **no** desktop config change: `packages/desktop/scripts/v
 
 **Do not hand-edit the `@jxsuite/*` ranges in `sites/*/package.json`.** release-please rewrites them inside its release commit via `extra-files`; the gate is `bun run templates:check` (`templates:sync` to repair).
 
-**Packaged-desktop path contract.** ElectroBun inlines the bun-side JS graph, so `import.meta.dirname` resolves to `app/bun/` at runtime. `registry.json` and `sites/` must therefore be staged to `bun/registry.json` and `bun/sites` by `build.copy` in `packages/desktop/electrobun.config.ts` (specs/desktop.md §7.4).
+**Packaged-desktop path contract.** The packaged application's Bun backend is a single bundle, so `import.meta.dirname` no longer resolves to this package. `registry.json` and `sites/` are staged beside the bundle (`BACKEND_DATA` in `packages/desktop/scripts/lib/backend-bundle.ts`), and `bun run smoke` in `packages/desktop` fails if the staged copy cannot list the starters (specs/desktop.md §7).
 
 **The screenshot lane ignores this package's source.** It watches only `registry.json` and the six starter roots a shot actually opens (`.github/workflows/screenshots.yml`); a registry change arms exactly one shot, `new-project`, because that modal's gallery _is_ `listStarters()`.
 

package/index.ts

@@ -11,38 +11,31 @@
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 
-/** One entry in {@link registry.json} — everything the picker UI needs to render a template card. */
-export interface StarterMeta {
-  /** Stable id; also the directory name under `sites/` and the value threaded as `starter`. */
-  id: string;
-  /** Human-facing display name, e.g. "Bistro & Café". */
-  name: string;
-  /** Industry archetype label, e.g. "Restaurant & Food". */
-  industry: string;
-  /** One-line summary shown under the name. */
-  tagline: string;
-  /** Longer description for the showcase / tooltip. */
-  description: string;
-  /** Short bullets naming the Jx features the starter demonstrates. */
-  features: string[];
-  /** Accent colour (hex) — mirrors the site's primary token; used for card theming. */
-  accent: string;
-  /** Small preview image as a self-contained `data:` URI so the picker needs no extra plumbing. */
-  thumbnail: string;
-}
+import type { StarterInfo } from "@jxsuite/protocol";
+
+/**
+ * One entry in `registry.json`. The wire contract owns the declaration (`StarterInfo`); this
+ * package keeps exporting it under its published name so existing importers keep compiling.
+ */
+export type { StarterInfo as StarterMeta } from "@jxsuite/protocol";
 
 const STARTERS_DIR = import.meta.dirname;
 
 /** Absolute path to the directory holding the per-starter project trees. */
 export const SITES_DIR = join(STARTERS_DIR, "sites");
 
-let _cache: StarterMeta[] | null = null;
+let _cache: StarterInfo[] | null = null;
 
 /** Read and cache the starter registry. */
-export function listStarters(): StarterMeta[] {
+export function listStarters(): StarterInfo[] {
   if (!_cache) {
     const raw = readFileSync(join(STARTERS_DIR, "registry.json"), "utf8");
-    _cache = JSON.parse(raw) as StarterMeta[];
+    /*
+     * SAFETY: registry.json is a committed file shipped inside this package, never user input, and
+     * tests/registry.test.ts asserts that every entry carries each StarterInfo member as a non-empty
+     * string (features as a non-empty string array), so the parsed array matches StarterInfo[].
+     */
+    _cache = JSON.parse(raw) as StarterInfo[];
   }
   return _cache;
 }
@@ -51,9 +44,9 @@ export function listStarters(): StarterMeta[] {
  * Look up a single starter's metadata by id.
  *
  * @param {string} id
- * @returns {StarterMeta | undefined}
+ * @returns {StarterInfo | undefined}
  */
-export function getStarter(id: string): StarterMeta | undefined {
+export function getStarter(id: string): StarterInfo | undefined {
   return listStarters().find((s) => s.id === id);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/starters",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Starter site templates for new Jx projects",
   "license": "MIT",
   "repository": {
@@ -25,10 +25,13 @@
     "test": "bun test --isolate",
     "test:coverage": "bun test --isolate --coverage"
   },
+  "dependencies": {
+    "@jxsuite/protocol": "^4.0.0"
+  },
   "devDependencies": {
-    "@jxsuite/parser": "^2.0.0",
-    "@jxsuite/runtime": "^4.0.3",
-    "@jxsuite/schema": "^3.0.0",
+    "@jxsuite/parser": "^4.0.0",
+    "@jxsuite/runtime": "^5.0.0",
+    "@jxsuite/schema": "^4.0.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1"
   }

package/sites/blog/document.schema.json

@@ -14905,6 +14905,32 @@
                 }
               ]
             },
+            "fit-tolerance": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
+            "fitTolerance": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "flex": {
               "oneOf": [
                 {
@@ -15269,19 +15295,6 @@
                 }
               ]
             },
-            "flow-tolerance": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/$defs/v1/$defs/RefObject"
-                }
-              ]
-            },
             "flowFrom": {
               "oneOf": [
                 {
@@ -15308,19 +15321,6 @@
                 }
               ]
             },
-            "flowTolerance": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/$defs/v1/$defs/RefObject"
-                }
-              ]
-            },
             "font": {
               "oneOf": [
                 {
@@ -25279,6 +25279,19 @@
                 }
               ]
             },
+            "timeline-trigger-range": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "timeline-trigger-source": {
               "oneOf": [
                 {
@@ -25409,6 +25422,19 @@
                 }
               ]
             },
+            "timelineTriggerRange": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "timelineTriggerSource": {
               "oneOf": [
                 {

package/sites/blog/package.json

@@ -9,10 +9,10 @@
     "dev": "jx dev"
   },
   "dependencies": {
-    "@jxsuite/parser": "^2.0.0"
+    "@jxsuite/parser": "^4.0.0"
   },
   "devDependencies": {
-    "@jxsuite/compiler": "^5.0.0",
-    "@jxsuite/runtime": "^4.0.3"
+    "@jxsuite/compiler": "^6.0.1",
+    "@jxsuite/runtime": "^5.0.0"
   }
 }

package/sites/course/document.schema.json

@@ -14905,6 +14905,32 @@
                 }
               ]
             },
+            "fit-tolerance": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
+            "fitTolerance": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "flex": {
               "oneOf": [
                 {
@@ -15269,19 +15295,6 @@
                 }
               ]
             },
-            "flow-tolerance": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/$defs/v1/$defs/RefObject"
-                }
-              ]
-            },
             "flowFrom": {
               "oneOf": [
                 {
@@ -15308,19 +15321,6 @@
                 }
               ]
             },
-            "flowTolerance": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/$defs/v1/$defs/RefObject"
-                }
-              ]
-            },
             "font": {
               "oneOf": [
                 {
@@ -25279,6 +25279,19 @@
                 }
               ]
             },
+            "timeline-trigger-range": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "timeline-trigger-source": {
               "oneOf": [
                 {
@@ -25409,6 +25422,19 @@
                 }
               ]
             },
+            "timelineTriggerRange": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "timelineTriggerSource": {
               "oneOf": [
                 {

package/sites/course/package.json

@@ -9,10 +9,10 @@
     "dev": "jx dev"
   },
   "dependencies": {
-    "@jxsuite/parser": "^2.0.0"
+    "@jxsuite/parser": "^4.0.0"
   },
   "devDependencies": {
-    "@jxsuite/compiler": "^5.0.0",
-    "@jxsuite/runtime": "^4.0.3"
+    "@jxsuite/compiler": "^6.0.1",
+    "@jxsuite/runtime": "^5.0.0"
   }
 }

package/sites/course/pages/enroll.md

@@ -19,7 +19,7 @@ Not sure if it's the right fit? Book a call with our admissions team and we'll w
 - **✓** Six monthly payment plans available
 - **✓** Need-based scholarships for eligible students
 - **✓** 7-day full refund, no questions asked
-  :::
+:::
 
 :::co-pricing{props.badge="Fall cohort · 24 seats" props.plan="Full Program" props.price="$8,900" props.period="or 6 monthly payments" props.description="14 weeks of live instruction, mentorship, and career support — end to end." props.cta="Apply Now" props.ctaHref="#apply" props.note="7-day full refund · scholarships available"}
 
@@ -28,9 +28,9 @@ Not sure if it's the right fit? Book a call with our admissions team and we'll w
 - Deployed full-stack capstone project
 - Career coaching & interview prep
 - Lifetime access to course materials
-  :::
-  ::::
-  :::::
+:::
+::::
+:::::
 
 :::::section{id="apply" style.maxWidth="var(--max-width-narrow)" style.margin="0 auto" style.padding="clamp(3rem, 6vw, 4.5rem) 1.5rem"}
 ::co-section-header{props.eyebrow="apply" props.heading="Start your application" props.subheading="Tell us a little about yourself and admissions will be in touch within two business days."}

package/sites/course/pages/index.md

@@ -85,9 +85,9 @@ Your tuition covers 14 weeks of live instruction, one-on-one mentorship, and car
 - Deployed full-stack capstone project
 - Career coaching & interview prep
 - Lifetime access to course materials
-  ::::
-  :::::
-  ::::::
+::::
+:::::
+::::::
 
 :::::section{style.padding="clamp(3.5rem, 8vw, 6rem) 1.5rem" style.backgroundColor="var(--color-bg-cream)"}
 ::co-section-header{props.eyebrow="faq" props.heading="Questions, answered"}

package/sites/event/document.schema.json

@@ -14905,6 +14905,32 @@
                 }
               ]
             },
+            "fit-tolerance": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
+            "fitTolerance": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "flex": {
               "oneOf": [
                 {
@@ -15269,19 +15295,6 @@
                 }
               ]
             },
-            "flow-tolerance": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/$defs/v1/$defs/RefObject"
-                }
-              ]
-            },
             "flowFrom": {
               "oneOf": [
                 {
@@ -15308,19 +15321,6 @@
                 }
               ]
             },
-            "flowTolerance": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "$ref": "#/$defs/v1/$defs/RefObject"
-                }
-              ]
-            },
             "font": {
               "oneOf": [
                 {
@@ -25279,6 +25279,19 @@
                 }
               ]
             },
+            "timeline-trigger-range": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "timeline-trigger-source": {
               "oneOf": [
                 {
@@ -25409,6 +25422,19 @@
                 }
               ]
             },
+            "timelineTriggerRange": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "$ref": "#/$defs/v1/$defs/RefObject"
+                }
+              ]
+            },
             "timelineTriggerSource": {
               "oneOf": [
                 {

package/sites/event/package.json

@@ -9,10 +9,10 @@
     "dev": "jx dev"
   },
   "dependencies": {
-    "@jxsuite/parser": "^2.0.0"
+    "@jxsuite/parser": "^4.0.0"
   },
   "devDependencies": {
-    "@jxsuite/compiler": "^5.0.0",
-    "@jxsuite/runtime": "^4.0.3"
+    "@jxsuite/compiler": "^6.0.1",
+    "@jxsuite/runtime": "^5.0.0"
   }
 }

package/sites/event/pages/speakers.md

@@ -29,6 +29,7 @@ title: "Speakers — Horizon Conf 2026"
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Jonas Berg
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Infra Lead, Kestrel
 :::
@@ -38,6 +39,7 @@ Infra Lead, Kestrel
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Sam Whitfield
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Product Engineer, Ridgeline
 :::
@@ -47,6 +49,7 @@ Product Engineer, Ridgeline
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Nadia Hassan
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Design Systems, Cobalt
 :::
@@ -56,6 +59,7 @@ Design Systems, Cobalt
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Theo Marsh
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Founder, Driftwork
 :::
@@ -65,6 +69,7 @@ Founder, Driftwork
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Ravi Menon
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Performance, Fathom
 :::
@@ -74,6 +79,7 @@ Performance, Fathom
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Grace Liu
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Accessibility Lead, Everly
 :::
@@ -83,6 +89,7 @@ Accessibility Lead, Everly
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Owen Frost
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Eng Manager, Beacon
 :::
@@ -92,6 +99,7 @@ Eng Manager, Beacon
 :::div{style.fontFamily="var(--font-heading)" style.fontWeight="700" style.fontSize="1.05rem"}
 Mira Patel
 :::
+
 :::div{style.fontSize="0.9rem" style.color="var(--color-text-muted)"}
 Creative Director, Halcyon
 :::