@markuplint/vue-spec 4.5.23 → 5.0.0-alpha.1

package/ARCHITECTURE.ja.md

@@ -6,6 +6,23 @@
 
 ## ExtendedSpec の内容
 
+### `directivePatterns`
+
+この spec は Vue ディレクティブ属性を解決するための `directivePatterns` 配列を宣言します。パターンは順番に評価されます（最初のマッチが優先）:
+
+| パターン                          | 結果                                                                         |
+| --------------------------------- | ---------------------------------------------------------------------------- |
+| `^\\.(.+)$`                       | `.prop` ショートハンド (Vue 3.2+) → `isDirective`、`isDynamicValue`          |
+| `^(?:v-bind:\|:)([^.]+)\\..+$`    | `v-bind` + 修飾子（`.prop`、`.camel`）→ `isDirective`、`isDynamicValue`      |
+| `^(?:v-bind:\|:\|v-on:\|@)\\[`    | 動的属性/イベント名（`:[expr]`、`@[expr]`）→ `isDirective`、`isDynamicValue` |
+| `^(?:v-bind:\|:)([^.]+)$`         | `v-bind:attr` / `:attr` → `potentialName=$1`、`isDynamicValue`               |
+| `^(?:v-on:\|@)([^.]+)(?:\\..+)?$` | `v-on:event` / `@event` → `potentialName=on$1`、`isDynamicValue`             |
+| `^v-model(?:$\|\\.)`              | `v-model` → `isDirective`、`isDynamicValue`                                  |
+| `^(?:v-slot:\|#)`                 | `v-slot` / `#` ショートハンド → `isDirective`、`isDynamicValue`              |
+| `^v-`                             | その他の `v-*` ディレクティブ → `isDirective`、`isDynamicValue`              |
+
+`v-bind:attr` パターンは `isDuplicatable: ['class', 'style']` も設定しており、これらの属性がバインドされた同等物と並んで出現できるようにします。
+
 ### グローバル属性
 
 以下のグローバル属性が `def['#globalAttrs']['#extends']` 配下に登録されています:

package/ARCHITECTURE.md

@@ -6,6 +6,23 @@
 
 ## ExtendedSpec Content
 
+### `directivePatterns`
+
+The spec declares a `directivePatterns` array that the core engine uses to resolve Vue directive attributes. Patterns are evaluated in order (first match wins):
+
+| Pattern                           | Result                                                                                 |
+| --------------------------------- | -------------------------------------------------------------------------------------- |
+| `^\\.(.+)$`                       | `.prop` shorthand (Vue 3.2+) -> `isDirective`, `isDynamicValue`                        |
+| `^(?:v-bind:\|:)([^.]+)\\..+$`    | `v-bind` with modifier (`.prop`, `.camel`) -> `isDirective`, `isDynamicValue`          |
+| `^(?:v-bind:\|:\|v-on:\|@)\\[`    | Dynamic attribute/event name (`:[expr]`, `@[expr]`) -> `isDirective`, `isDynamicValue` |
+| `^(?:v-bind:\|:)([^.]+)$`         | `v-bind:attr` / `:attr` -> `potentialName=$1`, `isDynamicValue`                        |
+| `^(?:v-on:\|@)([^.]+)(?:\\..+)?$` | `v-on:event` / `@event` -> `potentialName=on$1`, `isDynamicValue`                      |
+| `^v-model(?:$\|\\.)`              | `v-model` -> `isDirective`, `isDynamicValue`                                           |
+| `^(?:v-slot:\|#)`                 | `v-slot` / `#` shorthand -> `isDirective`, `isDynamicValue`                            |
+| `^v-`                             | Other `v-*` directives -> `isDirective`, `isDynamicValue`                              |
+
+The `v-bind:attr` pattern also sets `isDuplicatable: ['class', 'style']`, allowing these attributes to appear alongside their bound equivalents.
+
 ### Global Attributes
 
 The following global attributes are registered under `def['#globalAttrs']['#extends']`:

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-alpha.1](https://github.com/markuplint/markuplint/compare/v5.0.0-alpha.0...v5.0.0-alpha.1) (2026-02-22)
+
+**Note:** Version bump only for package @markuplint/vue-spec
+
+# [5.0.0-alpha.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v5.0.0-alpha.0) (2026-02-20)
+
+### Features
+
+- **vue-spec:** add directivePatterns for Vue directive resolution ([2873205](https://github.com/markuplint/markuplint/commit/2873205cff7a7f0c2cc945e008a27e9592bcc876))
+
 ## [4.5.23](https://github.com/markuplint/markuplint/compare/@markuplint/vue-spec@4.5.22...@markuplint/vue-spec@4.5.23) (2026-02-10)
 
 **Note:** Version bump only for package @markuplint/vue-spec

package/lib/index.js

@@ -16,6 +16,57 @@
  * element is marked as allowing additional dynamic properties.
  */
 const spec = {
+    directivePatterns: [
+        // .propName shorthand (Vue 3.2+, equivalent to v-bind:propName.prop)
+        {
+            pattern: '^\\.(.+)$',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        // v-bind/: with .prop or .camel modifier → isDirective
+        {
+            pattern: '^(?:v-bind:|:)([^.]+)\\..+$',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        // Dynamic attribute/event names with brackets (e.g., :[dynamicAttr], @[dynamicEvent])
+        {
+            pattern: '^(?:v-bind:|:|v-on:|@)\\[',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        // v-bind:attr or :attr (no modifier) → potentialName=attr, isDynamicValue
+        {
+            pattern: '^(?:v-bind:|:)([^.]+)$',
+            potentialName: '$1',
+            isDynamicValue: true,
+            isDuplicatable: ['class', 'style'],
+        },
+        // v-on:event or @event (with optional modifiers)
+        {
+            pattern: '^(?:v-on:|@)([^.]+)(?:\\..+)?$',
+            potentialName: 'on$1',
+            isDynamicValue: true,
+        },
+        // v-model (with optional modifiers)
+        {
+            pattern: '^v-model(?:$|\\.)',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        // v-slot:name or #name shorthand
+        {
+            pattern: '^(?:v-slot:|#)',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        // Other v-* directives (v-show, v-if, v-for, v-text, v-html, etc.)
+        {
+            pattern: '^v-',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+    ],
     def: {
         '#globalAttrs': {
             '#extends': {

package/package.json

@@ -1,10 +1,13 @@
 {
 	"name": "@markuplint/vue-spec",
-	"version": "4.5.23",
+	"version": "5.0.0-alpha.1",
 	"description": "Extended specification for tags and attributes in Vue",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
+	"engines": {
+		"node": ">=22"
+	},
 	"type": "module",
 	"exports": {
 		".": {
@@ -21,7 +24,7 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-spec": "4.10.2"
+		"@markuplint/ml-spec": "5.0.0-alpha.1"
 	},
-	"gitHead": "193ee7c1262bbed95424e38efdf1a8e56ff049f4"
+	"gitHead": "78a295e73a097a1ce09c777c06fa21ab68136387"
 }