@markuplint/svelte-spec 5.0.0-rc.2 → 5.0.0-rc.5

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-rc.5](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.4...v5.0.0-rc.5) (2026-08-28)
+
+**Note:** Version bump only for package @markuplint/svelte-spec
+
+# [5.0.0-rc.4](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.3...v5.0.0-rc.4) (2026-04-19)
+
+**Note:** Version bump only for package @markuplint/svelte-spec
+
+# [5.0.0-rc.3](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.2...v5.0.0-rc.3) (2026-04-19)
+
+**Note:** Version bump only for package @markuplint/svelte-spec
+
 # [5.0.0-rc.2](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.1...v5.0.0-rc.2) (2026-04-15)
 
 **Note:** Version bump only for package @markuplint/svelte-spec

package/lib/index.d.ts

@@ -5,6 +5,11 @@
  * Defines element-level attribute overrides for Svelte's two-way
  * binding behavior on form elements and IDL property attributes
  * such as `defaultValue`, `defaultChecked`, and `indeterminate`.
+ *
+ * This package intentionally has no test files: it exports only a
+ * static data object whose shape is verified by the TypeScript build
+ * against the `ExtendedSpec` type, and its behavior is covered by the
+ * `@markuplint/svelte-parser` integration tests.
  */
 import type { ExtendedSpec } from '@markuplint/ml-spec';
 /**

package/lib/index.js

@@ -5,6 +5,11 @@
  * Defines element-level attribute overrides for Svelte's two-way
  * binding behavior on form elements and IDL property attributes
  * such as `defaultValue`, `defaultChecked`, and `indeterminate`.
+ *
+ * This package intentionally has no test files: it exports only a
+ * static data object whose shape is verified by the TypeScript build
+ * against the `ExtendedSpec` type, and its behavior is covered by the
+ * `@markuplint/svelte-parser` integration tests.
  */
 /**
  * The Svelte framework extended specification.
@@ -14,6 +19,13 @@
  * attributes on form elements.
  */
 const spec = {
+    /**
+     * `'both'` rather than `'idl'` (React) because Svelte templates use
+     * standard HTML content attribute names, so IDL spellings must not be
+     * suggested as renames; IDL names such as `defaultValue` are still
+     * resolved to their content attribute equivalents by `MLAttr` in
+     * `@markuplint/ml-core`, not by the parser.
+     */
     acceptedAttrNames: 'both',
     def: {
         '#globalAttrs': {
@@ -34,6 +46,12 @@ const spec = {
             },
         },
     },
+    /**
+     * The core engine evaluates these in order and the first match wins,
+     * so `^bind:(?:group|this)$` must precede the generic `^bind:(.+)$`;
+     * otherwise `bind:group` / `bind:this` would resolve to nonexistent
+     * `group` / `this` attributes instead of staying directives.
+     */
     directivePatterns: [
         // bind:group, bind:this → true directives
         {
@@ -96,6 +114,11 @@ const spec = {
         {
             name: 'select',
             attributes: {
+                /**
+                 * Standard HTML has no `value` content attribute on `select`;
+                 * Svelte accepts it, and `bind:value` allows any type, not
+                 * just strings.
+                 */
                 value: {
                     type: 'Any',
                 },
@@ -108,6 +131,11 @@ const spec = {
         {
             name: 'textarea',
             attributes: {
+                /**
+                 * Standard HTML has no `value` content attribute on `textarea`;
+                 * Svelte accepts it, and `bind:value` allows any type, not
+                 * just strings.
+                 */
                 value: {
                     type: 'Any',
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@markuplint/svelte-spec",
-	"version": "5.0.0-rc.2",
+	"version": "5.0.0-rc.5",
 	"description": "Extended specification for tags and attributes in Svelte",
 	"repository": {
 		"type": "git",
@@ -10,7 +10,7 @@
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
 	"engines": {
-		"node": ">=22"
+		"node": ">=24"
 	},
 	"type": "module",
 	"exports": {
@@ -28,7 +28,7 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/ml-spec": "5.0.0-rc.2"
+		"@markuplint/ml-spec": "5.0.0-rc.5"
 	},
-	"gitHead": "e43763858d9234c417053becc73dbd088c1e7ea6"
+	"gitHead": "8d87463af2ff3f1b83fb28da20f1819362cf3555"
 }

package/ARCHITECTURE.ja.md

@@ -1,98 +0,0 @@
-# @markuplint/svelte-spec
-
-## 概要
-
-`@markuplint/svelte-spec` は markuplint 向けの Svelte 固有の拡張仕様を提供します。Svelte のフォーム要素における双方向バインディング動作と IDL プロパティ属性に対応するため、要素レベルの属性オーバーライドを定義する `ExtendedSpec` オブジェクトをエクスポートします。`<select>` と `<textarea>` 要素の `value` 属性の型を `Any` に拡張するほか、`<input>`、`<select>`、`<textarea>` 要素で `defaultValue`、`defaultChecked`、`indeterminate` などの IDL プロパティ属性をサポートします。
-
-## ExtendedSpec の内容
-
-### `acceptedAttrNames`
-
-この spec は `acceptedAttrNames: 'both'` を設定しており、`@markuplint/ml-core` の `MLAttr` コンストラクタに IDL 属性名を HTML コンテンツ属性名に解決するよう指示します（例: `defaultValue` → 対応するコンテンツ属性）。`'both'` モードではコンテンツ属性名と IDL 名の両方が受け入れられ、リネーム候補は提示されません。この解決はパーサーではなくコアレベルで行われます。
-
-### `contenteditable` オーバーライド
-
-Svelte は `contentEditable` 属性の値として `"inherit"` を受け付けます（ContentEditable インターフェースの IDL 状態値）。この仕様はグローバル属性 `contenteditable` の型を拡張し、`"inherit"` を有効な列挙値として追加します。
-
-### `directivePatterns`
-
-この spec は Svelte ディレクティブ属性を解決するための `directivePatterns` 配列を宣言します。パターンは順番に評価されます（最初のマッチが優先）:
-
-| パターン                                       | 結果                                                                            |
-| ---------------------------------------------- | ------------------------------------------------------------------------------- |
-| `^bind:(?:group\|this)$`                       | `bind:group` / `bind:this` → `isDirective`、`isDynamicValue`                    |
-| `^bind:(.+)$`                                  | `bind:name` → `potentialName=$1`、`isDynamicValue`                              |
-| `^on:.+$`                                      | `on:event`（Svelte 4 レガシー）→ `isDirective`、`isDynamicValue`                |
-| `^class:`                                      | `class:name` → `potentialName=class`、`isDuplicatable`、`isDynamicValue`        |
-| `^style:`                                      | `style:property` → `potentialName=style`、`isDuplicatable`、`isDynamicValue`    |
-| `^(?:animate\|transition\|in\|out\|use\|let):` | アニメーション/トランジション/アクション/スロットディレクティブ → `isDirective` |
-
-### 要素固有のオーバーライド
-
-| 要素         | 属性             | 型オーバーライド | 理由                                                         |
-| ------------ | ---------------- | ---------------- | ------------------------------------------------------------ |
-| `<input>`    | `defaultChecked` | `Boolean`        | チェックボックス/ラジオの非制御初期状態を表す IDL プロパティ |
-| `<input>`    | `defaultValue`   | `Any`            | 入力要素の非制御初期値を表す IDL プロパティ                  |
-| `<input>`    | `indeterminate`  | `Boolean`        | チェックボックスの不定状態を表す IDL プロパティ              |
-| `<select>`   | `value`          | `Any`            | Svelte の `bind:value` は文字列だけでなく任意の型を許容      |
-| `<select>`   | `defaultValue`   | `Any`            | セレクト要素の非制御初期値を表す IDL プロパティ              |
-| `<textarea>` | `value`          | `Any`            | Svelte の `bind:value` は文字列だけでなく任意の型を許容      |
-| `<textarea>` | `defaultValue`   | `Any`            | テキストエリアの非制御初期値を表す IDL プロパティ            |
-
-これらのオーバーライドにより、markuplint が Svelte 固有の属性使用を不正としてフラグ付けすることなく、標準 HTML 仕様を拡張します。
-
-## ディレクトリ構成
-
-```
-src/
-└── index.ts    — Svelte 固有のオーバーライドを含む ExtendedSpec オブジェクトをエクスポート
-```
-
-## 主要ソースファイル
-
-| ファイル       | 用途                                                        |
-| -------------- | ----------------------------------------------------------- |
-| `src/index.ts` | Svelte 用の `ExtendedSpec` オブジェクトを定義・エクスポート |
-
-## 統合ポイント
-
-```mermaid
-flowchart TD
-    subgraph upstream ["上流"]
-        htmlSpec["@markuplint/html-spec\n(ベース HTML 仕様)"]
-        mlSpec["@markuplint/ml-spec\n(ExtendedSpec 型)"]
-    end
-
-    subgraph pkg ["@markuplint/svelte-spec"]
-        spec["ExtendedSpec オブジェクト\n(input, select, textarea オーバーライド)"]
-    end
-
-    subgraph downstream ["下流"]
-        mlCore["@markuplint/ml-core\n(schemaToSpec で仕様をマージ)"]
-    end
-
-    subgraph paired ["対となるパーサー"]
-        svelteParser["@markuplint/svelte-parser\n(Svelte コンポーネントのパース)"]
-    end
-
-    mlSpec -->|"ExtendedSpec 型"| spec
-    htmlSpec -->|"ベース要素定義"| mlCore
-    spec -->|"Svelte オーバーライド"| mlCore
-    svelteParser -->|"MLASTDocument を生成"| mlCore
-```
-
-### 上流
-
-- **`@markuplint/ml-spec`** -- このパッケージが実装する `ExtendedSpec` 型定義を提供
-
-### 下流
-
-- **`@markuplint/ml-core`** -- `schemaToSpec()` を通じてこの仕様を利用し、Svelte のオーバーライドをベース HTML 仕様にマージ
-
-### 対となるパーサー
-
-- **`@markuplint/svelte-parser`** -- Svelte コンポーネント構文を処理するパーサー。パーサーが Svelte テンプレートを markuplint AST に変換する一方、この spec パッケージはリンティングに必要な属性型情報を提供します。
-
-## ドキュメントマップ
-
-- [メンテナンスガイド](docs/maintenance.ja.md) -- コマンド、レシピ、型リファレンス

package/ARCHITECTURE.md

@@ -1,98 +0,0 @@
-# @markuplint/svelte-spec
-
-## Overview
-
-`@markuplint/svelte-spec` provides Svelte-specific extended specifications for markuplint. It exports an `ExtendedSpec` object that defines element-level attribute overrides to accommodate Svelte's two-way binding behavior and IDL property attributes on form elements. The `<select>` and `<textarea>` elements have their `value` attribute type broadened to `Any`, and the `<input>`, `<select>`, and `<textarea>` elements support IDL property attributes such as `defaultValue`, `defaultChecked`, and `indeterminate`.
-
-## ExtendedSpec Content
-
-### `acceptedAttrNames`
-
-The spec sets `acceptedAttrNames: 'both'`, which instructs `@markuplint/ml-core`'s `MLAttr` constructor to resolve IDL attribute names to their HTML content attribute equivalents (e.g., `defaultValue` -> the corresponding content attribute). In `'both'` mode, both content attribute names and IDL names are accepted without suggesting a rename. This resolution is performed at the core level, not in the parser.
-
-### `contenteditable` Override
-
-Svelte accepts `"inherit"` as a valid `contentEditable` value (IDL state value from the ContentEditable interface). This spec extends the global `contenteditable` attribute type to include `"inherit"` as a valid enum value.
-
-### `directivePatterns`
-
-The spec declares a `directivePatterns` array that the core engine uses to resolve Svelte directive attributes. Patterns are evaluated in order (first match wins):
-
-| Pattern                                        | Result                                                                        |
-| ---------------------------------------------- | ----------------------------------------------------------------------------- |
-| `^bind:(?:group\|this)$`                       | `bind:group` / `bind:this` -> `isDirective`, `isDynamicValue`                 |
-| `^bind:(.+)$`                                  | `bind:name` -> `potentialName=$1`, `isDynamicValue`                           |
-| `^on:.+$`                                      | `on:event` (Svelte 4 legacy) -> `isDirective`, `isDynamicValue`               |
-| `^class:`                                      | `class:name` -> `potentialName=class`, `isDuplicatable`, `isDynamicValue`     |
-| `^style:`                                      | `style:property` -> `potentialName=style`, `isDuplicatable`, `isDynamicValue` |
-| `^(?:animate\|transition\|in\|out\|use\|let):` | Animation/transition/action/slot directives -> `isDirective`                  |
-
-### Element-Specific Overrides
-
-| Element      | Attribute        | Type Override | Reason                                                     |
-| ------------ | ---------------- | ------------- | ---------------------------------------------------------- |
-| `<input>`    | `defaultChecked` | `Boolean`     | IDL property for uncontrolled checkbox/radio initial state |
-| `<input>`    | `defaultValue`   | `Any`         | IDL property for uncontrolled input initial value          |
-| `<input>`    | `indeterminate`  | `Boolean`     | IDL property for checkbox indeterminate state              |
-| `<select>`   | `value`          | `Any`         | Svelte's `bind:value` allows any type, not just strings    |
-| `<select>`   | `defaultValue`   | `Any`         | IDL property for uncontrolled select initial value         |
-| `<textarea>` | `value`          | `Any`         | Svelte's `bind:value` allows any type, not just strings    |
-| `<textarea>` | `defaultValue`   | `Any`         | IDL property for uncontrolled textarea initial value       |
-
-These overrides extend the standard HTML spec so that markuplint does not flag Svelte-specific attribute usage as invalid.
-
-## Directory Structure
-
-```
-src/
-└── index.ts    — Exports the ExtendedSpec object with Svelte-specific overrides
-```
-
-## Key Source Files
-
-| File           | Purpose                                                  |
-| -------------- | -------------------------------------------------------- |
-| `src/index.ts` | Defines and exports the `ExtendedSpec` object for Svelte |
-
-## Integration Points
-
-```mermaid
-flowchart TD
-    subgraph upstream ["Upstream"]
-        htmlSpec["@markuplint/html-spec\n(Base HTML spec)"]
-        mlSpec["@markuplint/ml-spec\n(ExtendedSpec type)"]
-    end
-
-    subgraph pkg ["@markuplint/svelte-spec"]
-        spec["ExtendedSpec object\n(input, select, textarea overrides)"]
-    end
-
-    subgraph downstream ["Downstream"]
-        mlCore["@markuplint/ml-core\n(Merges specs via schemaToSpec)"]
-    end
-
-    subgraph paired ["Paired Parser"]
-        svelteParser["@markuplint/svelte-parser\n(Svelte component parsing)"]
-    end
-
-    mlSpec -->|"ExtendedSpec type"| spec
-    htmlSpec -->|"Base element definitions"| mlCore
-    spec -->|"Svelte overrides"| mlCore
-    svelteParser -->|"Produces MLASTDocument"| mlCore
-```
-
-### Upstream
-
-- **`@markuplint/ml-spec`** -- Provides the `ExtendedSpec` type definition that this package implements
-
-### Downstream
-
-- **`@markuplint/ml-core`** -- Consumes this spec via `schemaToSpec()`, merging Svelte overrides with the base HTML spec
-
-### Paired Parser
-
-- **`@markuplint/svelte-parser`** -- The parser counterpart that handles Svelte component syntax. While the parser converts Svelte templates into the markuplint AST, this spec package provides the attribute type information needed for linting.
-
-## Documentation Map
-
-- [Maintenance Guide](docs/maintenance.md) -- Commands, recipes, and type reference

package/SKILL.md

@@ -1,99 +0,0 @@
----
-description: Maintenance tasks for @markuplint/svelte-spec
-globs:
-  - packages/@markuplint/svelte-spec/src/**/*.ts
-alwaysApply: false
----
-
-# svelte-spec-maintenance
-
-Perform maintenance tasks for `@markuplint/svelte-spec`: add global attributes,
-add element-specific attribute overrides for Svelte components.
-
-## Input
-
-`$ARGUMENTS` specifies the task. Supported tasks:
-
-| Task                   | Description                                |
-| ---------------------- | ------------------------------------------ |
-| `add-global-attribute` | Add a new global attribute for Svelte      |
-| `add-element-override` | Add an element-specific attribute override |
-
-If omitted, defaults to `add-element-override`.
-
-## 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` -- The single source file (source of truth for the spec object)
-
-## Task: add-global-attribute
-
-Add a new global attribute that applies to all Svelte elements. Follow recipe #1 in `docs/maintenance.md`.
-
-### Step 1: Read the current spec
-
-1. Read `src/index.ts` to understand the current `ExtendedSpec` structure
-2. Check if a `def` property with `#globalAttrs` already exists
-
-### Step 2: Add the global attribute
-
-1. If `def` does not exist, add it to the spec object:
-   ```ts
-   def: {
-     '#globalAttrs': {
-       '#extends': {
-         'attribute-name': {
-           type: 'Any',
-         },
-       },
-     },
-   },
-   ```
-2. If `def['#globalAttrs']['#extends']` already exists, add the new attribute to it
-
-### Step 3: Verify
-
-1. Build: `yarn build --scope @markuplint/svelte-spec`
-2. Test: `yarn test --scope @markuplint/svelte-spec`
-
-## Task: add-element-override
-
-Add an element-specific attribute override. Follow recipe #2 in `docs/maintenance.md`.
-
-### Step 1: Read the current spec
-
-1. Read `src/index.ts` to understand the current `specs` array
-2. Check if the target element already has an entry
-
-### Step 2: Add the override
-
-1. If the element already exists in `specs`, add the new attribute to its `attributes` object
-2. If the element does not exist, add a new entry to the `specs` array:
-   ```ts
-   {
-     name: 'element-name',
-     attributes: {
-       'attribute-name': {
-         type: 'Any',
-       },
-     },
-   },
-   ```
-
-### Step 3: Verify
-
-1. Build: `yarn build --scope @markuplint/svelte-spec`
-2. Test: `yarn test --scope @markuplint/svelte-spec`
-
-## Rules
-
-1. **Only export an `ExtendedSpec` object** -- this package must not contain any parsing logic.
-2. **Global attributes go under `def['#globalAttrs']['#extends']`** -- not in the `specs` array.
-3. **Element overrides go under the `specs[]` array** -- each entry needs a `name` and `attributes` object.
-4. **Each attribute needs at minimum a `type` field** -- common values are `Any`, `String`, `Boolean`, or an enum object.
-5. **Add JSDoc comments** to any new attribute definitions explaining why the override is needed.

package/docs/maintenance.ja.md

@@ -1,127 +0,0 @@
-# メンテナンスガイド
-
-## コマンド
-
-| コマンド                                     | 説明                   |
-| -------------------------------------------- | ---------------------- |
-| `yarn build --scope @markuplint/svelte-spec` | このパッケージをビルド |
-| `yarn dev --scope @markuplint/svelte-spec`   | ウォッチモードでビルド |
-| `yarn clean --scope @markuplint/svelte-spec` | ビルド成果物を削除     |
-| `yarn test --scope @markuplint/svelte-spec`  | テストを実行           |
-
-## テスト
-
-このパッケージは静的なデータオブジェクトのみをエクスポートするため、デフォルトではテストファイルがありません。検証はビルドステップで行われます（TypeScript の型チェックにより、エクスポートされたオブジェクトが `ExtendedSpec` 型に準拠していることが保証されます）。
-
-下流パッケージとの統合を検証するには:
-
-```shell
-yarn test --scope @markuplint/svelte-parser
-```
-
-## レシピ
-
-### 1. グローバル属性の追加
-
-1. `src/index.ts` を読む
-2. spec オブジェクトに `def` プロパティが存在しない場合、追加する:
-   ```ts
-   const spec: ExtendedSpec = {
-     def: {
-       '#globalAttrs': {
-         '#extends': {
-           'new-attribute': {
-             type: 'Any',
-           },
-         },
-       },
-     },
-     specs: [
-       // 既存のエントリ...
-     ],
-   };
-   ```
-3. `def['#globalAttrs']['#extends']` が既に存在する場合、既存のオブジェクトに新しい属性を追加
-4. ビルド: `yarn build --scope @markuplint/svelte-spec`
-5. 下流パーサーが正常に動作することを確認: `yarn test --scope @markuplint/svelte-parser`
-
-### 2. 要素固有のオーバーライドの追加
-
-1. `src/index.ts` を読む
-2. 対象の要素が `specs` 配列に既にエントリを持っているか確認
-3. 要素が存在する場合、その `attributes` オブジェクトに新しい属性を追加:
-   ```ts
-   {
-     name: 'existing-element',
-     attributes: {
-       existingAttr: { type: 'Any' },
-       newAttr: { type: 'Any' },  // ここに追加
-     },
-   },
-   ```
-4. 要素が存在しない場合、`specs` 配列に新しいエントリを追加:
-   ```ts
-   {
-     name: 'new-element',
-     attributes: {
-       'attribute-name': {
-         type: 'Any',
-       },
-     },
-   },
-   ```
-5. ビルド: `yarn build --scope @markuplint/svelte-spec`
-6. 下流パーサーが正常に動作することを確認: `yarn test --scope @markuplint/svelte-parser`
-
-## ExtendedSpec 型リファレンス
-
-`ExtendedSpec` 型（`@markuplint/ml-spec` から提供）は以下の構造を持ちます:
-
-```ts
-type ExtendedSpec = {
-  readonly cites?: Cites; // 参照 URL
-  readonly def?: Partial<SpecDefs>; // グローバル定義
-  readonly specs?: readonly ExtendedElementSpec[]; // 要素ごとのオーバーライド
-};
-```
-
-### `def` -- グローバル定義
-
-すべての要素に適用される属性に使用:
-
-```ts
-def: {
-  '#globalAttrs': {
-    '#extends': {
-      'attribute-name': {
-        type: 'Any',
-      },
-    },
-  },
-}
-```
-
-### `specs` -- 要素ごとのオーバーライド
-
-`specs` 配列の各エントリは特定の HTML 要素を対象とします:
-
-```ts
-specs: [
-  {
-    name: 'element-name', // HTML タグ名
-    attributes: {
-      'attribute-name': {
-        type: 'Any', // 型オーバーライド
-      },
-    },
-  },
-];
-```
-
-よく使われる属性型の値:
-
-| 型の値      | 意味                               |
-| ----------- | ---------------------------------- |
-| `'Any'`     | 任意の型を許容（バインド値に使用） |
-| `'String'`  | 文字列値のみ許容                   |
-| `'Boolean'` | ブール属性（存在/不在）            |

package/docs/maintenance.md

@@ -1,127 +0,0 @@
-# Maintenance Guide
-
-## Commands
-
-| Command                                      | Description            |
-| -------------------------------------------- | ---------------------- |
-| `yarn build --scope @markuplint/svelte-spec` | Build this package     |
-| `yarn dev --scope @markuplint/svelte-spec`   | Watch mode build       |
-| `yarn clean --scope @markuplint/svelte-spec` | Remove build artifacts |
-| `yarn test --scope @markuplint/svelte-spec`  | Run tests              |
-
-## Testing
-
-This package has no test files by default because it exports only a static data object. Verification is done through the build step (TypeScript type checking ensures the exported object conforms to the `ExtendedSpec` type).
-
-To verify integration with downstream packages:
-
-```shell
-yarn test --scope @markuplint/svelte-parser
-```
-
-## Recipes
-
-### 1. Adding a Global Attribute
-
-1. Read `src/index.ts`
-2. If the `def` property does not exist on the spec object, add it:
-   ```ts
-   const spec: ExtendedSpec = {
-     def: {
-       '#globalAttrs': {
-         '#extends': {
-           'new-attribute': {
-             type: 'Any',
-           },
-         },
-       },
-     },
-     specs: [
-       // existing entries...
-     ],
-   };
-   ```
-3. If `def['#globalAttrs']['#extends']` already exists, add the new attribute to the existing object
-4. Build: `yarn build --scope @markuplint/svelte-spec`
-5. Verify the downstream parser still works: `yarn test --scope @markuplint/svelte-parser`
-
-### 2. Adding an Element-Specific Override
-
-1. Read `src/index.ts`
-2. Check if the target element already has an entry in the `specs` array
-3. If the element exists, add the new attribute to its `attributes` object:
-   ```ts
-   {
-     name: 'existing-element',
-     attributes: {
-       existingAttr: { type: 'Any' },
-       newAttr: { type: 'Any' },  // add here
-     },
-   },
-   ```
-4. If the element does not exist, add a new entry to the `specs` array:
-   ```ts
-   {
-     name: 'new-element',
-     attributes: {
-       'attribute-name': {
-         type: 'Any',
-       },
-     },
-   },
-   ```
-5. Build: `yarn build --scope @markuplint/svelte-spec`
-6. Verify the downstream parser still works: `yarn test --scope @markuplint/svelte-parser`
-
-## ExtendedSpec Type Reference
-
-The `ExtendedSpec` type (from `@markuplint/ml-spec`) has the following structure:
-
-```ts
-type ExtendedSpec = {
-  readonly cites?: Cites; // Reference URLs
-  readonly def?: Partial<SpecDefs>; // Global definitions
-  readonly specs?: readonly ExtendedElementSpec[]; // Per-element overrides
-};
-```
-
-### `def` -- Global Definitions
-
-Used for attributes that apply to all elements:
-
-```ts
-def: {
-  '#globalAttrs': {
-    '#extends': {
-      'attribute-name': {
-        type: 'Any',
-      },
-    },
-  },
-}
-```
-
-### `specs` -- Per-Element Overrides
-
-Each entry in the `specs` array targets a specific HTML element:
-
-```ts
-specs: [
-  {
-    name: 'element-name', // HTML tag name
-    attributes: {
-      'attribute-name': {
-        type: 'Any', // Type override
-      },
-    },
-  },
-];
-```
-
-Common attribute type values:
-
-| Type Value  | Meaning                                  |
-| ----------- | ---------------------------------------- |
-| `'Any'`     | Accepts any type (used for bound values) |
-| `'String'`  | Accepts only string values               |
-| `'Boolean'` | Boolean attribute (presence/absence)     |