Better Design

Added value: +{
+  "description": "Set for an iPhone Duo or another foldable app. The call then needs nativeStates from at least two poses, closed and open, and returns status incomplete otherwise.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "True only when status is completed. Report a score only then.",
+  "type": "boolean"
+}

Previous value: -[
-  "needs-capture",
-  "completed"
-]New value: +[
+  "needs-capture",
+  "incomplete",
+  "completed"
+]

Previous value: -[
-  "status"
-]New value: +[
+  "status",
+  "measured"
+]

Previous value: -"Which tune-in-place setup to return. 'react' (default) for React/Next web projects; 'vanilla' for plain DOM or canvas work; 'react-native' for RN/Expo apps. Ignored when kind is 'standalone-tool' or 'variant-canvas'."New value: +"The platform the jig or picker goes into. 'react' (default) for React/Next web projects; 'vanilla' for plain DOM or canvas work; 'react-native' for RN/Expo apps; 'swiftui' for SwiftUI apps; 'shopify' for Liquid themes. Ignored when kind is 'standalone-tool' or 'wait-for-send'."

Previous value: -[
-  "react",
-  "vanilla",
-  "react-native"
-]New value: +[
+  "react",
+  "vanilla",
+  "react-native",
+  "swiftui",
+  "shopify"
+]

Previous value: -"What the user needs. 'tune-in-place' (default): a control panel for parameters in the UI you are building. 'standalone-tool': a separate reusable design tool, scaffolded with Toolcraft. 'variant-canvas': several variants of one component or screen side by side, for the user to compare and pick."New value: +"What the user needs. 'tune-in-place' (default): a control panel for parameters in the UI you are building. 'standalone-tool': a separate reusable design tool, scaffolded with Toolcraft. 'variant-canvas': three versions of one piece of UI on the real screen behind a picker. 'wait-for-send': wait for the person to select Send on a jig or picker you handed over, and receive what they chose."

Previous value: -[
-  "tune-in-place",
-  "standalone-tool",
-  "variant-canvas"
-]New value: +[
+  "tune-in-place",
+  "standalone-tool",
+  "variant-canvas",
+  "wait-for-send"
+]

Previous value: -"Required build target. Use \"react\" for any host with filesystem + terminal; use \"html\" only for inline chat canvases/artifacts. Use \"shopify\" for Shopify stores and themes. Use \"dtcg\" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. Use \"store-screenshots\" for App Store and Google Play screenshots in this system: it returns slide files and a render script that writes PNG files at the store sizes.  Use \"react-native\" for a React Native or Expo app and \"swiftui\" for an iOS app: each returns this system's stored mobile kit, its own material on native primitives, plus the handoff to the matching guide."New value: +"Required build target. Use \"react\" for any host with filesystem + terminal; use \"html\" only for inline chat canvases/artifacts. Use \"shopify\" for Shopify stores and themes. Use \"dtcg\" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. Use \"store-screenshots\" for App Store and Google Play screenshots in this system: it returns slide files and a render script that writes PNG files at the store sizes.  Use \"react-native\" for a React Native or Expo app and \"swiftui\" for an iOS app: each returns this design system's own components for that platform: its theme and native primitives in its material, plus the handoff to the matching guide."

Previous value: -"Required build target. Use \"react\" for any host with filesystem + terminal; use \"html\" only for inline chat canvases/artifacts. Use \"shopify\" for Shopify stores and themes. Use \"dtcg\" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. Use \"store-screenshots\" for App Store and Google Play screenshots in this system: it returns slide files and a render script that writes PNG files at the store sizes. "New value: +"Required build target. Use \"react\" for any host with filesystem + terminal; use \"html\" only for inline chat canvases/artifacts. Use \"shopify\" for Shopify stores and themes. Use \"dtcg\" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. Use \"store-screenshots\" for App Store and Google Play screenshots in this system: it returns slide files and a render script that writes PNG files at the store sizes.  Use \"react-native\" for a React Native or Expo app and \"swiftui\" for an iOS app: each returns this system's stored mobile kit, its own material on native primitives, plus the handoff to the matching guide."

Previous value: -[
-  "react",
-  "html",
-  "shopify",
-  "dtcg",
-  "store-screenshots"
-]New value: +[
+  "react",
+  "html",
+  "shopify",
+  "dtcg",
+  "store-screenshots",
+  "react-native",
+  "swiftui"
+]

Added value: +{
+  "description": "react-native and swiftui only: a few words naming the screen you are building, such as \"habit tracker today\" or \"workout log\". The kit then shows how shipped apps built it.",
+  "maxLength": 80,
+  "minLength": 1,
+  "type": "string"
+}

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "string"
-  }
-]

Added value: +[
+  "number",
+  "string"
+]

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "string",
+  "null"
+]

