Theme Tools Release — 2026-09-30

packages/liquid-html-parser/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @shopify/liquid-html-parser
 
+## 2.10.2
+
+### Patch Changes
+
+- 9c04ccbc: Preserve quoted braces in LiquidDoc parameter types and leave incomplete string annotations unparsed so they cannot consume subsequent parameters.
+
 ## 2.10.1
 
 ### Patch Changes

packages/liquid-html-parser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/liquid-html-parser",
-  "version": "2.10.1",
+  "version": "2.10.2",
   "description": "Liquid HTML parser by Shopify",
   "author": "CP Clermont <cp.clermont@shopify.com>",
   "homepage": "https://github.com/Shopify/theme-tools/tree/main/packages/liquid-html-parser#readme",

packages/prettier-plugin-liquid/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @shopify/prettier-plugin-liquid
 
+## 1.11.2
+
+### Patch Changes
+
+- 4d7201b4: Format wrapped `block` arguments with trailing commas and a closing delimiter on its own line, and avoid unnecessary whitespace stripping between childless Liquid tag delimiters.
+- Updated dependencies [9c04ccbc]
+  - @shopify/liquid-html-parser@2.10.2
+
 ## 1.11.1
 
 ### Patch Changes

packages/prettier-plugin-liquid/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/prettier-plugin-liquid",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "description": "Prettier Liquid/HTML plugin by Shopify",
   "author": "CP Clermont <cp.clermont@shopify.com>",
   "homepage": "https://github.com/Shopify/theme-tools/tree/main/packages/prettier-plugin-liquid#readme",
@@ -61,7 +61,7 @@
     "tsconfig-paths": "^3.14.1"
   },
   "dependencies": {
-    "@shopify/liquid-html-parser": "workspace:^2.10.1",
+    "@shopify/liquid-html-parser": "workspace:^2.10.2",
     "html-styles": "^1.0.0"
   }
 }

packages/theme-check-browser/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @shopify/theme-check-browser
 
+## 3.30.0
+
+### Patch Changes
+
+- Updated dependencies [699780b7]
+- Updated dependencies [0bbd0f8b]
+- Updated dependencies [86058651]
+- Updated dependencies [169ff04d]
+- Updated dependencies [2a150cd2]
+- Updated dependencies [9f1fa97b]
+  - @shopify/theme-check-common@3.30.0
+
 ## 3.29.1
 
 ### Patch Changes

packages/theme-check-browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/theme-check-browser",
-  "version": "3.29.1",
+  "version": "3.30.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",
@@ -26,6 +26,6 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@shopify/theme-check-common": "workspace:3.29.1"
+    "@shopify/theme-check-common": "workspace:3.30.0"
   }
 }

packages/theme-check-common/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @shopify/theme-check-common
 
+## 3.30.0
+
+### Minor Changes
+
+- 0bbd0f8b: Guide theme blocks to the implicit `content` parameter.
+
+  Add the recommended `BlockContentUsage` error for `block.content` in `blocks/*.liquid`. Its message is "Use the implicit 'content' parameter directly instead of 'block.content'."
+
+  Add the recommended `ValidBlockContentSettingType` error for a theme block schema setting named `content` whose Liquid type is not `string`. This error replaces the `ValidBlockArgumentTypes` warning for the same schema declaration.
+
+  `UndefinedObject` accepts bare `content` in `blocks/*.liquid`.
+
+- 86058651: Validate block calls against the merged schema, LiquidDoc, and built-in content interface.
+
+  Schema settings define plain arguments, types, and merchant visibility without making arguments required. LiquidDoc controls requiredness for every parameter it declares, including schema-backed parameters and `content`. Schema-only parameters and built-in `content` without LiquidDoc are optional.
+
+  Theme Check reports incompatible types between schema, LiquidDoc, and built-in content declarations.
+
+  `LiquidSyntaxError` now rejects the unsupported experimental `block.settings.<id>` and `block.content` caller arguments, and every other dotted block argument except `block.name`. The obsolete `BlockArgumentSettingCollision` and `UnknownBlockSetting` checks are removed from check registration and generated configs.
+
+- 2a150cd2: Support string enums in LiquidDoc parameter types
+
+  `@param` accepts unions of string literals, such as `{'heading' | 'small'}`, and literal arguments to `render`, `content_for` and `block` are checked against them.
+
+- 9f1fa97b: Add the `ValidBlockTagPlacement` check
+
+  Reports uses of the `block` tag outside direct Liquid templates and layouts.
+
+### Patch Changes
+
+- 699780b7: Report unsupported dotted `block` arguments on the first offending argument instead of the entire `block` tag and its body.
+- 169ff04d: Tell authors to replace `block.settings.<id>:` with `<id>:` when calling a `block`.
+- Updated dependencies [9c04ccbc]
+  - @shopify/liquid-html-parser@2.10.2
+
 ## 3.29.1
 
 ### Patch Changes

packages/theme-check-common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/theme-check-common",
-  "version": "3.29.1",
+  "version": "3.30.0",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@shopify/liquid-html-parser": "workspace:2.10.1",
+    "@shopify/liquid-html-parser": "workspace:2.10.2",
     "cross-fetch": "^4.0.0",
     "jsonc-parser": "^3.2.0",
     "line-column": "^1.0.2",

packages/theme-check-docs-updater/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @shopify/theme-check-docs-updater
 
