@markuplint/vue-spec 5.3.0 → 5.5.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.5.0](https://github.com/markuplint/markuplint/compare/v5.4.0...v5.5.0) (2026-11-10)
+
+### Features
+
+* **vue-spec:** declare how Vue renders a literal written as code ([aaff283](https://github.com/markuplint/markuplint/commit/aaff283dceed86bd9e8fde1ffe8d3b37055a826c))
+* **vue-spec:** declare that Vue appends the children of a template without a directive to it ([370f2d5](https://github.com/markuplint/markuplint/commit/370f2d5848d693ef8f01c7d3bacaad02a123dfc8))
+
+
+# [5.4.0](https://github.com/markuplint/markuplint/compare/v5.3.0...v5.4.0) (2026-10-29)
+
+**Note:** Version bump only for package @markuplint/vue-spec
+
+
+
+
+
 # [5.3.0](https://github.com/markuplint/markuplint/compare/v5.2.0...v5.3.0) (2026-10-21)
 
 ### Bug Fixes

package/lib/index.js

@@ -47,6 +47,10 @@ const spec = {
             pattern: '^(?:v-bind:|:)([^.]+)$',
             potentialName: '$1',
             isDynamicValue: true,
+            // The value is a JavaScript expression that becomes the attribute value, so a literal in it
+            // is rendered as Vue renders it (`literalValues` below). The same-name shorthand `:attr`
+            // has no value, which `MLAttr` does not read as a literal.
+            expressionLanguage: 'javascript',
             // Vue merges static `class`/`style` with their bound equivalents,
             // so these attributes may legitimately appear alongside `:class`/`:style`
             isDuplicatable: ['class', 'style'],
@@ -77,6 +81,51 @@ const spec = {
             isDynamicValue: true,
         },
     ],
+    /**
+     * Only a `template` with `v-if`, `v-else-if`, `v-else`, `v-for` or `v-slot` is a fragment of Vue
+     * (`isFragmentTemplate` of `@vue/compiler-core`). Any other one is an element, which the client
+     * creates and appends each child to (`insert` of `nodeOps` in `@vue/runtime-dom` calls
+     * `parent.insertBefore`), so the children are in the tree of the document, not in `content`.
+     * Known limitations: Vue puts the children in `content` when it renders static markup as a
+     * string, and when it hydrates server output it replaces the element with its content.
+     */
+    templateContent: 'in-place',
+    /**
+     * How Vue renders a literal in `:attr="…"` (`ssrRenderDynamicAttr` of `@vue/server-renderer`), where it
+     * differs from the default of `@markuplint/ml-core`. The docs of Vue say of a boolean attribute:
+     *
+     * > It will also be included if the value is an empty string, maintaining consistency with `<button disabled="">`.
+     *
+     * So the table says:
+     *
+     * - A boolean attribute (`isBooleanAttr` of `@vue/shared`) is present for any truthy value and for the
+     *   empty string (`includeBooleanAttr`)
+     * - `class` and `style` are always output, and a value that is not a string, an array or an object
+     *   is `""` (`ssrRenderClass`, `ssrRenderStyle`)
+     *
+     * What it does not tell, which is not expressed by a table (the rendering does not affect a rule, or
+     * the markup is invalid and `invalid-attr` reports it):
+     *
+     * - `:value` of `<input>` and `<option>` sets the DOM property, not the attribute (`textarea` is not
+     *   output by the server): a literal in it is rendered as the default does
+     * - `key` and `ref` are not output by the server, as they are not attributes of the DOM, but a static
+     *   `key="x"` is seen as an attribute too
+     * - The client renders `:disabled="false"` on an element that has no boolean attribute `disabled` as
+     *   `disabled="false"`; the server does not output it, and the table follows the server
+     * - A number other than `0` on `class` and `style` is `""` too, which a table cannot list: it is `"1"` here
+     *
+     * @see https://vuejs.org/guide/essentials/template-syntax.html#boolean-attributes
+     * @see https://github.com/vuejs/core/blob/main/packages/server-renderer/src/helpers/ssrRenderAttrs.ts#ssrRenderDynamicAttr
+     * @see https://github.com/vuejs/core/blob/main/packages/shared/src/domAttrConfig.ts#isBooleanAttr
+     * @see https://github.com/vuejs/core/blob/main/packages/shared/src/domAttrConfig.ts#includeBooleanAttr
+     */
+    literalValues: {
+        booleanAttrs: { '""': '' },
+        attrs: {
+            class: { true: '', false: '', null: '', undefined: '', '0': '' },
+            style: { true: '', false: '', null: '', undefined: '', '0': '' },
+        },
+    },
     def: {
         '#globalAttrs': {
             '#extends': {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/vue-spec",
-	"version": "5.3.0",
+	"version": "5.5.0",
 	"description": "Extended specification for tags and attributes in Vue",
 	"repository": {
 		"type": "git",
@@ -28,7 +28,7 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-spec": "5.3.0"
+		"@markuplint/ml-spec": "5.5.0"
 	},
-	"gitHead": "f587cf0206c8426e57369a48d6d5fb22306eafde"
+	"gitHead": "fedebcfd56eaec4642e68643b2f9e10750d810e1"
 }