Added value: +{
+  "description": "Native screens: a name for each, and the JSON `axe describe-ui` printed for it. Frames are in points and are measured as pixels.",
+  "items": {
+    "properties": {
+      "name": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "tree": {
+        "items": {},
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "name",
+      "tree"
+    ],
+    "type": "object"
+  },
+  "maxItems": 6,
+  "minItems": 1,
+  "type": "array"
+}

Added value: +{
+  "description": "The project folder this server installed the design system into. Build there; run no setup command.",
+  "type": "string"
+}

Added value: +{
+  "description": "True when this server runs on the user's machine and installs the design system itself: call get-design-system-kit again with install: true.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Creates a Vite + React + TypeScript project with Tailwind v4, the @/* alias and components.json, for when there is no project yet. Run it, then run installCommand inside the new my-app folder.",
+  "type": "string"
+}

Added value: +{
+  "description": "The project folder this server installed the design system into. Build there; run no setup command.",
+  "type": "string"
+}

Added value: +{
+  "description": "True when this server runs on the user's machine and installs the design system itself: call get-design-system-kit again with install: true.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Creates a Vite + React + TypeScript project with Tailwind v4, the @/* alias and components.json, for when there is no project yet. Run it, then run installCommand inside the new my-app folder.",
+  "type": "string"
+}

Added value: +{
+  "description": "The project folder this server installed the design system into. Build there; run no setup command.",
+  "type": "string"
+}

Added value: +{
+  "description": "True when this server runs on the user's machine and installs the design system itself: call get-design-system-kit again with install: true.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Creates a Vite + React + TypeScript project with Tailwind v4, the @/* alias and components.json, for when there is no project yet. Run it, then run installCommand inside the new my-app folder.",
+  "type": "string"
+}

Previous value: -"The button label, for example \"Book a call\"."New value: +"Optional. The button label, for example \"Book a call\"."

Removed value: -1

Previous value: -"Where the button goes, for example your calendar link."New value: +"Where the call to action goes, for example your calendar link."

Removed value: -{
-  "description": "\"page\" makes a hosted sales page. \"pdf\" makes the same page as a one-page PDF to leave behind after a call.",
-  "enum": [
-    "page",
-    "pdf"
-  ],
-  "type": "string"
-}

Previous value: -"The page's headline, written for this account."New value: +"Optional. The page's headline. Left out, Better Design writes it."

Removed value: -1

Added value: +{
+  "description": "Optional. What you know about the account: its business, its problem, the conversation so far.",
+  "maxLength": 2000,
+  "type": "string"
+}

Previous value: -"Optional. The problem the account has today."New value: +"Optional. The problem the account has today. Left out, Better Design writes it."

Previous value: -[
-  "format",
-  "designSystemId",
-  "website",
-  "company",
-  "headline",
-  "offer",
-  "ctaLabel",
-  "ctaUrl"
-]New value: +[
+  "designSystemId",
+  "company",
+  "website",
+  "offer",
+  "ctaUrl"
+]

Added value: +{
+  "description": "Where the call to action goes, for example your calendar link.",
+  "format": "uri",
+  "maxLength": 2048,
+  "type": "string"
+}

Previous value: -"The image's headline."New value: +"Optional. The image's headline. Left out, Better Design writes it."

Removed value: -1

Added value: +{
+  "description": "Optional. What you know about the account: its business, its problem, the conversation so far.",
+  "maxLength": 2000,
+  "type": "string"
+}

Added value: +{
+  "description": "What you offer this account and what it gets.",
+  "maxLength": 1200,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "The account's website, for example https://acme.com.",
+  "format": "uri",
+  "maxLength": 2048,
+  "type": "string"
+}

Previous value: -[
-  "designSystemId",
-  "company",
-  "headline"
-]New value: +[
+  "designSystemId",
+  "company",
+  "website",
+  "offer",
+  "ctaUrl"
+]

Previous value: -"Routes, file paths or names of work you are about to build; checks each against the Main Quest."New value: +"Routes, file paths or names of work you are about to build; checks each against what the product already makes and the Main Quest."

Added value: +{
+  "description": "The layout density to check against: compact, comfortable or spacious. Omit it to use the project's design config, then the design system's default, both read from the page's --layout-density variable, then the mode closest to the measured page.",
+  "enum": [
+    "compact",
+    "comfortable",
+    "spacious"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "The density the page declares through the kit's --layout-density variable. The capture script fills it.",
+  "properties": {
+    "mode": {
+      "maxLength": 20,
+      "type": "string"
+    },
+    "source": {
+      "maxLength": 20,
+      "type": "string"
+    },
+    "unit": {
+      "exclusiveMinimum": 0,
+      "maximum": 64,
+      "type": "number"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "mode": {
+      "enum": [
+        "compact",
+        "comfortable",
+        "spacious"
+      ],
+      "type": "string"
+    },
+    "roles": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "expected": {
+            "type": "number"
+          },
+          "matches": {
+            "type": "boolean"
+          },
+          "measured": {
+            "type": "number"
+          },
+          "role": {
+            "enum": [
+              "sidebarWidth",
+              "pageInset",
+              "sectionGap",
+              "columnGap",
+              "cardPadding"
+            ],
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "role",
+          "state",
+          "measured",
+          "expected",
+          "matches"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "source": {
+      "enum": [
+        "argument",
+        "project",
+        "design-system",
+        "measured"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "mode",
+    "source",
+    "roles"
+  ],
+  "type": "object"
+}

Previous value: -"Partial design config to merge over the current one. Only pass the fields the user changed. Colors are oklch() strings (e.g. 'oklch(0.62 0.11 45)'); radius is a CSS length (e.g. '0.75rem'); fonts are family names."New value: +"Partial design config to merge over the current one. Only pass the fields the user changed. Colors are oklch() strings (e.g. 'oklch(0.62 0.11 45)'); radius is a CSS length (e.g. '0.75rem'); fonts are family names; density is compact, comfortable or spacious and overrides the design system's layout density."

Added value: +{
+  "enum": [
+    "compact",
+    "comfortable",
+    "spacious"
+  ],
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}