+## 3.30.0
+
+### Patch Changes
+
+- Updated dependencies [699780b7]
+- Updated dependencies [0bbd0f8b]
+- Updated dependencies [86058651]
+- Updated dependencies [169ff04d]
+- Updated dependencies [2a150cd2]
+- Updated dependencies [9f1fa97b]
+  - @shopify/theme-check-common@3.30.0
+
 ## 3.29.1
 
 ### Patch Changes

packages/theme-check-docs-updater/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/theme-check-docs-updater",
-  "version": "3.29.1",
+  "version": "3.30.0",
   "description": "Scripts to initialize theme-check data with assets from the theme-liquid-docs repo.",
   "main": "dist/index.js",
   "author": "Albert Chu <albert.chu@shopify.com>",
@@ -30,7 +30,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@shopify/theme-check-common": "workspace:^3.29.1",
+    "@shopify/theme-check-common": "workspace:^3.30.0",
     "env-paths": "^2.2.1",
     "node-fetch": "^2.6.11"
   },

packages/theme-check-node/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @shopify/theme-check-node
 
+## 3.30.0
+
+### Minor Changes
+
+- 0bbd0f8b: Guide theme blocks to the implicit `content` parameter.
+
+  Add the recommended `BlockContentUsage` error for `block.content` in `blocks/*.liquid`. Its message is "Use the implicit 'content' parameter directly instead of 'block.content'."
+
+  Add the recommended `ValidBlockContentSettingType` error for a theme block schema setting named `content` whose Liquid type is not `string`. This error replaces the `ValidBlockArgumentTypes` warning for the same schema declaration.
+
+  `UndefinedObject` accepts bare `content` in `blocks/*.liquid`.
+
+- 86058651: Validate block calls against the merged schema, LiquidDoc, and built-in content interface.
+
+  Schema settings define plain arguments, types, and merchant visibility without making arguments required. LiquidDoc controls requiredness for every parameter it declares, including schema-backed parameters and `content`. Schema-only parameters and built-in `content` without LiquidDoc are optional.
+
+  Theme Check reports incompatible types between schema, LiquidDoc, and built-in content declarations.
+
+  `LiquidSyntaxError` now rejects the unsupported experimental `block.settings.<id>` and `block.content` caller arguments, and every other dotted block argument except `block.name`. The obsolete `BlockArgumentSettingCollision` and `UnknownBlockSetting` checks are removed from check registration and generated configs.
+
+- 9f1fa97b: Add the `ValidBlockTagPlacement` check
+
+  Reports uses of the `block` tag outside direct Liquid templates and layouts.
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies [699780b7]
+- Updated dependencies [0bbd0f8b]
+- Updated dependencies [86058651]
+- Updated dependencies [169ff04d]
+- Updated dependencies [2a150cd2]
+- Updated dependencies [9c04ccbc]
+- Updated dependencies [9f1fa97b]
+  - @shopify/theme-graph@0.3.4
+  - @shopify/theme-check-common@3.30.0
+  - @shopify/liquid-html-parser@2.10.2
+  - @shopify/theme-check-docs-updater@3.30.0
+
 ## 3.29.1
 
 ### Patch Changes

packages/theme-check-node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/theme-check-node",
-  "version": "3.29.1",
+  "version": "3.30.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "CP Clermont <cp.clermont@shopify.com>",
@@ -33,10 +33,10 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@shopify/liquid-html-parser": "workspace:2.10.1",
-    "@shopify/theme-check-common": "workspace:3.29.1",
-    "@shopify/theme-check-docs-updater": "workspace:3.29.1",
-    "@shopify/theme-graph": "workspace:^0.3.3",
+    "@shopify/liquid-html-parser": "workspace:2.10.2",
+    "@shopify/theme-check-common": "workspace:3.30.0",
+    "@shopify/theme-check-docs-updater": "workspace:3.30.0",
+    "@shopify/theme-graph": "workspace:^0.3.4",
     "glob": "^8.0.3",
     "vscode-uri": "^3.0.7",
     "yaml": "^2.8.3"

packages/theme-graph/CHANGELOG.md

@@ -1,5 +1,22 @@
 # shopify/theme-graph
 
+## 0.3.4
+
+### Patch Changes
+
+- Patch bump because it depends on:
+  - @shopify/liquid-html-parser
+  - @shopify/theme-check-common
+- Updated dependencies [699780b7]
+- Updated dependencies [0bbd0f8b]
+- Updated dependencies [86058651]
+- Updated dependencies [169ff04d]
+- Updated dependencies [2a150cd2]
+- Updated dependencies [9c04ccbc]
+- Updated dependencies [9f1fa97b]
+  - @shopify/theme-check-common@3.30.0
+  - @shopify/liquid-html-parser@2.10.2
+
 ## 0.3.3
 
 ### Patch Changes

packages/theme-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/theme-graph",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Shopify Theme Graph as a data structure",
   "author": "CP Clermont <cp.clermont@shopify.com>",
   "homepage": "https://github.com/Shopify/theme-tools/tree/main/packages/theme-graph#readme",
@@ -29,14 +29,14 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@shopify/liquid-html-parser": "workspace:^2.10.1",
-    "@shopify/theme-check-common": "workspace:^3.29.1",
+    "@shopify/liquid-html-parser": "workspace:^2.10.2",
+    "@shopify/theme-check-common": "workspace:^3.30.0",
     "acorn": "^8.14.1",
     "acorn-walk": "^8.3.4",
     "vscode-uri": "^3.0.7"
   },
   "devDependencies": {
-    "@shopify/theme-check-node": "workspace:^3.29.1",
+    "@shopify/theme-check-node": "workspace:^3.30.0",
     "@types/node": "^22.18.8"
   }
 }