@markuplint/htmx-spec 5.0.0-alpha.0

package/ARCHITECTURE.md

@@ -0,0 +1,129 @@
+# @markuplint/htmx-spec
+
+## Overview
+
+`@markuplint/htmx-spec` is a spec extension package that provides htmx-specific attribute definitions for markuplint. It exports a single `ExtendedSpec` object that registers global htmx attributes (such as `hx-get`, `hx-post`, `hx-trigger`, `hx-target`, `hx-swap`, and many more) available on every HTML element.
+
+This package contains no parsing logic -- it is purely a data definition consumed by `@markuplint/ml-spec` to extend the base HTML specification with htmx-specific attributes.
+
+## ExtendedSpec Content
+
+### Global Attributes
+
+Global attributes are defined under `def['#globalAttrs']['#extends']` and are available on every HTML element:
+
+#### HTTP Request Attributes
+
+| Attribute   | Type  | Description                              |
+| ----------- | ----- | ---------------------------------------- |
+| `hx-get`    | `Any` | Issues a GET request to the given URL    |
+| `hx-post`   | `Any` | Issues a POST request to the given URL   |
+| `hx-put`    | `Any` | Issues a PUT request to the given URL    |
+| `hx-patch`  | `Any` | Issues a PATCH request to the given URL  |
+| `hx-delete` | `Any` | Issues a DELETE request to the given URL |
+
+#### Core Behavior Attributes
+
+| Attribute       | Type      | Description                                            |
+| --------------- | --------- | ------------------------------------------------------ |
+| `hx-trigger`    | `Any`     | Specifies what triggers the AJAX request               |
+| `hx-target`     | `Any`     | Specifies the target element for content swapping      |
+| `hx-swap`       | `Any`     | Controls how the response content is swapped in        |
+| `hx-swap-oob`   | `Any`     | Marks content for out-of-band swap                     |
+| `hx-select`     | `Any`     | Selects a subset of the response HTML                  |
+| `hx-select-oob` | `Any`     | Selects content from the response for out-of-band swap |
+| `hx-boost`      | `Boolean` | Progressively enhances anchors and forms to use AJAX   |
+
+#### Request Configuration Attributes
+
+| Attribute        | Type  | Description                                       |
+| ---------------- | ----- | ------------------------------------------------- |
+| `hx-push-url`    | `Any` | Pushes the request URL into the browser location  |
+| `hx-replace-url` | `Any` | Replaces the current URL in the browser location  |
+| `hx-include`     | `Any` | Includes additional element values in the request |
+| `hx-params`      | `Any` | Filters which parameters are submitted            |
+| `hx-vals`        | `Any` | Adds additional values to request parameters      |
+| `hx-headers`     | `Any` | Adds custom headers to the AJAX request           |
+| `hx-encoding`    | `Any` | Changes the request encoding type                 |
+| `hx-request`     | `Any` | Configures various aspects of the AJAX request    |
+
+#### UI Feedback Attributes
+
+| Attribute         | Type  | Description                                       |
+| ----------------- | ----- | ------------------------------------------------- |
+| `hx-indicator`    | `Any` | Specifies the loading indicator element           |
+| `hx-disabled-elt` | `Any` | Specifies elements to disable during the request  |
+| `hx-confirm`      | `Any` | Shows a confirm dialog before issuing the request |
+| `hx-prompt`       | `Any` | Shows a prompt dialog before issuing the request  |
+
+#### Inheritance & Processing Attributes
+
+| Attribute       | Type      | Description                                             |
+| --------------- | --------- | ------------------------------------------------------- |
+| `hx-disinherit` | `Any`     | Disables attribute inheritance for specified attributes |
+| `hx-inherit`    | `Any`     | Explicitly enables attribute inheritance                |
+| `hx-ext`        | `Any`     | Enables htmx extensions                                 |
+| `hx-disable`    | `Boolean` | Disables htmx processing for the element                |
+
+#### History & Preservation Attributes
+
+| Attribute        | Type      | Description                                           |
+| ---------------- | --------- | ----------------------------------------------------- |
+| `hx-history`     | `Any`     | Prevents sensitive data from being saved to history   |
+| `hx-history-elt` | `Boolean` | Designates the element as the history snapshot target |
+| `hx-preserve`    | `Boolean` | Preserves an element unchanged across requests        |
+
+#### Synchronization & Validation Attributes
+
+| Attribute     | Type      | Description                                          |
+| ------------- | --------- | ---------------------------------------------------- |
+| `hx-sync`     | `Any`     | Synchronizes AJAX requests between multiple elements |
+| `hx-validate` | `Boolean` | Forces elements to validate before a request is made |
+
+## Directory Structure
+
+```
+src/
+└── index.ts    — Exports the ExtendedSpec object with htmx-specific attributes
+```
+
+## Key Source Files
+
+| File       | Purpose                                                             |
+| ---------- | ------------------------------------------------------------------- |
+| `index.ts` | Defines and exports the `ExtendedSpec` object as the default export |
+
+## Integration Points
+
+```mermaid
+flowchart LR
+    subgraph upstream ["Upstream"]
+        htmlSpec["@markuplint/html-spec\n(Base HTML spec)"]
+    end
+
+    subgraph pkg ["@markuplint/htmx-spec"]
+        spec["ExtendedSpec\n(htmx attributes)"]
+    end
+
+    subgraph downstream ["Downstream"]
+        mlSpec["@markuplint/ml-spec\n(Spec resolution)"]
+        mlCore["@markuplint/ml-core\n(Linting engine)"]
+    end
+
+    htmlSpec -->|"Base spec"| mlSpec
+    spec -->|"Extends"| mlSpec
+    mlSpec -->|"Resolved spec"| mlCore
+```
+
+### Upstream
+
+- **`@markuplint/ml-spec`** -- Provides the `ExtendedSpec` type that this package implements
+
+### Downstream
+
+- **`@markuplint/ml-spec`** -- Consumes the `ExtendedSpec` object to merge htmx-specific attributes into the resolved specification
+- **`@markuplint/ml-core`** -- Uses the resolved spec (including htmx extensions) during linting
+
+## Documentation Map
+
+- [Maintenance Guide](docs/maintenance.md) -- Commands, recipes, and ExtendedSpec type reference

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+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.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v5.0.0-alpha.0) (2026-02-20)
+
+### Features
+
+- add @markuplint/htmx-spec and @markuplint/alpine-spec packages ([75f5cd6](https://github.com/markuplint/markuplint/commit/75f5cd68e33ef3a53483254c2956f8c07ec235b6))
+- **ml-spec:** add declarative directivePatterns for parser-less framework support ([ceb9aa6](https://github.com/markuplint/markuplint/commit/ceb9aa67048e3a058b40a9e4d91eb903c8ff1861))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-2024 Yusuke Hirao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @markuplint/htmx-spec
+
+[![npm version](https://badge.fury.io/js/%40markuplint%2Fhtmx-spec.svg)](https://www.npmjs.com/package/@markuplint/htmx-spec)
+
+Use **markuplint** with [**htmx**](https://htmx.org/).
+Add htmx specific attributes to the schema.
+
+## Install
+
+```shell
+$ npm install -D @markuplint/htmx-spec
+
+$ yarn add -D @markuplint/htmx-spec
+```
+
+## Usage
+
+Add `specs` option to your [configuration](https://markuplint.dev/configuration/#properties/specs).
+
+```json
+{
+  "specs": {
+    "\\.html$": "@markuplint/htmx-spec"
+  }
+}
+```

package/SKILL.md

@@ -0,0 +1,64 @@
+---
+description: Maintenance tasks for @markuplint/htmx-spec
+globs:
+  - packages/@markuplint/htmx-spec/src/**/*.ts
+alwaysApply: false
+---
+
+# htmx-spec-maintenance
+
+Perform maintenance tasks for `@markuplint/htmx-spec`: add global attributes
+and modify the ExtendedSpec object.
+
+## Input
+
+`$ARGUMENTS` specifies the task. Supported tasks:
+
+| Task                   | Description                                    |
+| ---------------------- | ---------------------------------------------- |
+| `add-global-attribute` | Add a new global attribute to the ExtendedSpec |
+
+If omitted, defaults to `add-global-attribute`.
+
+## Reference
+
+Before executing any task, read `docs/maintenance.md` (or `docs/maintenance.ja.md`)
+for the full guide. The recipes there are the source of truth for procedures.
+
+Also read:
+
+- `ARCHITECTURE.md` -- Package overview, ExtendedSpec content, and integration points
+- `src/index.ts` -- ExtendedSpec object definition (source of truth)
+
+## Task: add-global-attribute
+
+Add a new global htmx attribute available on every HTML element. Follow recipe #1 in `docs/maintenance.md`.
+
+### Step 1: Identify the attribute
+
+1. Determine the attribute name, type (`Any`, `Boolean`, or a specific type), and description
+2. Check the htmx documentation to confirm the attribute is valid
+
+### Step 2: Add the attribute
+
+1. Read `src/index.ts`
+2. Add a new entry under `def['#globalAttrs']['#extends']`:
+   ```ts
+   'hx-attributeName': {
+       type: 'Any', // or 'Boolean'
+   },
+   ```
+3. Add a JSDoc comment above the entry describing its purpose
+
+### Step 3: Verify
+
+1. Build: `yarn build --scope @markuplint/htmx-spec`
+2. Confirm the attribute appears in the exported spec object
+
+## Rules
+
+1. **Only export an ExtendedSpec object** -- this package contains no parsing logic.
+2. **All htmx attributes are global** -- they go under `def['#globalAttrs']['#extends']`.
+3. **htmx attributes are prefixed with `hx-`** -- follow this naming convention.
+4. **Each attribute needs at minimum a `type` field** -- valid types include `Any`, `Boolean`, and specific type strings.
+5. **Add JSDoc comments** to all new attribute entries describing their purpose.

package/docs/maintenance.ja.md

@@ -0,0 +1,76 @@
+# メンテナンスガイド
+
+## コマンド
+
+| コマンド                                   | 説明                   |
+| ------------------------------------------ | ---------------------- |
+| `yarn build --scope @markuplint/htmx-spec` | このパッケージをビルド |
+| `yarn dev --scope @markuplint/htmx-spec`   | ウォッチモードでビルド |
+| `yarn clean --scope @markuplint/htmx-spec` | ビルド成果物を削除     |
+
+## テスト
+
+このパッケージには専用のテストスイートはありません。`ExtendedSpec` オブジェクトは、`@markuplint/ml-spec` の `ExtendedSpec` 型に対する TypeScript 型チェックにより、ビルド時に検証されます。エクスポートされたオブジェクトが型に適合しない場合、ビルドが失敗します。
+
+統合テストは下流で行われます:
+
+- `@markuplint/ml-spec` が拡張仕様を解決し、基本 HTML 仕様とマージ
+- `@markuplint/ml-core` がリント時に解決済み仕様を使用し、属性定義を実行
+
+変更を検証するには、パッケージをビルドして下流のテストを実行します:
+
+```shell
+yarn build --scope @markuplint/htmx-spec
+yarn test --scope @markuplint/ml-spec --scope @markuplint/ml-core
+```
+
+## レシピ
+
+### 1. グローバル属性の追加
+
+htmx の属性はすべてグローバルです -- すべての HTML 要素で利用可能です。
+
+1. `src/index.ts` を開く
+2. `def['#globalAttrs']['#extends']` の下に新しいエントリを追加:
+   ```ts
+   /** 属性の説明 */
+   'hx-attributeName': {
+       type: 'Any', // または 'Boolean'
+   },
+   ```
+3. 適切な型を選択:
+   - `'Any'` -- 任意の値を受け付ける（文字列、式など）
+   - `'Boolean'` -- ブール属性（存在が `true` を意味する）
+4. ビルド: `yarn build --scope @markuplint/htmx-spec`
+
+## ExtendedSpec 型リファレンス
+
+`ExtendedSpec` 型（`@markuplint/ml-spec` から）は、このパッケージに関連する以下の構造を持ちます:
+
+```ts
+interface ExtendedSpec {
+  cites?: string[];
+  def?: {
+    '#globalAttrs'?: {
+      '#extends': Record<string, AttributeSpec>;
+    };
+  };
+  specs?: Array<{
+    name: string;
+    attributes: Record<string, AttributeSpec>;
+  }>;
+}
+```
+
+### AttributeSpec のフィールド
+
+| フィールド      | 型         | 必須   | 説明                                    |
+| --------------- | ---------- | ------ | --------------------------------------- |
+| `type`          | `string`   | はい   | 属性値の型（`'Any'`、`'Boolean'` など） |
+| `caseSensitive` | `boolean`  | いいえ | 属性名の大文字小文字を区別するかどうか  |
+| `condition`     | `string[]` | いいえ | 属性が適用される CSS セレクタ条件       |
+
+### 型の値
+
+- `'Any'` -- 属性は任意の値を受け付ける
+- `'Boolean'` -- 属性はブール値（存在が `true` を示す）

package/docs/maintenance.md

@@ -0,0 +1,76 @@
+# Maintenance Guide
+
+## Commands
+
+| Command                                    | Description            |
+| ------------------------------------------ | ---------------------- |
+| `yarn build --scope @markuplint/htmx-spec` | Build this package     |
+| `yarn dev --scope @markuplint/htmx-spec`   | Watch mode build       |
+| `yarn clean --scope @markuplint/htmx-spec` | Remove build artifacts |
+
+## Testing
+
+This package has no dedicated test suite. The `ExtendedSpec` object is validated at build time through TypeScript type checking against the `ExtendedSpec` type from `@markuplint/ml-spec`. If the exported object does not conform to the type, the build will fail.
+
+Integration testing occurs downstream:
+
+- `@markuplint/ml-spec` resolves the extended spec and merges it with the base HTML spec
+- `@markuplint/ml-core` uses the resolved spec during linting, which exercises the attribute definitions
+
+To verify changes, build the package and run downstream tests:
+
+```shell
+yarn build --scope @markuplint/htmx-spec
+yarn test --scope @markuplint/ml-spec --scope @markuplint/ml-core
+```
+
+## Recipes
+
+### 1. Adding a Global Attribute
+
+All htmx attributes are global -- they are available on every HTML element.
+
+1. Open `src/index.ts`
+2. Add a new entry under `def['#globalAttrs']['#extends']`:
+   ```ts
+   /** Description of the attribute */
+   'hx-attributeName': {
+       type: 'Any', // or 'Boolean'
+   },
+   ```
+3. Choose the appropriate type:
+   - `'Any'` -- accepts any value (strings, expressions, etc.)
+   - `'Boolean'` -- boolean attribute (presence indicates `true`)
+4. Build: `yarn build --scope @markuplint/htmx-spec`
+
+## ExtendedSpec Type Reference
+
+The `ExtendedSpec` type (from `@markuplint/ml-spec`) has the following structure relevant to this package:
+
+```ts
+interface ExtendedSpec {
+  cites?: string[];
+  def?: {
+    '#globalAttrs'?: {
+      '#extends': Record<string, AttributeSpec>;
+    };
+  };
+  specs?: Array<{
+    name: string;
+    attributes: Record<string, AttributeSpec>;
+  }>;
+}
+```
+
+### AttributeSpec Fields
+
+| Field           | Type       | Required | Description                                            |
+| --------------- | ---------- | -------- | ------------------------------------------------------ |
+| `type`          | `string`   | Yes      | The attribute value type (`'Any'`, `'Boolean'`, etc.)  |
+| `caseSensitive` | `boolean`  | No       | Whether the attribute name is case-sensitive           |
+| `condition`     | `string[]` | No       | CSS selector conditions for when the attribute applies |
+
+### Type Values
+
+- `'Any'` -- The attribute accepts any value
+- `'Boolean'` -- The attribute is a boolean (presence indicates `true`)

package/lib/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module @markuplint/htmx-spec
+ *
+ * Provides htmx-specific extended specifications for markuplint.
+ * Defines htmx's global attributes (`hx-get`, `hx-post`, `hx-trigger`,
+ * `hx-target`, `hx-swap`, etc.) that are available on any HTML element.
+ *
+ * htmx is a library that allows access to modern browser features
+ * directly from HTML, using attributes to configure AJAX requests,
+ * CSS transitions, WebSockets, and Server-Sent Events.
+ *
+ * @see https://htmx.org/reference/
+ */
+import type { ExtendedSpec } from '@markuplint/ml-spec';
+/**
+ * The htmx framework extended specification.
+ *
+ * Registers global htmx attributes available on every HTML element.
+ * htmx attributes are all global and prefixed with `hx-`.
+ */
+declare const spec: ExtendedSpec;
+export default spec;

package/lib/index.js

@@ -0,0 +1,266 @@
+/**
+ * @module @markuplint/htmx-spec
+ *
+ * Provides htmx-specific extended specifications for markuplint.
+ * Defines htmx's global attributes (`hx-get`, `hx-post`, `hx-trigger`,
+ * `hx-target`, `hx-swap`, etc.) that are available on any HTML element.
+ *
+ * htmx is a library that allows access to modern browser features
+ * directly from HTML, using attributes to configure AJAX requests,
+ * CSS transitions, WebSockets, and Server-Sent Events.
+ *
+ * @see https://htmx.org/reference/
+ */
+/**
+ * The htmx framework extended specification.
+ *
+ * Registers global htmx attributes available on every HTML element.
+ * htmx attributes are all global and prefixed with `hx-`.
+ */
+const spec = {
+    cites: ['https://htmx.org/reference/'],
+    directivePatterns: [
+        /**
+         * htmx event with explicit prefix: hx-on:htmx:event or hx-on-htmx-event
+         * @see https://htmx.org/attributes/hx-on/
+         */
+        {
+            pattern: '^hx-on([:-])htmx\\1(.+)$',
+            potentialName: 'hx-on:htmx:$2',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        /**
+         * htmx event with shorthand double separator: hx-on::event
+         * @see https://htmx.org/attributes/hx-on/
+         */
+        {
+            pattern: '^hx-on[:-]{2}(.+)$',
+            potentialName: 'hx-on:htmx:$1',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+        /**
+         * Native DOM event: hx-on:click, hx-on-click
+         * @see https://htmx.org/attributes/hx-on/
+         */
+        {
+            pattern: '^hx-on[:-]([a-z]+)$',
+            potentialName: 'on$1',
+            isDirective: true,
+            isDynamicValue: true,
+        },
+    ],
+    def: {
+        '#globalAttrs': {
+            '#extends': {
+                /**
+                 * Issues a GET request to the given URL
+                 */
+                'hx-get': {
+                    type: 'Any',
+                },
+                /**
+                 * Issues a POST request to the given URL
+                 */
+                'hx-post': {
+                    type: 'Any',
+                },
+                /**
+                 * Issues a PUT request to the given URL
+                 */
+                'hx-put': {
+                    type: 'Any',
+                },
+                /**
+                 * Issues a PATCH request to the given URL
+                 */
+                'hx-patch': {
+                    type: 'Any',
+                },
+                /**
+                 * Issues a DELETE request to the given URL
+                 */
+                'hx-delete': {
+                    type: 'Any',
+                },
+                /**
+                 * Specifies the event that triggers the request.
+                 * Accepts standard DOM events, special events (load, revealed, intersect),
+                 * polling syntax (every Ns), event filters, and modifiers.
+                 */
+                'hx-trigger': {
+                    type: 'Any',
+                },
+                /**
+                 * Specifies the target element for the response content swap.
+                 * Accepts CSS selectors, `this`, `closest <selector>`,
+                 * `find <selector>`, `next`, `previous`.
+                 */
+                'hx-target': {
+                    type: 'Any',
+                },
+                /**
+                 * Controls how the response content is swapped into the DOM.
+                 * Values: innerHTML, outerHTML, textContent, beforebegin,
+                 * afterbegin, beforeend, afterend, delete, none.
+                 */
+                'hx-swap': {
+                    type: 'Any',
+                },
+                /**
+                 * Marks content in the response for out-of-band swap
+                 */
+                'hx-swap-oob': {
+                    type: 'Any',
+                },
+                /**
+                 * Selects a subset of the response HTML to swap in
+                 */
+                'hx-select': {
+                    type: 'Any',
+                },
+                /**
+                 * Selects content from the response to be swapped out-of-band
+                 */
+                'hx-select-oob': {
+                    type: 'Any',
+                },
+                /**
+                 * Progressively enhances anchor tags and forms to use AJAX
+                 */
+                'hx-boost': {
+                    type: 'Boolean',
+                },
+                /**
+                 * Pushes the request URL into the browser location bar, creating a history entry
+                 */
+                'hx-push-url': {
+                    type: 'Any',
+                },
+                /**
+                 * Replaces the current URL in the browser location bar without adding to history
+                 */
+                'hx-replace-url': {
+                    type: 'Any',
+                },
+                /**
+                 * Includes additional element values in the request
+                 */
+                'hx-include': {
+                    type: 'Any',
+                },
+                /**
+                 * Filters which parameters are submitted with the request
+                 */
+                'hx-params': {
+                    type: 'Any',
+                },
+                /**
+                 * Adds additional values to the request parameters (JSON or js: prefix)
+                 */
+                'hx-vals': {
+                    type: 'Any',
+                },
+                /**
+                 * Adds custom headers to the AJAX request (JSON format)
+                 */
+                'hx-headers': {
+                    type: 'Any',
+                },
+                /**
+                 * Changes the request encoding type (e.g., multipart/form-data)
+                 */
+                'hx-encoding': {
+                    type: 'Any',
+                },
+                /**
+                 * Configures various aspects of the AJAX request
+                 */
+                'hx-request': {
+                    type: 'Any',
+                },
+                /**
+                 * Specifies the element that receives the `htmx-request` class during the request
+                 */
+                'hx-indicator': {
+                    type: 'Any',
+                },
+                /**
+                 * Specifies elements that get the `disabled` attribute during the request
+                 */
+                'hx-disabled-elt': {
+                    type: 'Any',
+                },
+                /**
+                 * Shows a confirm() dialog before issuing the request
+                 */
+                'hx-confirm': {
+                    type: 'Any',
+                },
+                /**
+                 * Shows a prompt() dialog; the user's input is included
+                 * in the request as the HX-Prompt header
+                 */
+                'hx-prompt': {
+                    type: 'Any',
+                },
+                /**
+                 * Disables attribute inheritance for specified htmx attributes on child elements
+                 */
+                'hx-disinherit': {
+                    type: 'Any',
+                },
+                /**
+                 * Explicitly enables attribute inheritance for specified attributes
+                 */
+                'hx-inherit': {
+                    type: 'Any',
+                },
+                /**
+                 * Enables htmx extensions for the element and its children
+                 */
+                'hx-ext': {
+                    type: 'Any',
+                },
+                /**
+                 * Disables htmx processing for the element and all its children
+                 */
+                'hx-disable': {
+                    type: 'Boolean',
+                },
+                /**
+                 * Prevents sensitive data from being saved to the history cache
+                 */
+                'hx-history': {
+                    type: 'Any',
+                },
+                /**
+                 * Designates the element as the snapshot/restore target during history navigation
+                 */
+                'hx-history-elt': {
+                    type: 'Boolean',
+                },
+                /**
+                 * Preserves an element unchanged across requests (requires an id)
+                 */
+                'hx-preserve': {
+                    type: 'Boolean',
+                },
+                /**
+                 * Synchronizes AJAX requests between multiple elements to prevent race conditions
+                 */
+                'hx-sync': {
+                    type: 'Any',
+                },
+                /**
+                 * Forces elements to validate themselves before a request is made
+                 */
+                'hx-validate': {
+                    type: 'Boolean',
+                },
+            },
+        },
+    },
+};
+export default spec;

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "@markuplint/htmx-spec",
+	"version": "5.0.0-alpha.0",
+	"description": "Extended specification for tags and attributes in htmx",
+	"repository": "git@github.com:markuplint/markuplint.git",
+	"author": "Yusuke Hirao <yusukehirao@me.com>",
+	"license": "MIT",
+	"engines": {
+		"node": ">=22"
+	},
+	"type": "module",
+	"exports": {
+		".": {
+			"import": "./lib/index.js",
+			"types": "./lib/index.d.ts"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc --project tsconfig.build.json",
+		"dev": "tsc --watch --project tsconfig.build.json",
+		"clean": "tsc --build --clean tsconfig.build.json"
+	},
+	"dependencies": {
+		"@markuplint/ml-spec": "5.0.0-alpha.0"
+	},
+	"gitHead": "13dcfc84ec83d87360c720e253383b60767e1b56"
+}