draft-ole 0.9.0

package/dist/index.d.ts

@@ -0,0 +1,4700 @@
+import { H as HtmlAttributeShape, T as TagType, a as HTMLTagProtocol, b as HtmlTag, R as RenderContext, c as HtmlAttributeValue, S as StyleTemplate, d as SharedStyle, e as HtmlTagOptions, C as CssPositionMakerType, f as CssPlaceDescription, L as LazyLayoutRegister, g as CssLayoutBuilder, h as CssStyleManagerType, i as HtmlStyle, j as HlUnit, k as CssManagerInstance, l as CssConfig, I as IdentifierResolver, m as LayoutRegisteredItem, n as RelationShip, G as GlobalCss, o as StyleSelectors, J as JQueryManagerInstance, p as JQueryMethodType, E as ElementRef, q as ScriptScope } from './types-BXV3vhHS.js';
+export { A as AttributeManageable, B as BooleanAttributeValue, r as BorderOptions, s as BreakpointKey, t as BreakpointStyles, u as Breakpoints, v as ButtonOptions, w as CSSAnimation, x as CSSBackground, y as CSSBorder, z as CSSColor, D as CSSColorName, F as CSSFlex, K as CSSFont, M as CSSGrid, N as CSSList, O as CSSSpacing, P as CSSTable, Q as CSSText, U as CSSTransform, V as CSSVisibility, W as CSSVisual, X as ChildManageable, Y as CollectionRef, Z as Computed, _ as CssConfigOptions, $ as CssConfigOutputMode, a0 as CssManagerType, a1 as CssOutputMode, a2 as CustomAttributeValue, a3 as EachBinding, a4 as EdgeSet, a5 as Exportable, a6 as ExprFactory, a7 as FileExporter, a8 as FileExporterOptions, a9 as FlexOptions, aa as FontOptions, ab as FrameOptions, ac as GridOptions, ad as HeadingLevel, ae as HtmlStyleType, af as JQUERY_METHOD_TYPES, ag as JQueryManagerProtocol, ah as JsBoolExpr, ai as JsExpr, aj as KeyValueAttributeValue, ak as LinkOptions, al as PageOptions, am as Positioning, an as PseudoStyleBuilder, ao as ReadableState, ap as Renderable, aq as SELF_CLOSING_TAGS, ar as ScriptStateHandle, as as SelectorRef, at as State, au as StateJsAccessor, av as TAG_TYPES, aw as TagStructure, ax as UnitStyle, ay as View, az as createBooleanValue, aA as createCustomValue, aB as createKeyValueValue, aC as createVanillaScript, aD as getTagStructure, aE as hlUnitToCssString } from './types-BXV3vhHS.js';
+import { P as PairType, S as SelfClosingType, a as StackOptions, L as LayoutChild, b as SpacerOptions, Z as ZStackOptions } from './page-DylNkWXm.js';
+export { A as Alignment, c as AlignmentValue, d as AppSlot, e as AppSlotOptions, B as Button, H as HStack, f as Heading, I as Image, g as Link, h as PageDocument, i as Section, j as Spacer, V as VStack, T as ViewText, k as ZStackAlignment, l as ZStackAlignmentKey, p as page } from './page-DylNkWXm.js';
+export { AppDocument, AppOptions, AppView, app } from './entries/app.js';
+
+/**
+ * Error codes specific to the HTML module.
+ *
+ * @example
+ * ```typescript
+ * const errorCode: HtmlErrorCode = 'invalidTag';
+ * ```
+ */
+type HtmlErrorCode = 'invalidTag' | 'invalidAttribute' | 'nestingLimit';
+/**
+ * Error codes specific to the CSS module.
+ *
+ * - `invalidProperty` - The CSS property name is invalid or unsupported
+ * - `invalidValue` - The CSS property value is invalid for the given property
+ * - `layoutConflict` - Conflicting layout properties detected
+ *
+ * @example
+ * ```typescript
+ * const errorCode: CssErrorCode = 'invalidProperty';
+ * ```
+ */
+type CssErrorCode = 'invalidProperty' | 'invalidValue' | 'layoutConflict' | 'duplicateProperty';
+/**
+ * Error codes specific to the JavaScript module.
+ *
+ * - `invalidSelector` - The DOM selector is invalid or malformed
+ * - `unsupportedMethod` - The requested method is not supported
+ *
+ * @example
+ * ```typescript
+ * const errorCode: JsErrorCode = 'invalidSelector';
+ * ```
+ */
+type JsErrorCode = 'invalidSelector' | 'unsupportedMethod';
+/**
+ * Error codes specific to the Publisher module (Exportable operations).
+ *
+ * Used when ExportableError extends DraftOleError.
+ *
+ * - `invalidPath` - The file path is invalid or inaccessible
+ * - `writeFailed` - The file write operation failed
+ *
+ * @example
+ * ```typescript
+ * const errorCode: ExportableErrorCode = 'invalidPath';
+ * ```
+ */
+type ExportableErrorCode = 'invalidPath' | 'writeFailed';
+/**
+ * Union type of all error codes across all DraftOle modules.
+ *
+ * This type combines error codes from HTML, CSS, JS, and Publisher modules
+ * to provide a unified type for error handling throughout the library.
+ *
+ * @example
+ * ```typescript
+ * function handleError(code: DraftOleErrorCode, message: string) {
+ *   // Handle any DraftOle error code
+ * }
+ * ```
+ */
+type DraftOleErrorCode = HtmlErrorCode | CssErrorCode | JsErrorCode | ExportableErrorCode;
+/**
+ * Abstract base class for all DraftOle errors.
+ *
+ * This class serves as the foundation for all custom errors in the DraftOle library.
+ * Module-specific errors (HtmlError, CssError, JsError, ExportableError) extend this class
+ * to provide consistent error handling across the library.
+ *
+ * The class is abstract and cannot be instantiated directly. Subclasses must implement
+ * the `code` and `module` properties to specify the error type and origin.
+ *
+ * @example
+ * ```typescript
+ * class HtmlError extends DraftOleError {
+ *   readonly code: HtmlErrorCode;
+ *   readonly module = 'html' as const;
+ *
+ *   constructor(code: HtmlErrorCode, message: string) {
+ *     super(message);
+ *     this.code = code;
+ *     this.name = 'HtmlError';
+ *   }
+ * }
+ *
+ * // Usage
+ * try {
+ *   throw new HtmlError('invalidTag', 'Invalid HTML tag: <script>');
+ * } catch (error) {
+ *   if (error instanceof DraftOleError) {
+ *     console.log(`Error in ${error.module} module: ${error.message}`);
+ *     console.log(`Error code: ${error.code}`);
+ *   }
+ * }
+ * ```
+ */
+declare abstract class DraftOleError extends Error {
+    /**
+     * The error code specific to the module where the error occurred.
+     *
+     * This property must be implemented by subclasses to identify the specific
+     * type of error that occurred.
+     */
+    abstract readonly code: string | number;
+    /**
+     * The module where the error originated.
+     *
+     * This property identifies which DraftOle module threw the error,
+     * enabling module-specific error handling.
+     */
+    abstract readonly module: 'html' | 'css' | 'js' | 'publisher';
+    /**
+     * Creates a new DraftOleError instance.
+     *
+     * This constructor is protected and can only be called from subclasses.
+     * Direct instantiation of DraftOleError is prevented.
+     *
+     * @param message - Human-readable error message describing what went wrong
+     *
+     * @throws {Error} When attempting to instantiate DraftOleError directly
+     *
+     * @example
+     * ```typescript
+     * // In a subclass
+     * class MyCustomError extends DraftOleError {
+     *   readonly code = 'myError' as const;
+     *   readonly module = 'html' as const;
+     *
+     *   constructor(message: string) {
+     *     super(message); // Calls DraftOleError constructor
+     *     this.name = 'MyCustomError';
+     *   }
+     * }
+     * ```
+     */
+    constructor(message: string);
+}
+/**
+ * DEVモードで同一CSSプロパティが2回設定された場合にthrowされるエラー。
+ *
+ * `DRAFT_OLE_DEV=true` 環境変数が設定されている場合のみ発生する。
+ * 本番環境では後から設定した値で上書きされる（CSS仕様通り）。
+ */
+declare class DuplicateCssPropertyError extends DraftOleError {
+    readonly code: "duplicateProperty";
+    readonly module: "css";
+    constructor(property: string);
+}
+
+/**
+ * DEVモードでCSSプロパティの重複設定を検知するガード関数。
+ *
+ * `DRAFT_OLE_DEV=true` 環境変数が設定されている場合のみ動作する。
+ * currentValue が undefined でない（= 既に値が設定済み）なら
+ * DuplicateCssPropertyError をthrowする。
+ *
+ * @param currentValue - 現在のプロパティ値（undefined = 未設定）
+ * @param propertyName - CSSプロパティ名（エラーメッセージ用）
+ */
+declare function guardDuplicateCssProperty(currentValue: unknown, propertyName: string): void;
+
+/**
+ * Boolean attribute キー定義（26 要素）
+ *
+ * Swift版 AttributeKeys enum 由来の boolean 属性集合を、type union と
+ * ランタイム検証用 const 配列のペアとして提供する。
+ */
+/**
+ * Valid HTML boolean attribute keys.
+ *
+ * @remarks
+ * Boolean attributes are rendered without values (e.g., `disabled`, not `disabled="true"`).
+ * This type includes 26 standard HTML boolean attributes.
+ *
+ * @example
+ * ```typescript
+ * const key: BooleanAttributeKey = 'disabled';
+ * const attr = HtmlAttribute.boolean(key);
+ * attr.renderAttribute(); // Returns: 'disabled'
+ * ```
+ *
+ * @see {@link BOOLEAN_ATTRIBUTE_KEYS} for runtime validation array
+ */
+type BooleanAttributeKey = 'allowfullscreen' | 'async' | 'autofocus' | 'autoplay' | 'checked' | 'controls' | 'default' | 'defer' | 'disabled' | 'formnovalidate' | 'hidden' | 'inert' | 'ismap' | 'itemscope' | 'loop' | 'multiple' | 'muted' | 'nomodule' | 'novalidate' | 'open' | 'playsinline' | 'readonly' | 'required' | 'reversed' | 'selected' | 'truespeed';
+/**
+ * Array of all valid boolean attribute keys for runtime validation.
+ *
+ * @remarks
+ * Use this for runtime checks, schema validation, or listing available boolean attributes.
+ *
+ * @example
+ * ```typescript
+ * function isBooleanAttribute(key: string): key is BooleanAttributeKey {
+ *   return BOOLEAN_ATTRIBUTE_KEYS.includes(key as BooleanAttributeKey);
+ * }
+ * ```
+ */
+declare const BOOLEAN_ATTRIBUTE_KEYS: readonly BooleanAttributeKey[];
+
+/**
+ * Key-value attribute キー定義（73 要素）
+ *
+ * Swift版 AttributeKeys enum 由来の key-value 属性集合を、type union と
+ * ランタイム検証用 const 配列のペアとして提供する。
+ */
+/**
+ * Valid HTML key-value attribute keys.
+ *
+ * @remarks
+ * Key-value attributes are rendered as `key="value"` with automatic HTML escaping.
+ * This type includes 73 standard HTML key-value attributes.
+ *
+ * @example
+ * ```typescript
+ * const key: KeyValueAttributeKey = 'id';
+ * const attr = HtmlAttribute.keyValue(key, 'main-content');
+ * attr.renderAttribute(); // Returns: 'id="main-content"'
+ * ```
+ *
+ * @see {@link KEY_VALUE_ATTRIBUTE_KEYS} for runtime validation array
+ */
+type KeyValueAttributeKey = 'accept' | 'accept-charset' | 'accesskey' | 'action' | 'alt' | 'as' | 'autocomplete' | 'charset' | 'cite' | 'class' | 'cols' | 'colspan' | 'content' | 'contenteditable' | 'coords' | 'crossorigin' | 'data' | 'datetime' | 'decoding' | 'dir' | 'download' | 'draggable' | 'enctype' | 'for' | 'formaction' | 'headers' | 'height' | 'href' | 'hreflang' | 'id' | 'inputmode' | 'integrity' | 'label' | 'lang' | 'list' | 'loading' | 'max' | 'maxlength' | 'media' | 'method' | 'min' | 'minlength' | 'name' | 'pattern' | 'placeholder' | 'poster' | 'preload' | 'rel' | 'referrerpolicy' | 'role' | 'rows' | 'rowspan' | 'sandbox' | 'scope' | 'shape' | 'size' | 'sizes' | 'slot' | 'src' | 'srcdoc' | 'srclang' | 'srcset' | 'step' | 'style' | 'tabindex' | 'target' | 'title' | 'translate' | 'type' | 'usemap' | 'value' | 'width' | 'wrap';
+/**
+ * Array of all valid key-value attribute keys for runtime validation.
+ *
+ * @remarks
+ * Use this for runtime checks, schema validation, or listing available key-value attributes.
+ *
+ * @example
+ * ```typescript
+ * function isKeyValueAttribute(key: string): key is KeyValueAttributeKey {
+ *   return KEY_VALUE_ATTRIBUTE_KEYS.includes(key as KeyValueAttributeKey);
+ * }
+ * ```
+ */
+declare const KEY_VALUE_ATTRIBUTE_KEYS: readonly KeyValueAttributeKey[];
+
+/**
+ * ARIA attribute キー定義（7 要素）
+ *
+ * Accessible Rich Internet Applications 仕様に基づく ARIA 属性集合を、
+ * type union とランタイム検証用 const 配列のペアとして提供する。
+ */
+/**
+ * Valid ARIA (Accessible Rich Internet Applications) attribute keys.
+ *
+ * @remarks
+ * ARIA attributes enhance accessibility for assistive technologies.
+ * This type includes 7 commonly used ARIA attributes.
+ *
+ * @example
+ * ```typescript
+ * const key: AriaAttributeKey = 'aria-label';
+ * const attr = HtmlAttribute.keyValue(key, 'Close dialog');
+ * attr.renderAttribute(); // Returns: 'aria-label="Close dialog"'
+ * ```
+ *
+ * @see {@link ARIA_ATTRIBUTE_KEYS} for runtime validation array
+ * @see {@link https://www.w3.org/WAI/ARIA/apg/} for ARIA best practices
+ */
+type AriaAttributeKey = 'aria-label' | 'aria-hidden' | 'aria-expanded' | 'aria-controls' | 'aria-live' | 'aria-describedby' | 'aria-role';
+/**
+ * Array of all valid ARIA attribute keys for runtime validation.
+ *
+ * @remarks
+ * Use this for runtime checks, schema validation, or listing available ARIA attributes.
+ *
+ * @example
+ * ```typescript
+ * function isAriaAttribute(key: string): key is AriaAttributeKey {
+ *   return ARIA_ATTRIBUTE_KEYS.includes(key as AriaAttributeKey);
+ * }
+ * ```
+ */
+declare const ARIA_ATTRIBUTE_KEYS: readonly AriaAttributeKey[];
+
+/**
+ * Form 系 type 属性値定義（input type 22 種 + button type 3 種）
+ *
+ * いずれも form 系列の小型データであり、相互依存のないペアとして同居させる。
+ * type union とランタイム検証用 const 配列をそれぞれ提供する。
+ */
+/**
+ * Valid HTML input element type attribute values.
+ *
+ * @remarks
+ * This type includes all 22 standard HTML5 input types.
+ * Use with {@link HtmlAttribute.inputType} for type-safe input type attributes.
+ *
+ * @example
+ * ```typescript
+ * const emailType: InputType = 'email';
+ * const attr = HtmlAttribute.inputType(emailType);
+ * attr.renderAttribute(); // Returns: 'type="email"'
+ *
+ * // In an input builder
+ * new InputAttributeBuilder()
+ *   .setInputType('password')
+ *   .setPlaceholder('Enter password')
+ *   .build();
+ * ```
+ *
+ * @see {@link INPUT_TYPES} for runtime validation array
+ * @see {@link HtmlAttribute.inputType} for creating input type attributes
+ */
+type InputType = 'text' | 'password' | 'email' | 'number' | 'tel' | 'url' | 'search' | 'date' | 'time' | 'datetime-local' | 'month' | 'week' | 'color' | 'range' | 'file' | 'checkbox' | 'radio' | 'hidden' | 'submit' | 'reset' | 'button' | 'image';
+/**
+ * Array of all valid HTML input types for runtime validation.
+ *
+ * @remarks
+ * Use this for runtime checks, schema validation, or listing available input types.
+ *
+ * @example
+ * ```typescript
+ * function isValidInputType(type: string): type is InputType {
+ *   return INPUT_TYPES.includes(type as InputType);
+ * }
+ *
+ * // Generate form field based on type
+ * INPUT_TYPES.forEach(type => {
+ *   console.log(`<input type="${type}">`);
+ * });
+ * ```
+ */
+declare const INPUT_TYPES: readonly InputType[];
+/**
+ * Valid HTML button element type attribute values.
+ *
+ * @remarks
+ * This type includes the 3 standard HTML button types:
+ * - `submit` - Submits the form (default behavior)
+ * - `reset` - Resets form fields to their initial values
+ * - `button` - No default behavior (for custom JavaScript)
+ *
+ * @example
+ * ```typescript
+ * const submitType: ButtonType = 'submit';
+ * const attr = HtmlAttribute.buttonType(submitType);
+ * attr.renderAttribute(); // Returns: 'type="submit"'
+ *
+ * // In a button builder
+ * new ButtonAttributeBuilder()
+ *   .setButtonType('button')
+ *   .setId('close-dialog')
+ *   .build();
+ * ```
+ *
+ * @see {@link BUTTON_TYPES} for runtime validation array
+ * @see {@link HtmlAttribute.buttonType} for creating button type attributes
+ */
+type ButtonType = 'submit' | 'reset' | 'button';
+/**
+ * Array of all valid HTML button types for runtime validation.
+ *
+ * @remarks
+ * Use this for runtime checks, schema validation, or listing available button types.
+ *
+ * @example
+ * ```typescript
+ * function isValidButtonType(type: string): type is ButtonType {
+ *   return BUTTON_TYPES.includes(type as ButtonType);
+ * }
+ *
+ * // Generate buttons for all types
+ * BUTTON_TYPES.forEach(type => {
+ *   console.log(`<button type="${type}">Click me</button>`);
+ * });
+ * ```
+ */
+declare const BUTTON_TYPES: readonly ButtonType[];
+
+/**
+ * HtmlAttributeManagerProtocol: 属性の追加・取得・レンダリングを定義
+ *
+ * Requirements: 1.2
+ */
+
+/**
+ * HTML属性の管理機能を提供するインターフェース
+ *
+ * このインターフェースは、HTML要素の属性を追加し、レンダリングする責務を定義します。
+ * 属性の追加、参照、HTML文字列への変換をサポートします。
+ *
+ * @remarks
+ * 属性は追加順に保持されます。
+ * 同じキーの属性が複数追加された場合、レンダリング時には最後に追加されたものが優先されます（HTML仕様に従う）。
+ *
+ * @example
+ * ```typescript
+ * class MyAttributeManager implements HtmlAttributeManagerProtocol {
+ *   private _attributes: HtmlAttributeShape[] = [];
+ *
+ *   get attributes(): ReadonlyArray<HtmlAttributeShape> {
+ *     return this._attributes;
+ *   }
+ *
+ *   addHtmlAttribute(attribute: HtmlAttributeShape): void {
+ *     this._attributes.push(attribute);
+ *   }
+ *
+ *   renderAttributes(): string {
+ *     return this._attributes
+ *       .map(attr => attr.renderAttribute())
+ *       .join(' ');
+ *   }
+ * }
+ * ```
+ */
+interface HtmlAttributeManagerProtocol {
+    /**
+     * 管理されている属性の読み取り専用配列
+     *
+     * @remarks
+     * 属性は追加順に保持されます。
+     * 直接配列を変更することはできません。addHtmlAttribute メソッドを使用してください。
+     */
+    readonly attributes: ReadonlyArray<HtmlAttributeShape>;
+    /**
+     * HTML属性を1つ追加
+     *
+     * @param attribute - 追加する属性オブジェクト
+     *
+     * @remarks
+     * 属性は配列の末尾に追加されます。
+     * 同じキーの属性が既に存在する場合でも追加され、レンダリング時には最後に追加された値が使用されます。
+     *
+     * @example
+     * ```typescript
+     * manager.addHtmlAttribute(new HtmlAttribute('id', 'test-id'));
+     * manager.addHtmlAttribute(new HtmlAttribute('class', 'btn'));
+     * ```
+     */
+    addHtmlAttribute(attribute: HtmlAttributeShape): void;
+    /**
+     * すべての属性をHTML文字列としてレンダリング
+     *
+     * @returns 属性の文字列表現（例: `id="test" class="btn"`）
+     *
+     * @remarks
+     * 各属性は `renderAttribute()` メソッドで文字列化され、スペース区切りで連結されます。
+     * 属性がない場合は空文字列を返します。
+     *
+     * @example
+     * ```typescript
+     * manager.addHtmlAttribute(new HtmlAttribute('id', 'test-id'));
+     * manager.addHtmlAttribute(new HtmlAttribute('class', 'btn'));
+     * console.log(manager.renderAttributes()); // 'id="test-id" class="btn"'
+     * ```
+     */
+    renderAttributes(): string;
+}
+
+/**
+ * TagGenerateProtocol: タグ生成を定義するインターフェース
+ *
+ * Requirements: 1.3
+ */
+
+/**
+ * HTMLタグを動的に生成するファクトリインターフェース
+ *
+ * このインターフェースは、タグ種別（TagType）を指定してHTMLタグインスタンスを生成する
+ * ファクトリパターンの契約を定義します。
+ *
+ * @remarks
+ * - タグ種別に応じて、PairType（開始/終了タグのペア）またはSelfClosingType（自己閉鎖タグ）が生成されます
+ * - 生成されたタグは HTMLTagProtocol を実装しており、メソッドチェーンによる構築が可能です
+ *
+ * Preconditions: tagType は有効な TagType 値である必要があります
+ * Postconditions: 生成されたタグは HTMLTagProtocol を満たします
+ *
+ * @example
+ * ```typescript
+ * class TagFactory implements TagGenerateProtocol {
+ *   generateTag(tagType: TagType): HTMLTagProtocol {
+ *     if (tagType === 'img' || tagType === 'br') {
+ *       return new SelfClosingType(tagType);
+ *     }
+ *     return new PairType(tagType);
+ *   }
+ * }
+ *
+ * const factory = new TagFactory();
+ * const div = factory.generateTag('div');
+ * const img = factory.generateTag('img');
+ * ```
+ */
+interface TagGenerateProtocol {
+    /**
+     * 指定されたタグ種別のHTMLタグインスタンスを生成
+     *
+     * @param tagType - 生成するタグの種別（例: 'div', 'p', 'img'など）
+     * @returns 生成されたHTMLTagProtocolを実装するインスタンス
+     *
+     * @remarks
+     * タグ種別に応じて適切な実装クラス（PairType または SelfClosingType）のインスタンスを返します。
+     * 生成されたタグは空の状態（子要素なし、属性なし）で返されます。
+     *
+     * @example
+     * ```typescript
+     * const div = generator.generateTag('div');
+     * div.addChild(new TextType('Hello'));
+     * console.log(div.render()); // <div>Hello</div>
+     * ```
+     */
+    generateTag(tagType: TagType): HTMLTagProtocol;
+}
+
+/**
+ * AttributeBuilderProtocol: 属性ビルダーの共通インターフェース
+ *
+ * 要素種別に応じた属性設定を型安全に行うビルダーの契約を定義する。
+ * 各メソッドは this を返し、フルエントAPIチェーンを可能にする。
+ *
+ * Preconditions: なし（空のビルダーも有効）
+ * Postconditions: build() は設定済みの属性配列を返す
+ *
+ * Requirements: 1.6
+ */
+
+/**
+ * HTML属性をビルダーパターンで構築するインターフェース
+ *
+ * このインターフェースは、HTML要素の属性を型安全かつ流暢なAPIで設定するビルダーの契約を定義します。
+ * フルエントAPI（メソッドチェーン）をサポートし、複雑な属性設定を読みやすく記述できます。
+ *
+ * @remarks
+ * サポートする属性の種類:
+ * - 共通属性: id, title, lang, role, tabindex, hidden
+ * - ARIA属性: aria-label, aria-hidden, aria-expanded
+ * - カスタム属性: data-*など任意の属性
+ * - class属性: 複数クラスの追加、条件付き追加をサポート
+ *
+ * すべてのメソッドは `this` を返すため、メソッドチェーンが可能です。
+ * 最終的に `build()` を呼び出して、設定された属性の配列を取得します。
+ *
+ * Preconditions: なし（空のビルダーも有効）
+ * Postconditions: build() は設定済みの属性配列を返す
+ * Invariants: メソッド呼び出し順序は属性の順序に影響しない
+ *
+ * @example
+ * ```typescript
+ * const builder = new AttributeBuilder();
+ * const attributes = builder
+ *   .setId('my-button')
+ *   .addClass('btn', 'btn-primary')
+ *   .setRole('button')
+ *   .setAriaLabel('Submit form')
+ *   .setCustomAttribute('data-action', 'submit')
+ *   .build();
+ * ```
+ */
+interface AttributeBuilderProtocol {
+    /**
+     * id属性を設定
+     *
+     * @param id - 要素の一意識別子
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setId('my-element');
+     * ```
+     */
+    setId(id: string): this;
+    /**
+     * title属性を設定（ツールチップテキスト）
+     *
+     * @param title - 要素のツールチップに表示されるテキスト
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setTitle('Click to submit');
+     * ```
+     */
+    setTitle(title: string): this;
+    /**
+     * lang属性を設定（要素の言語コード）
+     *
+     * @param lang - ISO 639-1言語コード（例: 'en', 'ja', 'fr'）
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setLang('ja');
+     * ```
+     */
+    setLang(lang: string): this;
+    /**
+     * role属性を設定（ARIA役割）
+     *
+     * @param role - ARIA役割（例: 'button', 'navigation', 'main'）
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setRole('navigation');
+     * ```
+     */
+    setRole(role: string): this;
+    /**
+     * tabindex属性を設定（タブ順序）
+     *
+     * @param index - タブインデックス（-1: フォーカス不可、0: 自然順、1+: 明示的順序）
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setTabindex(0); // 自然なタブ順序
+     * builder.setTabindex(-1); // タブでフォーカスできないようにする
+     * ```
+     */
+    setTabindex(index: number): this;
+    /**
+     * hidden属性を設定（要素の表示/非表示）
+     *
+     * @param hidden - true の場合、要素を非表示にする
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setHidden(true); // 要素を非表示
+     * ```
+     */
+    setHidden(hidden: boolean): this;
+    /**
+     * カスタム属性を設定（data-*など任意の属性）
+     *
+     * @param name - 属性名（例: 'data-user-id', 'data-action'）
+     * @param value - 属性値
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setCustomAttribute('data-user-id', '12345');
+     * builder.setCustomAttribute('data-action', 'submit');
+     * ```
+     */
+    setCustomAttribute(name: string, value: string): this;
+    /**
+     * aria-label属性を設定（スクリーンリーダー用ラベル）
+     *
+     * @param label - アクセシビリティラベル
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setAriaLabel('Close dialog');
+     * ```
+     */
+    setAriaLabel(label: string): this;
+    /**
+     * aria-hidden属性を設定（スクリーンリーダーから隠す）
+     *
+     * @param hidden - true の場合、スクリーンリーダーから隠す
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setAriaHidden(true); // スクリーンリーダーから隠す
+     * ```
+     */
+    setAriaHidden(hidden: boolean): this;
+    /**
+     * aria-expanded属性を設定（展開状態を示す）
+     *
+     * @param expanded - true の場合、要素が展開されていることを示す
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.setAriaExpanded(true); // メニューが展開されている
+     * ```
+     */
+    setAriaExpanded(expanded: boolean): this;
+    /**
+     * クラス名を1つまたは複数追加
+     *
+     * @param classNames - 追加するクラス名（可変長引数）
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * builder.addClass('btn');
+     * builder.addClass('btn', 'btn-primary', 'btn-lg');
+     * ```
+     */
+    addClass(...classNames: string[]): this;
+    /**
+     * クラス名の配列を追加
+     *
+     * @param classNames - 追加するクラス名の配列
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @example
+     * ```typescript
+     * const classes = ['btn', 'btn-primary', 'btn-lg'];
+     * builder.addClasses(classes);
+     * ```
+     */
+    addClasses(classNames: string[]): this;
+    /**
+     * 条件付きでクラス名を追加
+     *
+     * @param className - 追加するクラス名
+     * @param condition - true の場合のみクラスを追加
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @remarks
+     * 条件に応じてクラスを動的に追加する場合に便利です。
+     *
+     * @example
+     * ```typescript
+     * const isActive = true;
+     * const isDisabled = false;
+     * builder
+     *   .addClassWhen('active', isActive)   // 'active' が追加される
+     *   .addClassWhen('disabled', isDisabled); // 追加されない
+     * ```
+     */
+    addClassWhen(className: string, condition: boolean): this;
+    /**
+     * クラス名と条件のマップから、条件が true のクラスを追加
+     *
+     * @param classMap - クラス名をキー、条件を値とするオブジェクト
+     * @returns メソッドチェーンのため、this を返す
+     *
+     * @remarks
+     * 複数の条件付きクラスを一度に設定する場合に便利です。
+     *
+     * @example
+     * ```typescript
+     * builder.addClassesToggle({
+     *   'active': isActive,      // isActive が true なら 'active' を追加
+     *   'disabled': isDisabled,  // isDisabled が true なら 'disabled' を追加
+     *   'selected': isSelected   // isSelected が true なら 'selected' を追加
+     * });
+     * ```
+     */
+    addClassesToggle(classMap: Record<string, boolean>): this;
+    /**
+     * 設定された属性を HtmlAttributeShape の配列として構築
+     *
+     * @returns 設定された属性の配列
+     *
+     * @remarks
+     * このメソッドを呼び出すことで、ビルダーに設定されたすべての属性を
+     * HtmlAttributeShape の配列として取得できます。
+     * 通常、これはHTML要素の構築の最終ステップで呼び出されます。
+     *
+     * @example
+     * ```typescript
+     * const attributes = builder
+     *   .setId('my-button')
+     *   .addClass('btn', 'btn-primary')
+     *   .setRole('button')
+     *   .build();
+     *
+     * // attributes は HtmlAttributeShape[] 型
+     * attributes.forEach(attr => {
+     *   console.log(attr.renderAttribute());
+     * });
+     * ```
+     */
+    build(): HtmlAttributeShape[];
+}
+
+/**
+ * Task 4.4: TextType テキストノード
+ *
+ * テキスト内容を返すテキストノードクラス。
+ * テキストノードは属性を持たず、子要素も持たない。
+ *
+ * レンダリング:
+ *   protoRender() → content を返す（デフォルトはエスケープ済み）
+ *   render()      → protoRender() → HTMLFormatter.format()
+ *                   （テキストのみの場合はそのまま返される）
+ *
+ * Requirements: 3.4, 6.3
+ */
+
+/**
+ * Represents a text node in the HTML document tree.
+ *
+ * Text nodes contain plain text content without any HTML tags. They cannot
+ * have attributes or child elements.
+ *
+ * **Rendering Format:**
+ * ```
+ * content
+ * ```
+ * (No HTML tags, just the raw text content)
+ *
+ * **Important:** Text content is HTML-escaped by default to prevent XSS.
+ * Use `TextType.raw(content)` for intentional unescaped HTML output.
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * // Using the Text factory function (escaped by default)
+ * const text = Text('Hello <World>'); // renders: Hello &lt;World&gt;
+ *
+ * // Text nodes are also auto-created from strings in tag factories
+ * const paragraph = p('This is automatically wrapped in TextType');
+ * ```
+ *
+ * @example
+ * Intentional raw HTML (trusted content only):
+ * ```typescript
+ * const raw = TextType.raw('<strong>trusted</strong>');
+ * // WARNING: Never pass user input to TextType.raw()
+ * ```
+ *
+ * @remarks
+ * **Preconditions:** content can be any string (including empty string)
+ *
+ * **Postconditions:** `protoRender()` returns HTML-escaped content by default
+ *
+ * **Invariants:** attributes and children are always empty
+ */
+declare class TextType extends HtmlTag {
+    /**
+     * The text content of this node (after escape processing).
+     */
+    readonly content: string;
+    /**
+     * Creates a new TextType node. Content is HTML-escaped by default.
+     *
+     * @param content - The text content
+     * @param options - Options. `escape: false` disables HTML escaping (default: true)
+     *
+     * @example
+     * ```typescript
+     * const text = new TextType('Hello <World>');
+     * console.log(text.render()); // "Hello &lt;World&gt;"
+     *
+     * const raw = new TextType('<strong>trusted</strong>', { escape: false });
+     * console.log(raw.render()); // "<strong>trusted</strong>"
+     * ```
+     */
+    constructor(content: string, options?: {
+        escape?: boolean;
+    });
+    /**
+     * Creates an unescaped TextType node for intentional raw HTML output.
+     *
+     * **WARNING:** Never pass user input to this method — XSS risk.
+     *
+     * @param content - Raw HTML/text content (NOT escaped)
+     * @returns A new TextType instance without HTML escaping
+     *
+     * @example
+     * ```typescript
+     * const raw = TextType.raw('<em>trusted</em>');
+     * console.log(raw.render()); // "<em>trusted</em>"
+     * ```
+     */
+    static raw(content: string): TextType;
+    /**
+     * Renders the text content (HTML-escaped by default).
+     *
+     * Text nodes don't have tags, so this simply returns the content.
+     *
+     * @returns The text content (escaped unless constructed with `escape: false`)
+     *
+     * @example
+     * ```typescript
+     * const text = new TextType('Hello <world>');
+     * console.log(text.protoRender()); // "Hello &lt;world&gt;"
+     * ```
+     */
+    protoRender(_ctx?: RenderContext): string;
+    /**
+     * Silently ignores attribute addition (no-op).
+     *
+     * Text nodes cannot have attributes, so this method does nothing.
+     *
+     * @param _attribute - The attribute (ignored)
+     * @returns This instance for method chaining
+     */
+    addHtmlAttribute(_attribute: HtmlAttributeShape): this;
+    /**
+     * Silently ignores child element addition (no-op).
+     *
+     * Text nodes cannot have children, so this method does nothing.
+     *
+     * @param _child - The child element (ignored)
+     * @returns This instance for method chaining
+     */
+    addChild(_child: HTMLTagProtocol): this;
+    /**
+     * Silently ignores multiple child elements addition (no-op).
+     *
+     * Text nodes cannot have children, so this method does nothing.
+     *
+     * @param _children - The child elements (ignored)
+     * @returns This instance for method chaining
+     */
+    addChildren(_children: ReadonlyArray<HTMLTagProtocol>): this;
+}
+
+/**
+ * Task 2.1 + 2.2: HtmlAttribute クラス
+ *
+ * Boolean・KeyValue・カスタムdata-*・ARIA属性の生成とHTML文字列レンダリング
+ * class名の重複除去・正規化、属性値のHTMLエスケープ
+ *
+ * Requirements: 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 10.3, 10.4
+ */
+
+declare function escapeHtml(value: string): string;
+/**
+ * Normalizes and deduplicates CSS class names.
+ *
+ * Processes an array of class name strings by:
+ * 1. Trimming each entry
+ * 2. Splitting on whitespace
+ * 3. Removing empty strings
+ * 4. Removing duplicates while preserving first occurrence order
+ *
+ * @param names - Array of class name strings (may contain whitespace-separated classes)
+ * @returns A single space-separated string of unique class names
+ *
+ * @remarks
+ * This function is automatically called by {@link HtmlAttribute.className} to ensure
+ * class attributes are clean and efficient.
+ *
+ * @example
+ * ```typescript
+ * normalizeClassNames(['btn', 'btn-primary']);
+ * // Returns: 'btn btn-primary'
+ *
+ * normalizeClassNames(['btn btn-primary', 'btn-large', 'btn']);
+ * // Returns: 'btn btn-primary btn-large' (duplicate 'btn' removed)
+ *
+ * normalizeClassNames(['  container  ', '', 'flex  gap-4']);
+ * // Returns: 'container flex gap-4' (trimmed and empty strings removed)
+ * ```
+ *
+ * @see {@link HtmlAttribute.className} for usage with class attributes
+ */
+declare function normalizeClassNames(names: string[]): string;
+/**
+ * Type-safe representation of an HTML attribute with automatic escaping.
+ *
+ * Provides factory methods for creating boolean, key-value, custom data-*, and ARIA attributes.
+ * All attribute values are automatically HTML-escaped when rendered to prevent XSS attacks.
+ *
+ * @remarks
+ * This class implements {@link HtmlAttributeShape} and uses a discriminated union type
+ * ({@link HtmlAttributeValue}) to represent different attribute types safely.
+ *
+ * @example
+ * ```typescript
+ * // Boolean attribute
+ * const disabled = HtmlAttribute.boolean('disabled');
+ * disabled.renderAttribute(); // Returns: 'disabled'
+ *
+ * // Key-value attribute
+ * const id = HtmlAttribute.keyValue('id', 'main-content');
+ * id.renderAttribute(); // Returns: 'id="main-content"'
+ *
+ * // Class attribute (with normalization)
+ * const classes = HtmlAttribute.className('btn', 'btn-primary btn', 'btn-large');
+ * classes.renderAttribute(); // Returns: 'class="btn btn-primary btn-large"'
+ *
+ * // Custom data attribute
+ * const theme = HtmlAttribute.custom('theme', 'dark');
+ * theme.renderAttribute(); // Returns: 'data-theme="dark"'
+ * ```
+ *
+ * @see {@link HtmlAttributeValue} for the discriminated union type
+ * @see {@link escapeHtml} for XSS prevention details
+ */
+declare class HtmlAttribute implements HtmlAttributeShape {
+    /** The attribute key (e.g., 'id', 'class', 'disabled') */
+    readonly key: string;
+    /** The attribute value (discriminated union of boolean, key-value, or custom) */
+    readonly attributeValue: HtmlAttributeValue;
+    private constructor();
+    /**
+     * Creates a boolean attribute (e.g., disabled, checked, hidden).
+     *
+     * @param key - A valid boolean attribute key
+     * @returns A new HtmlAttribute instance representing a boolean attribute
+     *
+     * @example
+     * ```typescript
+     * const disabled = HtmlAttribute.boolean('disabled');
+     * disabled.renderAttribute(); // Returns: 'disabled'
+     *
+     * const checked = HtmlAttribute.boolean('checked');
+     * checked.renderAttribute(); // Returns: 'checked'
+     * ```
+     *
+     * @see {@link BooleanAttributeKey} for all valid boolean attribute keys
+     */
+    static boolean(key: BooleanAttributeKey): HtmlAttribute;
+    /**
+     * Creates a key-value attribute (e.g., id="main", title="tooltip").
+     *
+     * @param key - A valid key-value or ARIA attribute key
+     * @param value - The attribute value (will be HTML-escaped when rendered)
+     * @returns A new HtmlAttribute instance representing a key-value attribute
+     *
+     * @example
+     * ```typescript
+     * const id = HtmlAttribute.keyValue('id', 'main-content');
+     * id.renderAttribute(); // Returns: 'id="main-content"'
+     *
+     * const href = HtmlAttribute.keyValue('href', '/path?q=<script>');
+     * href.renderAttribute(); // Returns: 'href="/path?q=&lt;script&gt;"'
+     * ```
+     *
+     * @see {@link KeyValueAttributeKey} for all valid key-value attribute keys
+     * @see {@link AriaAttributeKey} for all valid ARIA attribute keys
+     */
+    static keyValue(key: KeyValueAttributeKey | AriaAttributeKey, value: string): HtmlAttribute;
+    /**
+     * Creates a class attribute with automatic normalization and deduplication.
+     *
+     * @param names - One or more class name strings (may contain whitespace-separated classes)
+     * @returns A new HtmlAttribute instance representing a normalized class attribute
+     *
+     * @remarks
+     * Class names are automatically:
+     * - Trimmed
+     * - Split on whitespace
+     * - Deduplicated (first occurrence preserved)
+     * - Joined with single spaces
+     *
+     * @example
+     * ```typescript
+     * const classes = HtmlAttribute.className('btn', 'btn-primary');
+     * classes.renderAttribute(); // Returns: 'class="btn btn-primary"'
+     *
+     * const normalized = HtmlAttribute.className('btn btn-primary', 'btn-large', 'btn');
+     * normalized.renderAttribute(); // Returns: 'class="btn btn-primary btn-large"'
+     * ```
+     *
+     * @see {@link normalizeClassNames} for normalization details
+     */
+    static className(...names: string[]): HtmlAttribute;
+    /**
+     * Creates a custom data-* attribute.
+     *
+     * @param name - The data attribute name (without 'data-' prefix)
+     * @param value - The attribute value (will be HTML-escaped when rendered)
+     * @returns A new HtmlAttribute instance representing a custom data attribute
+     *
+     * @example
+     * ```typescript
+     * const theme = HtmlAttribute.custom('theme', 'dark');
+     * theme.renderAttribute(); // Returns: 'data-theme="dark"'
+     *
+     * const userId = HtmlAttribute.custom('user-id', '12345');
+     * userId.renderAttribute(); // Returns: 'data-user-id="12345"'
+     * ```
+     */
+    static custom(name: string, value: string): HtmlAttribute;
+    /**
+     * Creates an aria-label attribute.
+     *
+     * @param label - The accessible label text
+     * @returns A new HtmlAttribute instance for aria-label
+     *
+     * @example
+     * ```typescript
+     * const label = HtmlAttribute.ariaLabel('Close dialog');
+     * label.renderAttribute(); // Returns: 'aria-label="Close dialog"'
+     * ```
+     */
+    static ariaLabel(label: string): HtmlAttribute;
+    /**
+     * Creates an aria-hidden attribute.
+     *
+     * @param hidden - Whether the element should be hidden from assistive technologies
+     * @returns A new HtmlAttribute instance for aria-hidden
+     *
+     * @example
+     * ```typescript
+     * const hidden = HtmlAttribute.ariaHidden(true);
+     * hidden.renderAttribute(); // Returns: 'aria-hidden="true"'
+     * ```
+     */
+    static ariaHidden(hidden: boolean): HtmlAttribute;
+    /**
+     * Creates an aria-expanded attribute.
+     *
+     * @param expanded - Whether the element is currently expanded
+     * @returns A new HtmlAttribute instance for aria-expanded
+     *
+     * @example
+     * ```typescript
+     * const expanded = HtmlAttribute.ariaExpanded(false);
+     * expanded.renderAttribute(); // Returns: 'aria-expanded="false"'
+     * ```
+     */
+    static ariaExpanded(expanded: boolean): HtmlAttribute;
+    /**
+     * Creates a type attribute for input elements.
+     *
+     * @param type - A valid HTML input type
+     * @returns A new HtmlAttribute instance for input type
+     *
+     * @example
+     * ```typescript
+     * const emailInput = HtmlAttribute.inputType('email');
+     * emailInput.renderAttribute(); // Returns: 'type="email"'
+     *
+     * const checkbox = HtmlAttribute.inputType('checkbox');
+     * checkbox.renderAttribute(); // Returns: 'type="checkbox"'
+     * ```
+     *
+     * @see {@link InputType} for all valid input types
+     */
+    static inputType(type: InputType): HtmlAttribute;
+    /**
+     * Creates a type attribute for button elements.
+     *
+     * @param type - A valid HTML button type ('submit', 'reset', or 'button')
+     * @returns A new HtmlAttribute instance for button type
+     *
+     * @example
+     * ```typescript
+     * const submit = HtmlAttribute.buttonType('submit');
+     * submit.renderAttribute(); // Returns: 'type="submit"'
+     *
+     * const reset = HtmlAttribute.buttonType('reset');
+     * reset.renderAttribute(); // Returns: 'type="reset"'
+     * ```
+     *
+     * @see {@link ButtonType} for all valid button types
+     */
+    static buttonType(type: ButtonType): HtmlAttribute;
+    /**
+     * Renders the attribute as an HTML string.
+     *
+     * @returns The rendered attribute string
+     *
+     * @remarks
+     * - Boolean attributes render as just the key (e.g., 'disabled')
+     * - Key-value attributes render as key="value" with escaped values
+     * - Custom attributes render as data-name="value" with escaped values
+     *
+     * All attribute values are automatically HTML-escaped to prevent XSS attacks.
+     *
+     * @example
+     * ```typescript
+     * HtmlAttribute.boolean('disabled').renderAttribute();
+     * // Returns: 'disabled'
+     *
+     * HtmlAttribute.keyValue('id', 'main').renderAttribute();
+     * // Returns: 'id="main"'
+     *
+     * HtmlAttribute.custom('theme', 'dark').renderAttribute();
+     * // Returns: 'data-theme="dark"'
+     * ```
+     *
+     * @see {@link escapeHtml} for HTML escaping details
+     */
+    renderAttribute(): string;
+}
+
+/**
+ * Task 6.1: BaseAttributeBuilder
+ *
+ * BaseAttributeBuilder: 共通属性（id, title, lang, role, tabindex, hidden, custom, ARIA）の設定と
+ * class追加の4パターン（可変長引数、配列、条件付き、辞書Toggle形式）を提供する。
+ *
+ * Requirements: 7.1, 7.2
+ */
+
+/**
+ * Base attribute builder providing common HTML attributes and fluent API.
+ *
+ * @remarks
+ * This class implements {@link AttributeBuilderProtocol} and provides:
+ * - Common attributes (id, title, lang, role, tabindex, hidden)
+ * - ARIA attributes (aria-label, aria-hidden, aria-expanded)
+ * - Custom data-* attributes
+ * - Four class management patterns (variadic, array, conditional, toggle)
+ * - Automatic class name normalization and deduplication
+ *
+ * Class names are accumulated internally and merged into a single normalized
+ * class attribute when {@link build} is called.
+ *
+ * @example
+ * Basic usage
+ * ```typescript
+ * const attrs = new BaseAttributeBuilder()
+ *   .setId('main-content')
+ *   .addClass('container', 'mx-auto')
+ *   .setAriaLabel('Main content area')
+ *   .build();
+ * ```
+ *
+ * @example
+ * Conditional classes
+ * ```typescript
+ * const isActive = true;
+ * const attrs = new BaseAttributeBuilder()
+ *   .addClass('btn')
+ *   .addClassWhen('btn-active', isActive)
+ *   .addClassesToggle({
+ *     'btn-primary': isPrimary,
+ *     'btn-disabled': isDisabled
+ *   })
+ *   .build();
+ * ```
+ *
+ * @example
+ * Custom data attributes
+ * ```typescript
+ * const attrs = new BaseAttributeBuilder()
+ *   .setCustomAttribute('theme', 'dark')
+ *   .setCustomAttribute('user-id', '12345')
+ *   .build();
+ * // Produces: data-theme="dark" data-user-id="12345"
+ * ```
+ */
+declare class BaseAttributeBuilder implements AttributeBuilderProtocol {
+    /** Accumulated attributes (excluding class, which is handled separately) */
+    protected _attributes: HtmlAttribute[];
+    /** Accumulated class names (deduplicated and normalized on build) */
+    protected _classNames: string[];
+    /**
+     * Adds a key-value HTML attribute.
+     *
+     * @param key - The attribute name
+     * @param value - The attribute value
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * This helper centralizes the keyValue attribute creation pattern.
+     * Subclasses may also use this helper for their own key-value attributes.
+     */
+    protected addKeyValue(key: KeyValueAttributeKey | AriaAttributeKey, value: string | number): this;
+    /**
+     * Sets the id attribute.
+     *
+     * @param id - The element ID
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setId('main-content');
+     * // Produces: id="main-content"
+     * ```
+     */
+    setId(id: string): this;
+    /**
+     * Sets the title attribute (tooltip text).
+     *
+     * @param title - The tooltip text
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setTitle('Click to expand');
+     * // Produces: title="Click to expand"
+     * ```
+     */
+    setTitle(title: string): this;
+    /**
+     * Sets the lang attribute (language code).
+     *
+     * @param lang - The language code (e.g., 'en', 'ja', 'fr')
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setLang('ja');
+     * // Produces: lang="ja"
+     * ```
+     */
+    setLang(lang: string): this;
+    /**
+     * Sets the role attribute (ARIA role).
+     *
+     * @param role - The ARIA role (e.g., 'button', 'navigation')
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setRole('navigation');
+     * // Produces: role="navigation"
+     * ```
+     */
+    setRole(role: string): this;
+    /**
+     * Sets the tabindex attribute.
+     *
+     * @param index - The tab order index (-1 for programmatically focusable, 0 for natural order)
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setTabindex(0);  // Natural tab order
+     * builder.setTabindex(-1); // Programmatically focusable only
+     * ```
+     */
+    setTabindex(index: number): this;
+    /**
+     * Sets the hidden boolean attribute.
+     *
+     * @param hidden - If true, adds the hidden attribute
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setHidden(true);  // Produces: hidden
+     * builder.setHidden(false); // No attribute added
+     * ```
+     */
+    setHidden(hidden: boolean): this;
+    /**
+     * Sets a custom data-* attribute.
+     *
+     * @param name - The data attribute name (without 'data-' prefix)
+     * @param value - The attribute value
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setCustomAttribute('theme', 'dark');
+     * // Produces: data-theme="dark"
+     *
+     * builder.setCustomAttribute('user-id', '12345');
+     * // Produces: data-user-id="12345"
+     * ```
+     */
+    setCustomAttribute(name: string, value: string): this;
+    /**
+     * Sets the aria-label attribute.
+     *
+     * @param label - The accessible label text
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setAriaLabel('Close dialog');
+     * // Produces: aria-label="Close dialog"
+     * ```
+     */
+    setAriaLabel(label: string): this;
+    /**
+     * Sets the aria-hidden attribute.
+     *
+     * @param hidden - Whether the element should be hidden from assistive technologies
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setAriaHidden(true);
+     * // Produces: aria-hidden="true"
+     * ```
+     */
+    setAriaHidden(hidden: boolean): this;
+    /**
+     * Sets the aria-expanded attribute.
+     *
+     * @param expanded - Whether the element is currently expanded
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setAriaExpanded(false);
+     * // Produces: aria-expanded="false"
+     * ```
+     */
+    setAriaExpanded(expanded: boolean): this;
+    /**
+     * Adds one or more class names (variadic pattern).
+     *
+     * @param classNames - One or more class name strings
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.addClass('btn', 'btn-primary', 'btn-large');
+     * // Accumulates: ['btn', 'btn-primary', 'btn-large']
+     * ```
+     */
+    addClass(...classNames: string[]): this;
+    /**
+     * Adds class names from an array (array pattern).
+     *
+     * @param classNames - Array of class name strings
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * const classes = ['container', 'mx-auto', 'px-4'];
+     * builder.addClasses(classes);
+     * ```
+     */
+    addClasses(classNames: string[]): this;
+    /**
+     * Conditionally adds a class name (conditional pattern).
+     *
+     * @param className - The class name to add
+     * @param condition - Only adds the class if this is true
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * const isActive = true;
+     * builder.addClassWhen('active', isActive);  // Adds 'active'
+     * builder.addClassWhen('disabled', false);   // Doesn't add
+     * ```
+     */
+    addClassWhen(className: string, condition: boolean): this;
+    /**
+     * Adds classes from a toggle map (toggle pattern).
+     *
+     * @param classMap - Object mapping class names to boolean flags
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * Only class names with `true` values are added.
+     *
+     * @example
+     * ```typescript
+     * builder.addClassesToggle({
+     *   'btn-primary': isPrimary,
+     *   'btn-disabled': isDisabled,
+     *   'btn-large': isLarge
+     * });
+     * // Adds only classes where the value is true
+     * ```
+     */
+    addClassesToggle(classMap: Record<string, boolean>): this;
+    /**
+     * Builds and returns the accumulated attribute array.
+     *
+     * @returns Array of HtmlAttribute instances
+     *
+     * @remarks
+     * If any class names were added, they are normalized (trimmed, deduplicated)
+     * and merged into a single class attribute using {@link normalizeClassNames}.
+     *
+     * @example
+     * ```typescript
+     * const attrs = new BaseAttributeBuilder()
+     *   .setId('main')
+     *   .addClass('btn', 'btn-primary', 'btn')
+     *   .build();
+     * // Returns: [
+     * //   HtmlAttribute { key: 'id', ... },
+     * //   HtmlAttribute { key: 'class', value: 'btn btn-primary' }
+     * // ]
+     * ```
+     */
+    build(): HtmlAttribute[];
+}
+
+/**
+ * Task 6.2: Form-related AttributeBuilders
+ *
+ * 専用属性ビルダー（フォーム系）:
+ * - FormAttributeBuilder: action, method, enctype
+ * - InputAttributeBuilder: type, placeholder, required, pattern, minLength, maxLength
+ * - ButtonAttributeBuilder: buttonType
+ *
+ * Requirements: 7.3, 7.4, 7.6
+ */
+
+/**
+ * Specialized attribute builder for HTML form elements.
+ *
+ * @remarks
+ * Extends {@link BaseAttributeBuilder} with form-specific attributes:
+ * - action - Form submission URL
+ * - method - HTTP method (GET or POST)
+ * - enctype - Form data encoding type
+ *
+ * All common attributes from the base builder are also available.
+ *
+ * @example
+ * ```typescript
+ * const formAttrs = new FormAttributeBuilder()
+ *   .setAction('/api/submit')
+ *   .setMethod('post')
+ *   .setEnctype('multipart/form-data')
+ *   .setId('contact-form')
+ *   .addClass('form', 'form-vertical')
+ *   .build();
+ * ```
+ *
+ * @see {@link BaseAttributeBuilder} for common attribute methods
+ */
+declare class FormAttributeBuilder extends BaseAttributeBuilder {
+    /**
+     * Sets the action attribute (form submission URL).
+     *
+     * @param action - The URL where the form data will be sent
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setAction('/api/submit');
+     * // Produces: action="/api/submit"
+     * ```
+     */
+    setAction(action: string): this;
+    /**
+     * Sets the method attribute (HTTP method).
+     *
+     * @param method - The HTTP method ('get' or 'post')
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setMethod('post');
+     * // Produces: method="post"
+     * ```
+     */
+    setMethod(method: 'get' | 'post'): this;
+    /**
+     * Sets the enctype attribute (encoding type).
+     *
+     * @param enctype - The encoding type (e.g., 'multipart/form-data', 'application/x-www-form-urlencoded')
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * Common values:
+     * - 'application/x-www-form-urlencoded' (default)
+     * - 'multipart/form-data' (for file uploads)
+     * - 'text/plain'
+     *
+     * @example
+     * ```typescript
+     * builder.setEnctype('multipart/form-data');
+     * // Produces: enctype="multipart/form-data"
+     * ```
+     */
+    setEnctype(enctype: string): this;
+}
+/**
+ * Specialized attribute builder for HTML input elements.
+ *
+ * @remarks
+ * Extends {@link BaseAttributeBuilder} with input-specific attributes:
+ * - type - Input type (text, email, password, etc.)
+ * - placeholder - Placeholder text
+ * - required - Required field flag
+ * - pattern - Validation pattern (regex)
+ * - minlength/maxlength - Length constraints
+ *
+ * All common attributes from the base builder are also available.
+ *
+ * @example
+ * ```typescript
+ * const emailInput = new InputAttributeBuilder()
+ *   .setInputType('email')
+ *   .setPlaceholder('Enter your email')
+ *   .setRequired(true)
+ *   .setId('email-field')
+ *   .addClass('input', 'input-primary')
+ *   .build();
+ * ```
+ *
+ * @example
+ * Password input with validation
+ * ```typescript
+ * const passwordInput = new InputAttributeBuilder()
+ *   .setInputType('password')
+ *   .setPlaceholder('Enter password')
+ *   .setRequired(true)
+ *   .setMinLength(8)
+ *   .setPattern('^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d).+$')
+ *   .build();
+ * ```
+ *
+ * @see {@link BaseAttributeBuilder} for common attribute methods
+ * @see {@link InputType} for all valid input types
+ */
+declare class InputAttributeBuilder extends BaseAttributeBuilder {
+    /**
+     * Sets the type attribute for the input element.
+     *
+     * @param type - A valid HTML input type
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setInputType('email');    // Produces: type="email"
+     * builder.setInputType('password'); // Produces: type="password"
+     * builder.setInputType('checkbox'); // Produces: type="checkbox"
+     * ```
+     *
+     * @see {@link InputType} for all valid types
+     */
+    setInputType(type: InputType): this;
+    /**
+     * Sets the placeholder attribute.
+     *
+     * @param placeholder - The placeholder text
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setPlaceholder('Enter your email address');
+     * // Produces: placeholder="Enter your email address"
+     * ```
+     */
+    setPlaceholder(placeholder: string): this;
+    /**
+     * Sets the required boolean attribute.
+     *
+     * @param required - If true, adds the required attribute
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setRequired(true);  // Produces: required
+     * builder.setRequired(false); // No attribute added
+     * ```
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Sets the pattern attribute (validation regex).
+     *
+     * @param pattern - A regular expression pattern for validation
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * The pattern is matched against the entire input value (implicit ^ and $).
+     *
+     * @example
+     * ```typescript
+     * // Require at least one uppercase, one lowercase, one digit
+     * builder.setPattern('^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d).{8,}$');
+     *
+     * // Require specific format
+     * builder.setPattern('[0-9]{3}-[0-9]{4}'); // Matches: 123-4567
+     * ```
+     */
+    setPattern(pattern: string): this;
+    /**
+     * Sets the minlength attribute.
+     *
+     * @param length - Minimum number of characters required
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setMinLength(8);
+     * // Produces: minlength="8"
+     * ```
+     */
+    setMinLength(length: number): this;
+    /**
+     * Sets the maxlength attribute.
+     *
+     * @param length - Maximum number of characters allowed
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setMaxLength(100);
+     * // Produces: maxlength="100"
+     * ```
+     */
+    setMaxLength(length: number): this;
+}
+/**
+ * Specialized attribute builder for HTML button elements.
+ *
+ * @remarks
+ * Extends {@link BaseAttributeBuilder} with button-specific attributes:
+ * - type - Button type (submit, reset, or button)
+ *
+ * All common attributes from the base builder are also available.
+ *
+ * @example
+ * Submit button
+ * ```typescript
+ * const submitAttrs = new ButtonAttributeBuilder()
+ *   .setButtonType('submit')
+ *   .setId('submit-btn')
+ *   .addClass('btn', 'btn-primary')
+ *   .build();
+ * ```
+ *
+ * @example
+ * Custom button with ARIA
+ * ```typescript
+ * const closeAttrs = new ButtonAttributeBuilder()
+ *   .setButtonType('button')
+ *   .setAriaLabel('Close dialog')
+ *   .addClass('btn-close')
+ *   .build();
+ * ```
+ *
+ * @see {@link BaseAttributeBuilder} for common attribute methods
+ * @see {@link ButtonType} for all valid button types
+ */
+declare class ButtonAttributeBuilder extends BaseAttributeBuilder {
+    /**
+     * Sets the type attribute for the button element.
+     *
+     * @param type - The button type ('submit', 'reset', or 'button')
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * - 'submit' - Submits the form (default if inside a form)
+     * - 'reset' - Resets form fields to their initial values
+     * - 'button' - No default behavior (use for custom JavaScript)
+     *
+     * @example
+     * ```typescript
+     * builder.setButtonType('submit');
+     * // Produces: type="submit"
+     *
+     * builder.setButtonType('button');
+     * // Produces: type="button"
+     * // Good for buttons that trigger JavaScript, not form submission
+     * ```
+     *
+     * @see {@link ButtonType} for all valid types
+     */
+    setButtonType(type: ButtonType): this;
+}
+
+/**
+ * Task 6.2: Media-related AttributeBuilders
+ *
+ * 専用属性ビルダー（メディア・リンク系）:
+ * - ImageAttributeBuilder: src, alt, width, height, loading
+ * - LinkAttributeBuilder: href, rel, type, media
+ *
+ * Requirements: 7.5
+ */
+
+/**
+ * Specialized attribute builder for HTML img elements.
+ *
+ * @remarks
+ * Extends {@link BaseAttributeBuilder} with image-specific attributes:
+ * - src - Image source URL
+ * - alt - Alternative text for accessibility
+ * - width/height - Image dimensions
+ * - loading - Lazy loading strategy
+ *
+ * All common attributes from the base builder are also available.
+ *
+ * @example
+ * ```typescript
+ * const imgAttrs = new ImageAttributeBuilder()
+ *   .setSrc('/images/hero.jpg')
+ *   .setAlt('Hero banner image')
+ *   .setWidth(800)
+ *   .setHeight(600)
+ *   .setLoading('lazy')
+ *   .addClass('img-responsive')
+ *   .build();
+ * ```
+ *
+ * @see {@link BaseAttributeBuilder} for common attribute methods
+ */
+declare class ImageAttributeBuilder extends BaseAttributeBuilder {
+    /**
+     * Sets the src attribute (image source URL).
+     *
+     * @param src - The URL of the image
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setSrc('/images/logo.png');
+     * // Produces: src="/images/logo.png"
+     *
+     * builder.setSrc('https://example.com/photo.jpg');
+     * // Produces: src="https://example.com/photo.jpg"
+     * ```
+     */
+    setSrc(src: string): this;
+    /**
+     * Sets the alt attribute (alternative text).
+     *
+     * @param alt - Descriptive text for the image (important for accessibility)
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * The alt attribute is crucial for accessibility. It should:
+     * - Describe the image content for screen readers
+     * - Be empty ("") for decorative images
+     * - Not include "image of" or "picture of"
+     *
+     * @example
+     * ```typescript
+     * builder.setAlt('Company logo');
+     * // Produces: alt="Company logo"
+     *
+     * builder.setAlt(''); // Decorative image
+     * // Produces: alt=""
+     * ```
+     */
+    setAlt(alt: string): this;
+    /**
+     * Sets the width attribute.
+     *
+     * @param width - Image width in pixels (number or string)
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * Setting explicit width and height helps prevent layout shift during page load.
+     *
+     * @example
+     * ```typescript
+     * builder.setWidth(800);    // Produces: width="800"
+     * builder.setWidth('100%'); // Produces: width="100%"
+     * ```
+     */
+    setWidth(width: number | string): this;
+    /**
+     * Sets the height attribute.
+     *
+     * @param height - Image height in pixels (number or string)
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * Setting explicit width and height helps prevent layout shift during page load.
+     *
+     * @example
+     * ```typescript
+     * builder.setHeight(600);   // Produces: height="600"
+     * builder.setHeight('auto'); // Produces: height="auto"
+     * ```
+     */
+    setHeight(height: number | string): this;
+    /**
+     * Sets the loading attribute (lazy loading strategy).
+     *
+     * @param loading - Loading strategy ('lazy' or 'eager')
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * - 'lazy' - Defer loading until the image is near the viewport (improves performance)
+     * - 'eager' - Load immediately (default browser behavior)
+     *
+     * @example
+     * ```typescript
+     * builder.setLoading('lazy');
+     * // Produces: loading="lazy"
+     * // Good for below-the-fold images
+     *
+     * builder.setLoading('eager');
+     * // Produces: loading="eager"
+     * // Good for above-the-fold images
+     * ```
+     */
+    setLoading(loading: 'lazy' | 'eager'): this;
+}
+/**
+ * Specialized attribute builder for HTML link and anchor (a) elements.
+ *
+ * @remarks
+ * Extends {@link BaseAttributeBuilder} with link-specific attributes:
+ * - href - Link destination URL
+ * - rel - Relationship between current document and linked resource
+ * - type - MIME type of linked resource
+ * - media - Media query for when the link applies
+ *
+ * All common attributes from the base builder are also available.
+ *
+ * @example
+ * Link element (stylesheet)
+ * ```typescript
+ * const stylesheetAttrs = new LinkAttributeBuilder()
+ *   .setHref('/styles/main.css')
+ *   .setRel('stylesheet')
+ *   .setType('text/css')
+ *   .build();
+ * ```
+ *
+ * @example
+ * Anchor element (hyperlink)
+ * ```typescript
+ * const linkAttrs = new LinkAttributeBuilder()
+ *   .setHref('https://example.com')
+ *   .setRel('noopener noreferrer')
+ *   .setId('external-link')
+ *   .addClass('link', 'link-external')
+ *   .build();
+ * ```
+ *
+ * @see {@link BaseAttributeBuilder} for common attribute methods
+ */
+declare class LinkAttributeBuilder extends BaseAttributeBuilder {
+    /**
+     * Sets the href attribute (link destination).
+     *
+     * @param href - The URL of the linked resource
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setHref('/about');
+     * // Produces: href="/about"
+     *
+     * builder.setHref('https://example.com');
+     * // Produces: href="https://example.com"
+     *
+     * builder.setHref('#section-2');
+     * // Produces: href="#section-2"
+     * ```
+     */
+    setHref(href: string): this;
+    /**
+     * Sets the rel attribute (relationship).
+     *
+     * @param rel - The relationship type(s) (space-separated)
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * Common values:
+     * - 'stylesheet' - CSS stylesheet
+     * - 'icon' - Favicon
+     * - 'noopener' - Prevents window.opener access (security)
+     * - 'noreferrer' - Prevents referer header
+     * - 'nofollow' - Search engine hint
+     *
+     * @example
+     * ```typescript
+     * builder.setRel('stylesheet');
+     * // Produces: rel="stylesheet"
+     *
+     * builder.setRel('noopener noreferrer');
+     * // Produces: rel="noopener noreferrer"
+     * ```
+     */
+    setRel(rel: string): this;
+    /**
+     * Sets the type attribute (MIME type).
+     *
+     * @param type - The MIME type of the linked resource
+     * @returns This builder for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.setType('text/css');
+     * // Produces: type="text/css"
+     *
+     * builder.setType('application/rss+xml');
+     * // Produces: type="application/rss+xml"
+     * ```
+     */
+    setType(type: string): this;
+    /**
+     * Sets the media attribute (media query).
+     *
+     * @param media - CSS media query for when the link applies
+     * @returns This builder for method chaining
+     *
+     * @remarks
+     * Used primarily with `<link>` elements to conditionally load resources.
+     *
+     * @example
+     * ```typescript
+     * builder.setMedia('screen and (min-width: 768px)');
+     * // Produces: media="screen and (min-width: 768px)"
+     *
+     * builder.setMedia('print');
+     * // Produces: media="print"
+     * ```
+     */
+    setMedia(media: string): this;
+}
+
+/**
+ * JsParam — jsTemplate 用変数参照マーカー型と sentinel エンコーディング
+ *
+ * factories.ts と js-template.ts の両方が共通して参照する。
+ * 循環依存を防ぐため、依存関係のない独立したモジュールとして定義する。
+ */
+/**
+ * jsTemplate で使う変数参照マーカー。
+ * param('text') により生成され、属性値として渡された際に
+ * 文字列リテラルではなく変数名として JS コードに展開される。
+ */
+interface JsParam {
+    readonly __jsParam: true;
+    readonly name: string;
+}
+/**
+ * 値が JsParam マーカーかどうかを判定する型ガード。
+ *
+ * @param value - チェックする値
+ * @returns value が JsParam の場合 true
+ */
+declare function isJsParam(value: unknown): value is JsParam;
+
+/**
+ * factories-utils.ts
+ *
+ * 宣言的API共通型と内部ユーティリティ関数。
+ * タグファクトリファイル間で共有される。
+ *
+ * Requirements: 5.2, 5.7, 5.8
+ */
+
+/**
+ * Valid child argument types for tag factory functions.
+ *
+ * Can be either an {@link HTMLTagProtocol} instance or a string (which will be
+ * automatically wrapped in a {@link TextType}).
+ *
+ * @example
+ * ```typescript
+ * const element = div(
+ *   'Plain text',           // string → TextType
+ *   p('Paragraph'),         // HTMLTagProtocol
+ *   span('Inline text')     // HTMLTagProtocol
+ * );
+ * ```
+ */
+type ChildArg = HTMLTagProtocol | string;
+/**
+ * Attribute map for declarative attribute specification.
+ *
+ * **Value Types:**
+ * - `string`: Creates a key-value attribute (e.g., `class="value"`, `id="value"`)
+ * - `true`: Creates a boolean attribute (e.g., `checked`, `disabled`)
+ * - `false`: Omits the attribute entirely
+ *
+ * **Special Keys:**
+ * - `class`: Normalized through `normalizeClassNames`
+ * - `data-*`: Creates custom data attributes
+ * - Other keys: Standard HTML attributes
+ *
+ * @example
+ * ```typescript
+ * const element = div({
+ *   class: 'container active',
+ *   id: 'main',
+ *   'data-value': '123',
+ *   hidden: false  // Omitted from output
+ * });
+ * ```
+ *
+ * @example
+ * Boolean attributes:
+ * ```typescript
+ * const checkbox = input({
+ *   type: 'checkbox',
+ *   checked: true,      // Renders as: checked
+ *   disabled: false     // Omitted
+ * });
+ * ```
+ */
+/**
+ * `css` 属性に渡せる値の型。
+ *
+ * - 単一の `StyleTemplate`（無名 `createStyle({...})` の戻り値）
+ * - 単一の `SharedStyle`（名前あり `createStyle("name", {...})` の戻り値）
+ * - 上記の配列（順序保持で `class` 属性にマージされる）
+ *
+ * Requirements: 1.1, 1.4
+ */
+type CssAttributeValue = StyleTemplate | SharedStyle | ReadonlyArray<StyleTemplate | SharedStyle>;
+type AttributeMap = Record<string, string | boolean | JsParam | CssAttributeValue>;
+
+/**
+ * Creates an `<html>` element.
+ *
+ * The root element of an HTML document.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing an `<html>` element
+ *
+ * @example
+ * ```typescript
+ * const document = html(
+ *   head(title('My Page')),
+ *   body(h1('Welcome'))
+ * );
+ * ```
+ */
+declare const html: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<head>` element.
+ *
+ * Contains metadata and document-level resources.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing a `<head>` element
+ *
+ * @example
+ * ```typescript
+ * const pageHead = head(
+ *   title('My Page'),
+ *   meta({ charset: 'utf-8' })
+ * );
+ * ```
+ */
+declare const head: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<body>` element.
+ *
+ * Contains the visible content of the HTML document.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing a `<body>` element
+ *
+ * @example
+ * ```typescript
+ * const pageBody = body(
+ *   { class: 'main-layout' },
+ *   header(h1('Welcome')),
+ *   main(p('Content'))
+ * );
+ * ```
+ */
+declare const body: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<div>` element.
+ *
+ * A generic container for flow content.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing a `<div>` element
+ *
+ * @example
+ * ```typescript
+ * const container = div(
+ *   { class: 'container' },
+ *   p('First paragraph'),
+ *   p('Second paragraph')
+ * );
+ * ```
+ */
+declare const div: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<p>` element.
+ *
+ * Represents a paragraph of text.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing a `<p>` element
+ *
+ * @example
+ * ```typescript
+ * const paragraph = p('This is a paragraph.');
+ * const styledParagraph = p(
+ *   { class: 'intro' },
+ *   'This is an introduction.'
+ * );
+ * ```
+ */
+declare const p: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<span>` element.
+ *
+ * A generic inline container for phrasing content.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing a `<span>` element
+ *
+ * @example
+ * ```typescript
+ * const highlighted = span({ class: 'highlight' }, 'Important text');
+ * ```
+ */
+declare const span: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<script>` element.
+ *
+ * Used to embed or reference executable JavaScript code.
+ *
+ * @param args - Optional attributes, child elements, and a trailing `HtmlTagOptions`
+ * @returns A new PairType instance representing a `<script>` element
+ *
+ * @example
+ * ```typescript
+ * const inlineScript = script('console.log("Hello");');
+ * const externalScript = script({ src: 'app.js' });
+ * ```
+ */
+declare const script: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+
+/** Creates a `<header>` element (introductory content or navigation aids). */
+declare const header: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<footer>` element (footer for nearest sectioning content or root). */
+declare const footer: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<nav>` element (section with navigation links). */
+declare const nav: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<main>` element (dominant content of the document body). */
+declare const main: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<section>` element (generic section of a document). */
+declare const section: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<article>` element (self-contained composition). */
+declare const article: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<aside>` element (content tangentially related to main content). */
+declare const aside: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<figure>` element (self-contained content with optional caption). */
+declare const figure: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<figcaption>` element (caption or legend for a figure). */
+declare const figcaption: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<h1>` element (level 1 heading). */
+declare const h1: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<h2>` element (level 2 heading). */
+declare const h2: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<h3>` element (level 3 heading). */
+declare const h3: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<h4>` element (level 4 heading). */
+declare const h4: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<h5>` element (level 5 heading). */
+declare const h5: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<h6>` element (level 6 heading). */
+declare const h6: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<details>` element (disclosure widget). */
+declare const details: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<summary>` element (summary for details element). */
+declare const summary: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<dialog>` element (dialog box or modal). */
+declare const dialog: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<iframe>` element (nested browsing context). */
+declare const iframe: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<noscript>` element (fallback for scripts disabled). */
+declare const noscript: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<a>` element (hyperlink). */
+declare const a: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<title>` element (document title). */
+declare const title: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<var>` element (variable in mathematical or programming context).
+ *
+ * **Note:** Named `varTag` instead of `var` to avoid collision with JavaScript's `var` keyword.
+ */
+declare const varTag: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+
+/** Creates a `<table>` element. */
+declare const table: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<thead>` element (table header group). */
+declare const thead: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<tbody>` element (table body group). */
+declare const tbody: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<tfoot>` element (table footer group). */
+declare const tfoot: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<tr>` element (table row). */
+declare const tr: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<th>` element (table header cell). */
+declare const th: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<td>` element (table data cell). */
+declare const td: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<caption>` element (table caption). */
+declare const caption: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<colgroup>` element (table column group). */
+declare const colgroup: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<ul>` element (unordered list). */
+declare const ul: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<ol>` element (ordered list). */
+declare const ol: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<li>` element (list item). */
+declare const li: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<dl>` element (description list). */
+declare const dl: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<dt>` element (description term). */
+declare const dt: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<dd>` element (description details). */
+declare const dd: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+
+/** Creates a `<form>` element. */
+declare const form: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<label>` element (label for a form control). */
+declare const label: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<button>` element. */
+declare const button: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<select>` element (dropdown list). */
+declare const select: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<option>` element (option in a select list). */
+declare const option: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<optgroup>` element (group of options). */
+declare const optgroup: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<textarea>` element (multi-line text input). */
+declare const textarea: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<fieldset>` element (group of form controls). */
+declare const fieldset: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<legend>` element (caption for a fieldset). */
+declare const legend: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<datalist>` element (predefined options for input). */
+declare const datalist: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<output>` element (result of a calculation). */
+declare const output: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+
+/** Creates a `<strong>` element (strong importance, serious urgency). */
+declare const strong: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<em>` element (stress emphasis). */
+declare const em: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<b>` element (bring attention to, stylistically offset). */
+declare const b: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<i>` element (alternative voice or mood). */
+declare const i: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<u>` element (unarticulated annotation). */
+declare const u: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<s>` element (strikethrough, no longer accurate). */
+declare const s: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<mark>` element (highlighted reference). */
+declare const mark: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<small>` element (side comments, small print). */
+declare const small: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<sub>` element (subscript). */
+declare const sub: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<sup>` element (superscript). */
+declare const sup: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<code>` element (fragment of computer code). */
+declare const code: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<pre>` element (preformatted text). */
+declare const pre: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<blockquote>` element (block quotation). */
+declare const blockquote: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<q>` element (inline quotation). */
+declare const q: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<cite>` element (title of a creative work). */
+declare const cite: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<abbr>` element (abbreviation or acronym). */
+declare const abbr: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<address>` element (contact information). */
+declare const address: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<time>` element (date/time). */
+declare const time: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<kbd>` element (keyboard input). */
+declare const kbd: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<samp>` element (sample output). */
+declare const samp: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+
+/** Creates a `<video>` element (video player). */
+declare const video: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<audio>` element (audio player). */
+declare const audio: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<picture>` element (responsive image container). */
+declare const picture: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates a `<canvas>` element (scriptable graphics). */
+declare const canvas: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/** Creates an `<svg>` element (scalable vector graphics). */
+declare const svg: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+/**
+ * Creates a `<br>` element (line break).
+ *
+ * @returns A new SelfClosingType instance representing a `<br>` element
+ *
+ * @example
+ * ```typescript
+ * const lineBreak = br();
+ * // Renders as: <br>
+ * ```
+ */
+declare const br: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates an `<hr>` element (thematic break / horizontal rule).
+ *
+ * @returns A new SelfClosingType instance representing an `<hr>` element
+ *
+ * @example
+ * ```typescript
+ * const separator = hr();
+ * // Renders as: <hr>
+ * ```
+ */
+declare const hr: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates an `<img>` element (image).
+ *
+ * @param attrs - Optional attributes (typically includes `src` and `alt`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing an `<img>` element
+ *
+ * @example
+ * ```typescript
+ * const image = img({ src: 'photo.jpg', alt: 'My photo' });
+ * // Renders as: <img src="photo.jpg" alt="My photo">
+ * ```
+ */
+declare const img: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates an `<input>` element (form input control).
+ *
+ * @param attrs - Optional attributes (e.g., `type`, `name`, `value`, `placeholder`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing an `<input>` element
+ *
+ * @example
+ * ```typescript
+ * const textInput = input({ type: 'text', placeholder: 'Enter name' });
+ * const checkbox = input({ type: 'checkbox', checked: true });
+ * ```
+ */
+declare const input: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<meta>` element (metadata).
+ *
+ * @param attrs - Optional attributes (e.g., `charset`, `name`, `content`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing a `<meta>` element
+ *
+ * @example
+ * ```typescript
+ * const charset = meta({ charset: 'utf-8' });
+ * const viewport = meta({ name: 'viewport', content: 'width=device-width' });
+ * ```
+ */
+declare const meta: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<link>` element (external resource link, typically CSS).
+ *
+ * @param attrs - Optional attributes (e.g., `rel`, `href`, `type`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing a `<link>` element
+ *
+ * @example
+ * ```typescript
+ * const stylesheet = link({ rel: 'stylesheet', href: 'styles.css' });
+ * const icon = link({ rel: 'icon', href: 'favicon.ico' });
+ * ```
+ */
+declare const link: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<source>` element (media source for `<video>`, `<audio>`, or `<picture>`).
+ *
+ * @param attrs - Optional attributes (e.g., `src`, `type`, `media`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing a `<source>` element
+ *
+ * @example
+ * ```typescript
+ * const videoSource = source({ src: 'video.mp4', type: 'video/mp4' });
+ * ```
+ */
+declare const source: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<track>` element (text track for media elements).
+ *
+ * @param attrs - Optional attributes (e.g., `kind`, `src`, `srclang`, `label`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing a `<track>` element
+ *
+ * @example
+ * ```typescript
+ * const subtitles = track({ kind: 'subtitles', src: 'subs.vtt', srclang: 'en' });
+ * ```
+ */
+declare const track: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates an `<area>` element (clickable area in an image map).
+ *
+ * @param attrs - Optional attributes (e.g., `shape`, `coords`, `href`, `alt`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing an `<area>` element
+ */
+declare const area: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<col>` element (table column definition).
+ *
+ * @param attrs - Optional attributes (e.g., `span`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing a `<col>` element
+ */
+declare const col: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<base>` element (base URL for relative URLs).
+ *
+ * @param attrs - Optional attributes (e.g., `href`, `target`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing a `<base>` element
+ *
+ * @example
+ * ```typescript
+ * const baseUrl = base({ href: 'https://example.com/' });
+ * ```
+ */
+declare const base: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates an `<embed>` element (embedded external content).
+ *
+ * @param attrs - Optional attributes (e.g., `src`, `type`, `width`, `height`)
+ * @param options - Optional HtmlTagOptions (for css/jqm injection)
+ * @returns A new SelfClosingType instance representing an `<embed>` element
+ */
+declare const embed: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a `<wbr>` element (word break opportunity).
+ *
+ * @returns A new SelfClosingType instance representing a `<wbr>` element
+ *
+ * @example
+ * ```typescript
+ * const longUrl = p('https://very', wbr(), 'long', wbr(), 'url.com');
+ * ```
+ */
+declare const wbr: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+/**
+ * Creates a text node.
+ *
+ * Text nodes are usually created automatically when passing strings to tag factories,
+ * but this function can be used for explicit text node creation.
+ *
+ * @param content - The text content (HTML-escaped automatically)
+ * @returns A new TextType instance
+ *
+ * @example
+ * ```typescript
+ * // Explicit text node creation
+ * const text = Text('Hello <World>'); // renders: Hello &lt;World&gt;
+ *
+ * // Usually, strings are auto-converted:
+ * const paragraph = p('This is automatically wrapped in TextType');
+ * ```
+ */
+declare function Text(content: string): TextType;
+declare namespace Text {
+    var unsafeRaw: (content: string) => TextType;
+}
+
+declare const tags: {
+    readonly html: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly head: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly body: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly div: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly p: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly span: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly script: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly header: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly footer: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly nav: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly main: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly section: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly article: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly aside: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly figure: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly figcaption: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly h1: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly h2: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly h3: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly h4: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly h5: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly h6: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly details: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly summary: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly dialog: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly iframe: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly noscript: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly a: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly title: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly varTag: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly table: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly thead: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly tbody: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly tfoot: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly tr: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly th: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly td: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly caption: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly colgroup: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly ul: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly ol: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly li: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly dl: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly dt: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly dd: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly form: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly label: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly button: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly select: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly option: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly optgroup: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly textarea: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly fieldset: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly legend: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly datalist: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly output: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly strong: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly em: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly b: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly i: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly u: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly s: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly mark: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly small: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly sub: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly sup: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly code: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly pre: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly blockquote: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly q: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly cite: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly abbr: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly address: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly time: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly kbd: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly samp: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly video: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly audio: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly picture: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly canvas: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly svg: (...args: Array<AttributeMap | ChildArg | HtmlTagOptions>) => PairType;
+    readonly br: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly hr: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly img: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly input: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly meta: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly link: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly source: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly track: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly area: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly col: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly base: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly embed: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly wbr: (attrs?: AttributeMap, options?: HtmlTagOptions) => SelfClosingType;
+    readonly Text: typeof Text;
+};
+
+/**
+ * HTMLFormatter: minified HTMLを整形済みHTMLに変換するユーティリティ
+ *
+ * protoRender()が生成したインデントなしHTML文字列を、
+ * 4スペースインデント + 改行付きの整形済みHTMLに変換する。
+ *
+ * Requirements: 6.1
+ */
+declare class HTMLFormatter {
+    static format(minifiedHtml: string): string;
+}
+
+declare class CssPositionMaker implements CssPositionMakerType {
+    /** タグの階層パス（例: 'html>body>div'） */
+    tagPath: string;
+    private _relationShip?;
+    private _top?;
+    private _left?;
+    private _width?;
+    private _height?;
+    private _bottom?;
+    private _right?;
+    private _llRegister?;
+    /**
+     * CssPositionMaker を構築する
+     * @param tagPath - タグの階層パス
+     */
+    constructor(tagPath: string);
+    /**
+     * 現在の配置設定の概要を取得する
+     *
+     * top, left, width, height の値を含むオブジェクトを返す。
+     * 遅延レイアウト解決に使用される。
+     *
+     * @returns 配置設定の概要
+     */
+    get description(): CssPlaceDescription;
+    /**
+     * 遅延レイアウトレジスタを更新する
+     *
+     * @param register - 遅延レイアウトレジスタ（undefined で解除）
+     */
+    updateLLRegister(register: LazyLayoutRegister | undefined): void;
+    /**
+     * 遅延レイアウトレジスタを取得する
+     *
+     * @returns 遅延レイアウトレジスタ、または undefined
+     */
+    getLLRegister(): LazyLayoutRegister | undefined;
+    /**
+     * 絶対配置を設定する
+     *
+     * position: absolute を設定し、ビルダーで配置プロパティを指定する。
+     * 絶対配置は位置指定された祖先要素を基準とする。
+     *
+     * @param closure - 配置プロパティを設定するビルダー関数
+     *
+     * @example
+     * ```ts
+     * maker.placeAbsoluteWith(b => {
+     *   b.top(0, 'px').left(0, 'px').width(100, '%').height(100, '%');
+     * });
+     * ```
+     */
+    placeAbsoluteWith(closure: (builder: CssLayoutBuilder) => void): void;
+    /**
+     * 相対配置を設定する
+     *
+     * position: relative を設定し、ビルダーで配置プロパティを指定する。
+     * 相対配置は元の位置からのオフセットを指定する。
+     *
+     * @param closure - 配置プロパティを設定するビルダー関数
+     *
+     * @example
+     * ```ts
+     * maker.placeRelativeWith(b => {
+     *   b.top(10, 'px').left(10, 'px');
+     * });
+     * ```
+     */
+    placeRelativeWith(closure: (builder: CssLayoutBuilder) => void): void;
+    /**
+     * 通常配置を設定する
+     *
+     * position: static を設定する（デフォルトのドキュメントフロー）。
+     *
+     * @param closure - 配置プロパティを設定するビルダー関数
+     */
+    placeStaticWith(closure: (builder: CssLayoutBuilder) => void): void;
+    /**
+     * 固定配置を設定する
+     *
+     * position: fixed を設定し、ビルダーで配置プロパティを指定する。
+     * 固定配置はビューポートを基準とする。
+     *
+     * @param closure - 配置プロパティを設定するビルダー関数
+     *
+     * @example
+     * ```ts
+     * maker.placeFixedWith(b => {
+     *   b.top(0, 'px').right(0, 'px').width(200, 'px');
+     * });
+     * ```
+     */
+    placeFixedWith(closure: (builder: CssLayoutBuilder) => void): void;
+    /**
+     * 配置プロパティをCSS文字列としてレンダリングする
+     *
+     * 設定されたプロパティのみをアルファベット順にソートして出力する。
+     *
+     * @returns CSS文字列（未設定の場合は空文字列）
+     */
+    render(): string;
+    private placeWith;
+    private collectProperties;
+}
+
+/**
+ * CSSスタイル管理クラス
+ *
+ * {@link HtmlStyle} インスタンスを保持し、13種類のCSSプロパティクラスへの
+ * アクセスとレンダリング機能を提供する。
+ *
+ * ## 管理するプロパティカテゴリ
+ *
+ * - フォント ({@link CSSFont})
+ * - 背景 ({@link CSSBackground})
+ * - テキスト ({@link CSSText})
+ * - 余白 ({@link CSSSpacing})
+ * - 枠線 ({@link CSSBorder})
+ * - 表示制御 ({@link CSSVisibility})
+ * - Flexbox ({@link CSSFlex})
+ * - Grid ({@link CSSGrid})
+ * - 視覚効果 ({@link CSSVisual})
+ * - 変形 ({@link CSSTransform})
+ * - アニメーション ({@link CSSAnimation})
+ * - テーブル ({@link CSSTable})
+ * - リスト ({@link CSSList})
+ *
+ * @example
+ * ```ts
+ * const manager = new CssStyleManager();
+ * manager.style.font.setFontSize('16px').setColor('#333');
+ * manager.style.spacing.setMarginTop('10px');
+ *
+ * console.log(manager.render());
+ * // → "color: #333;\nfont-size: 16px;\nmargin-top: 10px;"
+ * ```
+ *
+ * @see {@link CssStyleManagerType}
+ * @see {@link HtmlStyle}
+ */
+
+declare class CssStyleManager implements CssStyleManagerType {
+    /** HtmlStyle インスタンス（13種類のプロパティクラスを統合管理） */
+    readonly style: HtmlStyle;
+    /**
+     * すべてのスタイルプロパティをCSS文字列としてレンダリングする
+     *
+     * @returns CSS文字列（設定されたプロパティがない場合は空文字列）
+     */
+    render(): string;
+    /**
+     * 設定されたフォントサイズを HlUnit として取得する
+     *
+     * コンテキスト伝播（em単位の計算など）に使用される。
+     *
+     * @returns フォントサイズの HlUnit、または undefined（未設定時）
+     */
+    getFontSizeUnit(): HlUnit | undefined;
+}
+
+/**
+ * CSS中央管理クラス
+ *
+ * CssStyleManager と CssPositionMaker を統合的に保持し、
+ * CSS文字列の統合出力とスコープドCSS出力を提供する。
+ *
+ * ## 主な機能
+ *
+ * - **スタイル管理**: {@link CssStyleManager} を通じて13種類のCSSプロパティを管理
+ * - **レイアウト管理**: {@link CssPositionMaker} を通じて要素の配置を管理
+ * - **スコープドCSS**: タグパスに基づくハッシュクラス名の自動生成
+ * - **遅延レイアウト**: {@link LazyLayoutManager} との連携による依存関係の解決
+ *
+ * ## レンダリング
+ *
+ * - {@link render}(): スタイルCSS + レイアウトCSS の結合文字列
+ * - {@link renderCss}(): スコープドCSS形式（`._{hash}` { ... }）またはインラインスタイル
+ *
+ * @example
+ * ```ts
+ * const manager = new CssManager('html>body>div');
+ * manager.styleManager.style.font.setFontSize('16px');
+ * manager.layout.placeAbsoluteWith(b => b.top(0, 'px').left(0, 'px'));
+ *
+ * // インラインスタイル出力
+ * console.log(manager.render());
+ * // → "font-size: 16px;\nleft: 0px;\nposition: absolute;\ntop: 0px;"
+ *
+ * // スコープドCSS出力
+ * console.log(manager.renderCss());
+ * // → "._a1b2c3d4 {\nfont-size: 16px;\nleft: 0px;\nposition: absolute;\ntop: 0px;\n}"
+ * ```
+ *
+ * @see {@link CssManagerInstance}
+ * @see {@link CssStyleManager}
+ * @see {@link CssPositionMaker}
+ * @see {@link CssConfig}
+ */
+
+declare class CssManager implements CssManagerInstance {
+    /** レイアウト管理インスタンス */
+    readonly layout: CssPositionMaker;
+    /** スタイル管理インスタンス */
+    readonly styleManager: CssStyleManager;
+    /** CSS出力設定 */
+    readonly config: CssConfig;
+    /** タグの階層パス（例: 'html>body>div'） */
+    tagPath: string;
+    /**
+     * `scopedCssEnabled=false` モードで擬似クラススタイルを検出した際に、
+     * 当該 manager インスタンスで既に警告を発火したかを示すフラグ。
+     * 同一要素からの重複警告を抑止するために用いる。
+     */
+    private _pseudoWarningEmitted;
+    /**
+     * `registerTemplate` で蓄積された (className, template) エントリ列。
+     *
+     * **render-phase only**：`registerTemplate` は `HtmlTag.protoRender` 内
+     * （tagPath 確定後）でのみ呼ばれる。属性パース時には呼ばれない。
+     * 同一 `(tagPath, template.bodyHash)` 重複登録は冪等で、
+     * このバッファに同じエントリを 2 度蓄積しない。
+     *
+     * 出力順は登録順を保持する（`renderCss()` で順序保持）。
+     *
+     * @internal
+     */
+    private readonly _registeredTemplates;
+    /**
+     * 同一 `(tagPath, bodyHash)` の冪等性判定用キーセット。
+     * @internal
+     */
+    private readonly _registeredKeys;
+    /**
+     * @media ルールの内部ストレージ。
+     *
+     * キー: ブレークポイント（px 値）
+     * 値: プロパティ名 → 値 のマップ
+     *
+     * 同一ブレークポイントへの `addMediaRule` 呼び出しはプロパティをマージする。
+     * レンダリングは Task 4.2 で実装する。
+     *
+     * @internal
+     */
+    private readonly _mediaRules;
+    /**
+     * CssManager を構築する
+     *
+     * @param tagPath - タグの階層パス（デフォルト: ''）
+     * @param config - CSS出力設定（省略時はデフォルト設定）
+     */
+    constructor(tagPath?: string, config?: CssConfig);
+    /**
+     * タグパスを更新し、レイアウトマネージャーにも伝播する
+     *
+     * @param newPath - 新しいタグパス
+     */
+    updateTagPath(newPath: string): void;
+    /**
+     * 遅延レイアウトレジスタを更新する
+     *
+     * @param register - 遅延レイアウトレジスタ（undefined で解除）
+     */
+    updateLazyLayoutRegister(register: LazyLayoutRegister | undefined): void;
+    /**
+     * `StyleTemplate` を内部バッファに登録し、解決済みクラス名を返す。
+     *
+     * **契約（design.md "registerTemplate の Pre/Post 条件" を参照）**：
+     *
+     * - Pre: `tagPath` は非空。`registerTemplate` は **render フェーズでのみ呼ばれる**
+     *   （属性パース時には呼ばれない）。
+     * - Post: 戻り値の `className` は
+     *   `resolver.resolveClassName(tagPath, template.bodyHash, template.debugVarName)` と同値。
+     *   `template.debugVarName` が未設定の場合は従来の bodyHash 経路と同一形式となる。
+     *   内部バッファに `(className, template)` を登録順で追加する。
+     *   同一 `(tagPath, template.bodyHash)` の重複登録は冪等で、
+     *   同じ className を返し、バッファに重複追加しない。
+     *
+     * `renderCss()` 出力には登録された rule が登録順で含まれる。
+     *
+     * @param template - 登録対象の StyleTemplate
+     * @param resolver - クラス名解決に用いる IdentifierResolver
+     * @param tagPath - 要素の構造パス（非空）
+     * @returns 解決済みクラス名
+     *
+     * Requirements: 1.1, 1.2, 1.3, 1.4, 1.7
+     */
+    registerTemplate(template: StyleTemplate, resolver: IdentifierResolver, tagPath: string): string;
+    /**
+     * スタイルCSSとレイアウトCSSを結合して返す
+     *
+     * スコープクラスなしのインラインスタイル形式で出力する。
+     *
+     * @returns CSS文字列（両方とも空の場合は空文字列）
+     */
+    render(): string;
+    /**
+     * スコープドCSSまたはインラインスタイルとして出力する
+     *
+     * {@link CssConfig.scopedCssEnabled} が true の場合、
+     * タグパスから生成したハッシュクラス名で CSS をラップする。
+     *
+     * `resolver` が指定された場合、wrapper class 名は `resolver.resolveClassName(tagPath)`
+     * から取得する（minify モード等が反映される）。省略時は従来通り
+     * `generateScopedClassName(tagPath)` を直接呼ぶ（既存挙動とバイト等価）。
+     *
+     * 設計: minify 状態の単一情報源は `IdentifierResolver`。`this.config.minifyClassNames`
+     * は本メソッドからは参照しない（css-config-pipeline-wiring spec）。
+     *
+     * @param resolver - クラス名解決に用いる IdentifierResolver（省略可）
+     * @returns スコープドCSS文字列またはインラインスタイル
+     *
+     * @example
+     * ```ts
+     * // scopedCssEnabled = true の場合
+     * // "._a1b2c3d4 {\nfont-size: 16px;\n}"
+     *
+     * // scopedCssEnabled = false の場合
+     * // "font-size: 16px;"
+     * ```
+     */
+    renderCss(resolver?: IdentifierResolver): string;
+    /**
+     * @media ルールを内部マップに追加する。
+     *
+     * 同一ブレークポイントに対して複数回呼び出した場合、プロパティはマージされる。
+     * 同一プロパティ名が既に存在する場合は上書きされる。
+     *
+     * @param breakpointPx - ブレークポイント（px 値）
+     * @param props - 追加するCSSプロパティのマップ
+     *
+     * Requirements: 9.1, 9.4
+     */
+    addMediaRule(breakpointPx: number, props: Record<string, string>): void;
+    /**
+     * `_mediaRules` を `@media (min-width: {bp}px) { .{className} { ... } }` ブロックの配列に展開する。
+     *
+     * ブレークポイントの昇順でブロックを生成する。
+     * プロパティ名は kebab-case に変換する。
+     *
+     * @param className - スコープドクラス名（`_` プレフィックス付きハッシュ）
+     * @internal
+     */
+    private _renderMediaBlocks;
+    /**
+     * 登録済みテンプレートを登録順に CSS ブロック文字列の配列に展開する。
+     * @internal
+     */
+    private _renderRegisteredBlocks;
+}
+
+/**
+ * デフォルトCSS管理クラス（no-op実装）
+ *
+ * {@link CssManagerInstance} のデフォルト実装で、すべてのメソッドが
+ * 空文字列または空操作を返す。CSS が設定されていない {@link HtmlTag} に
+ * 注入され、Null Objectパターンとして機能する。
+ *
+ * ## 用途
+ *
+ * - CSS未設定のタグに対する安全なデフォルト実装
+ * - CSS機能を使用しない場合のオーバーヘッド削減
+ * - Null Objectパターンによる条件分岐の削減
+ *
+ * @example
+ * ```ts
+ * const tag = new HtmlTag('div');
+ * // tag.css は内部的に DefaultCssManager のインスタンス
+ *
+ * tag.css.render(); // → ''
+ * tag.css.renderCss(); // → ''
+ * tag.css.layout.render(); // → ''
+ * ```
+ *
+ * @see {@link CssManagerInstance}
+ * @see {@link CssManager}
+ */
+
+declare class DefaultCssManager implements CssManagerInstance {
+    /** タグの階層パス（常に空文字列） */
+    tagPath: string;
+    /** no-opレイアウトマネージャー */
+    readonly layout: CssPositionMakerType;
+    /** no-opスタイルマネージャー */
+    readonly styleManager: CssStyleManagerType;
+    /**
+     * タグパスを更新する（no-op）
+     * @param newPath - 新しいタグパス
+     */
+    updateTagPath(newPath: string): void;
+    /**
+     * 遅延レイアウトレジスタを更新する（no-op）
+     * @param _register - 遅延レイアウトレジスタ
+     */
+    updateLazyLayoutRegister(_register: LazyLayoutRegister | undefined): void;
+    /**
+     * CSS文字列をレンダリングする（常に空文字列を返す）
+     * @returns 空文字列
+     */
+    render(): string;
+    /**
+     * スコープドCSS文字列をレンダリングする（常に空文字列を返す）
+     * @returns 空文字列
+     */
+    renderCss(): string;
+    /**
+     * @media ルールを追加する（no-op）
+     * @param _breakpointPx - ブレークポイント（px 値）
+     * @param _props - 追加するCSSプロパティのマップ
+     */
+    addMediaRule(_breakpointPx: number, _props: Record<string, string>): void;
+}
+
+/**
+ * CSSプロパティキー定数
+ *
+ * camelCase形式のJavaScriptプロパティ名からハイフネーション付きCSS標準名への
+ * マッピングを提供する。Swift版の CSSPropertyKey enum の rawValue と完全一致する。
+ *
+ * ## プロパティカテゴリと数
+ *
+ * | カテゴリ | プロパティ数 | 例 |
+ * |---------|-------------|-----|
+ * | Font | 7 | font-size, color, line-height |
+ * | Background | 5 | background-color, background-image |
+ * | Spacing | 10 | margin, padding |
+ * | Border | 20 | border-width, border-radius |
+ * | Flex | 12 | flex-direction, justify-content |
+ * | Grid | 14 | grid-template-columns, grid-gap |
+ * | Visual | 6 | box-shadow, opacity, cursor |
+ * | Text | 13 | text-align, text-decoration |
+ * | Transform | 6 | transform, filter |
+ * | Animation | 14 | animation, transition |
+ * | Table | 5 | border-collapse, table-layout |
+ * | List | 4 | list-style-type |
+ * | Visibility | 31 | display, width, height, position |
+ *
+ * **合計: 148プロパティ**
+ *
+ * ## 使用例
+ *
+ * @example
+ * ```ts
+ * // プロパティキーの使用
+ * CSSPropertyKey.fontSize // → "font-size"
+ * CSSPropertyKey.backgroundColor // → "background-color"
+ * CSSPropertyKey.marginTop // → "margin-top"
+ *
+ * // プロパティクラスでの使用
+ * const properties = new Map<string, string>();
+ * properties.set(CSSPropertyKey.fontSize, '16px');
+ * properties.set(CSSPropertyKey.color, '#333');
+ * ```
+ *
+ * @see {@link CSSPropertyKeyValue}
+ */
+declare const CSSPropertyKey: {
+    readonly fontFamily: "font-family";
+    readonly fontSize: "font-size";
+    readonly fontWeight: "font-weight";
+    readonly fontStyle: "font-style";
+    readonly color: "color";
+    readonly lineHeight: "line-height";
+    readonly letterSpacing: "letter-spacing";
+    readonly background: "background";
+    readonly backgroundColor: "background-color";
+    readonly backgroundImage: "background-image";
+    readonly backgroundSize: "background-size";
+    readonly backgroundPosition: "background-position";
+    readonly backgroundRepeat: "background-repeat";
+    readonly marginTop: "margin-top";
+    readonly marginRight: "margin-right";
+    readonly marginBottom: "margin-bottom";
+    readonly marginLeft: "margin-left";
+    readonly margin: "margin";
+    readonly paddingTop: "padding-top";
+    readonly paddingRight: "padding-right";
+    readonly paddingBottom: "padding-bottom";
+    readonly paddingLeft: "padding-left";
+    readonly padding: "padding";
+    readonly borderWidth: "border-width";
+    readonly borderStyle: "border-style";
+    readonly borderColor: "border-color";
+    readonly borderRadius: "border-radius";
+    readonly borderTopWidth: "border-top-width";
+    readonly borderTopStyle: "border-top-style";
+    readonly borderTopColor: "border-top-color";
+    readonly borderRightWidth: "border-right-width";
+    readonly borderRightStyle: "border-right-style";
+    readonly borderRightColor: "border-right-color";
+    readonly borderBottomWidth: "border-bottom-width";
+    readonly borderBottomStyle: "border-bottom-style";
+    readonly borderBottomColor: "border-bottom-color";
+    readonly borderLeftWidth: "border-left-width";
+    readonly borderLeftStyle: "border-left-style";
+    readonly borderLeftColor: "border-left-color";
+    readonly borderTopLeftRadius: "border-top-left-radius";
+    readonly borderTopRightRadius: "border-top-right-radius";
+    readonly borderBottomRightRadius: "border-bottom-right-radius";
+    readonly borderBottomLeftRadius: "border-bottom-left-radius";
+    readonly flex: "flex";
+    readonly flexDirection: "flex-direction";
+    readonly justifyContent: "justify-content";
+    readonly alignItems: "align-items";
+    readonly gap: "gap";
+    readonly flexWrap: "flex-wrap";
+    readonly flexGrow: "flex-grow";
+    readonly flexShrink: "flex-shrink";
+    readonly flexBasis: "flex-basis";
+    readonly alignSelf: "align-self";
+    readonly order: "order";
+    readonly alignContent: "align-content";
+    readonly gridTemplateColumns: "grid-template-columns";
+    readonly gridTemplateRows: "grid-template-rows";
+    readonly gridGap: "grid-gap";
+    readonly gridColumn: "grid-column";
+    readonly gridRow: "grid-row";
+    readonly gridColumnStart: "grid-column-start";
+    readonly gridColumnEnd: "grid-column-end";
+    readonly gridRowStart: "grid-row-start";
+    readonly gridRowEnd: "grid-row-end";
+    readonly gridTemplateAreas: "grid-template-areas";
+    readonly gridArea: "grid-area";
+    readonly gridAutoFlow: "grid-auto-flow";
+    readonly gridAutoColumns: "grid-auto-columns";
+    readonly gridAutoRows: "grid-auto-rows";
+    readonly boxShadow: "box-shadow";
+    readonly opacity: "opacity";
+    readonly cursor: "cursor";
+    readonly overflow: "overflow";
+    readonly overflowX: "overflow-x";
+    readonly overflowY: "overflow-y";
+    readonly textAlign: "text-align";
+    readonly textDecoration: "text-decoration";
+    readonly textTransform: "text-transform";
+    readonly textIndent: "text-indent";
+    readonly wordSpacing: "word-spacing";
+    readonly whiteSpace: "white-space";
+    readonly textOverflow: "text-overflow";
+    readonly textDecorationColor: "text-decoration-color";
+    readonly textDecorationStyle: "text-decoration-style";
+    readonly textDecorationLine: "text-decoration-line";
+    readonly wordBreak: "word-break";
+    readonly overflowWrap: "overflow-wrap";
+    readonly textShadow: "text-shadow";
+    readonly transform: "transform";
+    readonly transformOrigin: "transform-origin";
+    readonly filter: "filter";
+    readonly backdropFilter: "backdrop-filter";
+    readonly perspective: "perspective";
+    readonly perspectiveOrigin: "perspective-origin";
+    readonly animationName: "animation-name";
+    readonly animationDuration: "animation-duration";
+    readonly animationTimingFunction: "animation-timing-function";
+    readonly animationDelay: "animation-delay";
+    readonly animationIterationCount: "animation-iteration-count";
+    readonly animationDirection: "animation-direction";
+    readonly animationFillMode: "animation-fill-mode";
+    readonly animationPlayState: "animation-play-state";
+    readonly animation: "animation";
+    readonly transitionProperty: "transition-property";
+    readonly transitionDuration: "transition-duration";
+    readonly transitionTimingFunction: "transition-timing-function";
+    readonly transitionDelay: "transition-delay";
+    readonly transition: "transition";
+    readonly borderCollapse: "border-collapse";
+    readonly borderSpacing: "border-spacing";
+    readonly tableLayout: "table-layout";
+    readonly captionSide: "caption-side";
+    readonly emptyCells: "empty-cells";
+    readonly listStyleType: "list-style-type";
+    readonly listStylePosition: "list-style-position";
+    readonly listStyleImage: "list-style-image";
+    readonly listStyle: "list-style";
+    readonly display: "display";
+    readonly visibility: "visibility";
+    readonly zIndex: "z-index";
+    readonly cssFloat: "float";
+    readonly clear: "clear";
+    readonly position: "position";
+    readonly top: "top";
+    readonly right: "right";
+    readonly bottom: "bottom";
+    readonly left: "left";
+    readonly width: "width";
+    readonly height: "height";
+    readonly minWidth: "min-width";
+    readonly maxWidth: "max-width";
+    readonly minHeight: "min-height";
+    readonly maxHeight: "max-height";
+    readonly objectFit: "object-fit";
+    readonly objectPosition: "object-position";
+    readonly verticalAlign: "vertical-align";
+    readonly content: "content";
+    readonly pointerEvents: "pointer-events";
+    readonly userSelect: "user-select";
+    readonly resize: "resize";
+    readonly outline: "outline";
+    readonly outlineColor: "outline-color";
+    readonly outlineStyle: "outline-style";
+    readonly outlineWidth: "outline-width";
+    readonly outlineOffset: "outline-offset";
+    readonly boxSizing: "box-sizing";
+    readonly clip: "clip";
+    readonly clipPath: "clip-path";
+};
+
+/**
+ * 遅延レイアウト解決管理クラス
+ *
+ * 要素間の位置関係を登録し、依存関係のある配置計算を遅延評価で解決する。
+ * 循環依存を検出し、エラーをスローすることで無限ループを防止する。
+ *
+ * ## 主な機能
+ *
+ * - **レイアウトアイテムの登録**: 要素間の位置関係を記述
+ * - **遅延評価**: 依存関係を持つ配置値の段階的な解決
+ * - **循環依存検出**: Set による訪問済みパスの追跡
+ * - **CSS出力**: 解決済みレイアウトのCSS文字列生成
+ *
+ * ## 使用例
+ *
+ * @example
+ * ```ts
+ * const manager = new LazyLayoutManager();
+ *
+ * // 要素Aの配置を登録
+ * manager.registerItem({
+ *   relationShip: 'absolute',
+ *   baseTagPath: 'html>body>div.a',
+ *   basePosition: 'left',
+ *   targetTagPath: undefined,
+ *   targetPosition: 'none',
+ *   value: { value: 0, unit: 'px' }
+ * });
+ *
+ * // 要素Bの配置を要素Aに依存させる
+ * manager.registerItem({
+ *   relationShip: 'absolute',
+ *   baseTagPath: 'html>body>div.b',
+ *   basePosition: 'left',
+ *   targetTagPath: 'html>body>div.a', // 要素Aを参照
+ *   targetPosition: 'left',
+ *   value: undefined // 遅延評価で解決される
+ * });
+ *
+ * // すべての遅延レイアウトを解決
+ * manager.resolveAllLayout();
+ *
+ * // 要素Bのレイアウトを出力
+ * console.log(manager.renderItemsBy('html>body>div.b'));
+ * // → "left: 0px;"
+ * ```
+ *
+ * @see {@link LazyLayoutRegister}
+ * @see {@link LayoutRegisteredItem}
+ * @see {@link CssPositionMaker}
+ */
+
+declare class LazyLayoutManager implements LazyLayoutRegister {
+    private items;
+    /**
+     * レイアウトアイテムを登録する
+     *
+     * @param item - 登録するレイアウトアイテム
+     */
+    registerItem(item: LayoutRegisteredItem): void;
+    /**
+     * 指定されたタグパスの position 値を取得する
+     *
+     * @param tagPath - タグの階層パス
+     * @returns position 値（'static' | 'relative' | 'absolute' | 'fixed'）、または undefined
+     */
+    getRelationShip(tagPath: string): RelationShip | undefined;
+    /**
+     * すべての遅延レイアウトを解決する
+     *
+     * 未解決の値（value が undefined）を持つアイテムを検索し、
+     * 依存関係を辿って値を解決する。循環依存が検出された場合は Error をスローする。
+     *
+     * @throws {Error} 循環依存が検出された場合
+     */
+    resolveAllLayout(): void;
+    /**
+     * 指定されたタグパスのレイアウトアイテムをCSS文字列として出力する
+     *
+     * position プロパティは出力されない（個別要素用）。
+     *
+     * @param tagPath - タグの階層パス
+     * @returns CSS文字列（アイテムがない場合は空文字列）
+     */
+    renderItemsBy(tagPath: string): string;
+    /**
+     * すべてのレイアウトアイテムをCSS文字列として出力する
+     *
+     * position プロパティを含む完全なCSS出力（static 以外）。
+     *
+     * @returns CSS文字列（アイテムがない場合は空文字列）
+     */
+    renderAllItems(): string;
+    private getItemsBy;
+    private getValue;
+    private renderLayoutByRegisteredItem;
+}
+
+/**
+ * スコープドCSSクラス名生成ユーティリティ
+ *
+ * タグパスから決定的なハッシュを生成し、デバッグ可能なユニークCSSクラス名を作成する。
+ * djb2 アルゴリズムによりタグパス全体の衝突耐性を担保しつつ、
+ * タグパスを正規化した人間可読 prefix を組み合わせる。
+ *
+ * ## 出力フォーマット (新フォーマット)
+ *
+ * - 非空 prefix: `_<prefix>__<hash>` (例: `_html-body-div-p-span__a1b2c3d4`)
+ * - 空 prefix:   `_<hash>`           (例: `_a1b2c3d4`)
+ *
+ * prefix は tagPath を lower-case kebab に正規化したもの。最大 32 文字、
+ * 末尾要素を優先して残す。連結子は二重アンダースコア `__`。
+ *
+ * ## 特徴
+ *
+ * - **決定的**: 同じ入力に対して常に同じ出力
+ * - **デバッグ可能**: prefix から元のタグパス末尾を視認できる
+ * - **衝突耐性**: djb2 ハッシュは tagPath 全体に対して計算するため、
+ *   prefix が同一に切り詰まっても全体クラス名は衝突しない
+ *
+ * @module scoped-css-generator
+ */
+/**
+ * djb2ハッシュアルゴリズム
+ *
+ * Dan Bernstein のハッシュ関数。文字列から32ビットの符号なし整数ハッシュを計算し、
+ * 8文字の16進数文字列として返す。
+ *
+ * ## アルゴリズムの詳細
+ *
+ * 1. 初期値 5381 から開始
+ * 2. 各文字に対して: `hash = (hash << 5) + hash + charCode`
+ * 3. 符号なし32ビット整数に変換（`>>> 0`）
+ * 4. 16進数8桁の文字列に変換
+ *
+ * @param str - ハッシュ対象の文字列
+ * @returns 8文字の16進数文字列
+ *
+ * @example
+ * ```ts
+ * djb2Hash('html>body>div');
+ * // → "a1b2c3d4" (例)
+ *
+ * djb2Hash('html>body>span');
+ * // → "e5f6a7b8" (例、異なる値)
+ * ```
+ */
+declare function djb2Hash(str: string): string;
+/**
+ * スコープドCSSクラス名を生成する (新フォーマット)
+ *
+ * tagPath を正規化した prefix と djb2 ハッシュを組み合わせ、
+ * デバッグ可能かつ衝突耐性のあるクラス名を返す。
+ *
+ * ## 出力仕様
+ *
+ * - 非空 prefix: `_<prefix>__<hash>` (例: `_html-body-div-p-span__a1b2c3d4`)
+ * - 空 prefix:   `_<hash>`           (例: `_a1b2c3d4`)
+ *
+ * prefix は最大 32 文字、末尾要素を優先して残す。連結子は二重アンダースコア `__`。
+ * 正規化結果が空文字になった場合は `__` ごと省略し従来形式に縮退する。
+ *
+ * @param tagPath - タグの階層パス（例: 'html>body>div'）
+ * @returns スコープドCSSクラス名
+ *
+ * @example
+ * ```ts
+ * generateScopedClassName('html>body>div>p>span');
+ * // → "_html-body-div-p-span__a1b2c3d4"
+ *
+ * generateScopedClassName('');
+ * // → "_a1b2c3d4" (空 prefix 縮退)
+ *
+ * generateScopedClassName('>>>');
+ * // → "_xxxxxxxx" (全文字無効 → 空 prefix 縮退)
+ * ```
+ */
+declare function generateScopedClassName(tagPath: string, options?: {
+    minify?: boolean;
+}): string;
+
+/**
+ * StyleTemplate デバッグ変数名ラベル付けランタイムヘルパー
+ *
+ * ビルド時トランスフォーマー（AST変換）が `createStyle(...)` 呼び出しを
+ * `__draftole_label__(createStyle(...), '<varName>')` の形にラップするために
+ * 使用するランタイム関数。
+ *
+ * - 渡された値が `StyleTemplate` らしき形状（`_kind === 'styleTemplate'` かつ
+ *   `bodyHash` プロパティを持つ）であれば、`debugVarName` を付与した
+ *   `Object.freeze` 済みコピーを返す。元の `StyleTemplate` は frozen のため
+ *   ミューテートしない。
+ * - それ以外の値（プリミティブ、関数、StyleTemplate 以外のオブジェクトなど）は
+ *   そのまま返す（防御的 no-op）。
+ *
+ * 型シグネチャは `<T>(value: T, debugVarName: string): T` で、型システム上は
+ * identity（透過）として振る舞う。これにより、ラップ前後で型が変化せず、
+ * 既存のコード補完・型推論に影響を与えない。
+ *
+ * @module css/variables/style-template-label
+ */
+/**
+ * StyleTemplate に `debugVarName` を付与するビルド時トランスフォーマー用ラッパー。
+ * StyleTemplate 以外の入力に対しては型透過な identity として動作する。
+ *
+ * @typeParam T - 入力値の型（出力もそのまま `T`）
+ * @param value - ラップ対象の値（通常は `createStyle(...)` の戻り値）
+ * @param debugVarName - 付与するデバッグ用変数名（ビルド時に AST から抽出）
+ * @returns StyleTemplate ならば `debugVarName` を付与した frozen コピー、
+ *          それ以外は `value` をそのまま返す
+ */
+declare function __draftole_label__<T>(value: T, debugVarName: string): T;
+
+/**
+ * 統合 createTheme 実装本体
+ *
+ * フラット入力（string か `Record<string, string>` 値）を受け取り、
+ * エントリ単位で値型から「トークン」「クラス」を自動判別する。
+ * トークンは `:root` ブロック + `var(--name)` プロキシとして、
+ * クラスは `SharedStyle` プロキシとして公開し、`theme.css` で全 CSS を結合した
+ * 単一の `GlobalCss` を返す。
+ *
+ * グローバルルール（`*`、HTMLタグセレクタ）は本ファイルでは扱わず、
+ * 既存 `sel.*` 名前空間で担当する（責任分担）。
+ *
+ * @module css/variables/unified-theme
+ */
+
+/**
+ * 統合 `createTheme` のフラット入力型。
+ * 各エントリの値は string（トークン）または `Record<string, string>`（クラス）。
+ */
+type UnifiedThemeInput = Record<string, string | Record<string, string>>;
+/**
+ * 統合 `createTheme` の戻り値型。
+ *
+ * 入力 `T` の各キーは値型に応じて以下のように振り分けられる:
+ * - `T[K]` が string → `string`（`var(--K)` 参照）
+ * - `T[K]` が `Record<string, string>` → `SharedStyle`
+ *
+ * 加えて全 CSS を結合した `css: GlobalCss` を持つ。
+ */
+type UnifiedTheme<T extends UnifiedThemeInput> = {
+    readonly [K in keyof T as T[K] extends string ? K : never]: string;
+} & {
+    readonly [K in keyof T as T[K] extends Record<string, string> ? K : never]: SharedStyle;
+} & {
+    readonly css: GlobalCss;
+    readonly class: ThemeClassMethod;
+};
+/**
+ * `theme.class` メソッドの呼び出しシグネチャ。
+ *
+ * - 無名形（properties のみ） → `StyleTemplate`
+ * - 無名形 + selectors → `StyleTemplate`
+ * - 明示名形（name + properties + selectors?） → `SharedStyle`
+ */
+type ThemeClassMethod = {
+    (properties: Record<string, string>): StyleTemplate;
+    (properties: Record<string, string>, selectors: StyleSelectors): StyleTemplate;
+    (name: string, properties: Record<string, string>, selectors?: StyleSelectors): SharedStyle;
+};
+
+/**
+ * CSS変数テーマ定義（統合 createTheme の公開シグネチャ）
+ *
+ * 型安全な CSS Custom Properties（CSS変数）と再利用可能なクラスを
+ * 1つのフラットオブジェクトで定義する。値の型から自動的に
+ * 「トークン」「クラス」が判別される。
+ *
+ * 実装本体は `unified-theme.ts` の `buildUnifiedTheme` に委譲する。
+ *
+ * クラス名は HTML タグ名と同名でも CSS セレクタとしては衝突しない
+ * （`.ul` は `ul` セレクタとは別物）。グローバルルール（`*`、HTMLタグセレクタ）
+ * は `sel.*` 名前空間を利用すること。
+ *
+ * @example
+ * ```typescript
+ * // 既存形式（全 string 値）
+ * const theme = createTheme({ bg: '#0b1220', accent: '#7c5cff' });
+ * theme.bg     // → 'var(--bg)'
+ * theme.css    // → ':root { --bg: #0b1220; --accent: #7c5cff; }'
+ *
+ * // 統合形式（混在入力）
+ * const t = createTheme({
+ *   bg: '#000',
+ *   card: { background: 'bg', padding: '12px' },
+ * });
+ * t.bg         // → 'var(--bg)'
+ * t.card       // → SharedStyle
+ * t.css        // → ':root { ... }\n\n.card { background: var(--bg); padding: 12px; }'
+ * ```
+ */
+
+/**
+ * Theme type: each key maps to its var(--key) reference,
+ * plus a .css property for the :root block.
+ *
+ * 既存形式（全 string 入力）の戻り値型として維持。
+ */
+type Theme<T extends Record<string, string>> = {
+    readonly [K in keyof T]: string;
+} & {
+    /** The :root { ... } CSS block with all variable definitions. */
+    readonly css: GlobalCss;
+};
+
+/**
+ * Global CSS DSL — セレクタ系・at-rule 系ファクトリ関数
+ *
+ * `root` / `all` / `tag` / `rule` / `media` / `keyframes` の 6関数を提供する。
+ * 各関数は内部ヘルパを経由して `GlobalCss` branded type を生成する。
+ * `brand()` の呼び出しは `selectorRule` / at-rule 各生成箇所に限定し、キャスト漏れを防ぐ。
+ *
+ * @module global-dsl
+ */
+
+type Properties = Record<string, string>;
+/**
+ * `:root { ... }` ブロックを生成する。
+ * CSS カスタムプロパティ（CSS 変数）の定義に用いる。
+ *
+ * @example
+ * root({ '--bg': '#0b1220', '--fg': '#fff' })
+ * // → ":root {\n  --bg: #0b1220;\n  --fg: #fff;\n}"
+ */
+/**
+ * @internal 公開 API ではない（1.0.0 で公開面から除去済み）。利用者は `css.theme` の token エントリ、
+ * または最終手段として `css.raw` を使うこと。本関数は `sel.root` の実装基盤として内部実装で継続使用される。
+ * 詳細は [docs/deprecation-policy.md](../../../docs/deprecation-policy.md) 参照。
+ */
+declare function root(properties: Properties): GlobalCss;
+/**
+ * `* { ... }` ブロックを生成する。
+ * 全要素へのリセットスタイル等に用いる。
+ *
+ * @example
+ * all({ boxSizing: 'border-box' })
+ * // → "* {\n  box-sizing: border-box;\n}"
+ */
+/**
+ * @internal 公開 API ではない（1.0.0 で公開面から除去済み）。利用者は `css.reset` を使うこと
+ * （最終手段として `css.raw`）。本関数は `sel.all` の実装基盤として内部実装で継続使用される。
+ * 詳細は [docs/deprecation-policy.md](../../../docs/deprecation-policy.md) 参照。
+ */
+declare function all(properties: Properties): GlobalCss;
+/**
+ * HTML タグセレクタブロックを生成する。
+ * `name` は `HTMLElementTagNameMap` のキーに対してリテラル補完が効き、
+ * かつ任意の文字列も受け付ける（`string & {}` パターン）。
+ *
+ * @example
+ * tag('ul', { listStyle: 'none', margin: '0' })
+ * // → "ul {\n  list-style: none;\n  margin: 0;\n}"
+ */
+/**
+ * @internal 公開 API ではない（1.0.0 で公開面から除去済み）。利用者は要素単位クラス合成
+ * （`css.class` + `el.<tag>({ css: ... })`）を使うこと（最終手段として `css.raw`）。
+ * 本関数は `sel.tag` および per-tag shortcuts（`tag-dsl.generated.ts`）の実装基盤として内部実装で継続使用される。
+ * 詳細は [docs/deprecation-policy.md](../../../docs/deprecation-policy.md) 参照。
+ */
+declare function tag(name: keyof HTMLElementTagNameMap | (string & {}), properties: Properties): GlobalCss;
+/**
+ * 任意セレクタブロックを生成する（脱出ハッチ）。
+ * 疑似クラス・疑似要素・複合セレクタなど、専用関数では表現できないセレクタに使用する。
+ * セレクタ文字列の構文検証は行わない（ランタイム no-op）。
+ *
+ * @example
+ * rule('.foo:hover', { color: 'red' })
+ * // → ".foo:hover {\n  color: red;\n}"
+ */
+/**
+ * @internal 公開 API ではない（1.0.0 で公開面から除去済み）。利用者は `css.raw` または要素単位クラス合成
+ * （`css.class`）を使うこと。本関数は `sel.rule` の実装基盤として内部実装で継続使用される。
+ * 詳細は [docs/deprecation-policy.md](../../../docs/deprecation-policy.md) 参照。
+ */
+declare function rule(selector: string, properties: Properties): GlobalCss;
+/**
+ * `@media (query) { ... }` ブロックを生成する。
+ * 各 `GlobalCss` のすべての行に2スペースのインデントを付与し、
+ * ルール間は空行（`\n\n`）で区切る。
+ *
+ * @example
+ * media("(min-width: 768px)", [tag("body", { fontSize: "18px" })])
+ * // → "@media (min-width: 768px) {\n  body {\n    font-size: 18px;\n  }\n}"
+ *
+ * @param query - メディアクエリ文字列（括弧付き or なし）
+ * @param rules - 内包する GlobalCss ルール配列
+ */
+declare function media(query: string, rules: readonly GlobalCss[]): GlobalCss;
+/**
+ * フレームキーセレクタ型。`from` / `to` または `${number}%` を受け付ける。
+ */
+type KeyframeSelector = 'from' | 'to' | `${number}%`;
+/**
+ * `@keyframes name { ... }` ブロックを生成する。
+ * 各フレームの宣言を `renderProperties` で整形し、2スペースインデント付きブロックで展開する。
+ *
+ * @example
+ * keyframes("fadeIn", { from: { opacity: "0" }, to: { opacity: "1" } })
+ * // → "@keyframes fadeIn {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 1;\n  }\n}"
+ *
+ * @param name - アニメーション名
+ * @param frames - フレームキーと CSS プロパティのマップ
+ */
+declare function keyframes(name: string, frames: Partial<Record<KeyframeSelector, Properties>>): GlobalCss;
+
+/**
+ * `css` ネームスペース — CSS 関連 API の単一エントリポイント。
+ *
+ * 既存の `createTheme` / `createStyle` / `sel.media` / `sel.keyframes` への
+ * 薄いエイリアスと、新規 `theme.variant` / `reset` / `raw` を集約する。
+ *
+ * @module css/css
+ */
+
+/**
+ * 生 CSS 文字列を `GlobalCss` ブランド型にラップする escape hatch。
+ *
+ * 他 `css.*` で書けない場合の **最終手段**。サニタイズや検証は行わず、
+ * 入力文字列の安全性はユーザの責任に委ねる。
+ *
+ * @param cssString - 任意の CSS 文字列（そのまま `GlobalCss` として返る）
+ */
+declare function cssRaw(cssString: string): GlobalCss;
+/**
+ * リセット CSS を生成する。
+ *
+ * - 引数なし → デフォルト（`* { box-sizing: border-box; }` + `body { margin: 0; }`）
+ * - `Record<string, string>` → `* { <props> }`
+ * - `SharedStyle` / `StyleTemplate` → `properties` を抽出し `* { <props> }`
+ *
+ * 値は `sanitizeCssValue` でサニタイズされる。
+ */
+declare function cssReset(): GlobalCss;
+declare function cssReset(properties: Record<string, string>): GlobalCss;
+declare function cssReset(style: SharedStyle | StyleTemplate): GlobalCss;
+/**
+ * 入力 `T` から token キー（値が string であるキー）のみを抽出する補助型。
+ */
+type TokenKeysOf<T> = {
+    [K in keyof T as T[K] extends string ? K : never]: string;
+};
+declare function variant<T extends UnifiedThemeInput>(_theme: UnifiedTheme<T>, selector: string, overrides: Partial<TokenKeysOf<T>>): GlobalCss;
+interface CssThemeFn {
+    <T extends Record<string, string>>(vars: T): Theme<T>;
+    <T extends UnifiedThemeInput>(input: T): UnifiedTheme<T>;
+    variant: <T extends UnifiedThemeInput>(theme: UnifiedTheme<T>, selector: string, overrides: Partial<TokenKeysOf<T>>) => GlobalCss;
+}
+interface CssClassFn {
+    (name: string, properties: Record<string, string>, selectors?: StyleSelectors): SharedStyle;
+    (properties: Record<string, string>, selectors?: StyleSelectors): StyleTemplate;
+}
+/**
+ * CSS 関連 API を集約した単一ネームスペース。
+ *
+ * - `css.theme(input)` — トークン + クラス定義（既存 `createTheme` のエイリアス）
+ * - `css.theme.variant(theme, selector, overrides)` — トークン属性スコープ上書き
+ * - `css.class(name?, properties, selectors?)` — 名前あり/無名クラス（既存 `createStyle`）
+ * - `css.reset(input?)` — リセット CSS
+ * - `css.media(query, rules)` — `@media` ブロック（既存 `sel.media`）
+ * - `css.keyframes(name, frames)` — `@keyframes` ブロック（既存 `sel.keyframes`）
+ * - `css.raw(cssString)` — 生 CSS の escape hatch
+ */
+declare const css: {
+    readonly theme: CssThemeFn & {
+        variant: typeof variant;
+    };
+    readonly class: CssClassFn;
+    readonly reset: typeof cssReset;
+    readonly media: typeof media;
+    readonly keyframes: typeof keyframes;
+    readonly raw: typeof cssRaw;
+};
+
+/**
+ * JQueryManager - 要素ごとのjQuery風JavaScript操作を蓄積・生成
+ *
+ * DraftOleのHTML要素に対してjQuery風のDOM操作を記録し、
+ * JavaScript文字列として出力するマネージャークラスです。
+ *
+ * @remarks
+ * - 各メソッドは操作をキューに追加し、render()で全操作を出力
+ * - usedMethodsプロパティで使用されたメソッドを追跡（tree-shaking用）
+ * - メソッドチェーンの代わりに、連続呼び出しで操作を蓄積
+ * - Swift版JQueryManagerと互換性のある動作を実現
+ *
+ * @example 基本的な使用方法
+ * ```typescript
+ * const jqm = new JQueryManager('root-0-html-0-body');
+ * jqm.css({ 'font-size': '10px' });
+ * jqm.text('Hello World');
+ * jqm.addClass('active');
+ *
+ * const js = jqm.render();
+ * // → "$('.root-0-html-0-body').css({'font-size': '10px'});\n..."
+ * ```
+ *
+ * @example tree-shaking用のメソッド追跡
+ * ```typescript
+ * const jqm = new JQueryManager('element');
+ * jqm.css({ color: 'blue' });
+ * jqm.text('Text');
+ *
+ * const methods = jqm.usedMethods;
+ * // → Set { 'css', 'text' }
+ *
+ * // JQueryHelperと組み合わせて最小限の$()関数を生成
+ * const helper = JQueryHelper.generateHelper(methods);
+ * ```
+ *
+ * @example イベントハンドリング
+ * ```typescript
+ * const jqm = new JQueryManager('button-element');
+ * jqm.click('handleClick');
+ * jqm.keydown('handleKeyDown');
+ *
+ * console.log(jqm.render());
+ * // → "$('.button-element').on('click', handleClick);\n$('.button-element').on('keydown', handleKeyDown)"
+ * ```
+ *
+ * @example パスの動的更新
+ * ```typescript
+ * const jqm = new JQueryManager('old-path');
+ * jqm.css({ color: 'red' });
+ *
+ * jqm.updatePath('new-path');
+ * jqm.text('Updated');
+ *
+ * // 既存の操作は古いパスを保持し、新しい操作は新しいパスを使用
+ * ```
+ *
+ * @public
+ */
+declare class JQueryManager implements JQueryManagerInstance {
+    private _path;
+    private readonly _content;
+    private readonly _usedMethods;
+    constructor(path?: string);
+    get path(): string;
+    get usedMethods(): ReadonlySet<JQueryMethodType>;
+    /**
+     * CSSプロパティ操作のJS文を生成
+     * @param properties - CSS propertyのキーバリューマップ
+     * @returns 生成されたJS文字列
+     */
+    css(properties: Record<string, string>): string;
+    /**
+     * 高さ操作のJS文を生成
+     * @param value - 高さの値
+     * @param unit - 単位（'px', 'vh'等、指定しない場合は数値のみ）
+     * @returns 生成されたJS文字列
+     */
+    height(value: number, unit?: string): string;
+    /**
+     * 汎用イベントバインディングのJS文を生成
+     * @param eventType - イベント種別（'click', 'keydown'等）
+     * @param handler - ハンドラ関数名
+     * @returns 生成されたJS文字列（空ハンドラの場合は空文字列）
+     */
+    on(eventType: string, handler: string): string;
+    /**
+     * clickイベントハンドラのJS文を生成
+     * @param handler - ハンドラ関数名
+     * @returns 生成されたJS文字列
+     */
+    click(handler: string): string;
+    /**
+     * keydownイベントハンドラのJS文を生成
+     * @param handler - ハンドラ関数名
+     * @returns 生成されたJS文字列
+     */
+    keydown(handler: string): string;
+    /**
+     * keyupイベントハンドラのJS文を生成
+     * @param handler - ハンドラ関数名
+     * @returns 生成されたJS文字列
+     */
+    keyup(handler: string): string;
+    /**
+     * テキストコンテンツ操作のJS文を生成
+     * @param value - テキスト値または変数名
+     * @param isVariable - trueの場合、変数名として扱う（クォートなし）
+     * @returns 生成されたJS文字列
+     */
+    text(value: string, isVariable?: boolean): string;
+    /**
+     * innerHTML操作のJS文を生成
+     * @param value - HTML文字列
+     * @returns 生成されたJS文字列
+     */
+    html(value: string): string;
+    /**
+     * クラス追加のJS文を生成
+     * @param className - 追加するクラス名
+     * @returns 生成されたJS文字列
+     */
+    addClass(className: string): string;
+    /**
+     * クラス削除のJS文を生成
+     * @param className - 削除するクラス名
+     * @returns 生成されたJS文字列
+     */
+    removeClass(className: string): string;
+    /**
+     * クラストグルのJS文を生成
+     * @param className - トグルするクラス名
+     * @param force - true/falseで強制的に追加/削除
+     * @returns 生成されたJS文字列
+     */
+    toggleClass(className: string, force?: boolean): string;
+    /**
+     * ヘルパー関数が必要かどうかを判定
+     * @returns usedMethodsが空でない場合true
+     */
+    needsHelper(): boolean;
+    /**
+     * パスを更新
+     * @param newPath - 新しいCSSセレクタパス
+     */
+    updatePath(newPath: string): void;
+    /**
+     * 蓄積されたJS文を ";\n" で結合して返す
+     * @returns 統合されたJavaScript文字列（空の場合は空文字列）
+     */
+    render(): string;
+}
+
+/**
+ * JQueryHelper - Tree-shaking対応の$()ヘルパー関数生成
+ *
+ * 使用されたjQueryメソッドのみを含む最小限の$()関数を生成し、
+ * バンドルサイズを最適化します。
+ *
+ * @remarks
+ * DraftOleの主要な機能の一つである**tree-shaking**を実現します。
+ * JQueryManagerで使用されたメソッドのみを含む軽量な$()関数を動的に生成し、
+ * 未使用のメソッドを含まないことでJavaScriptファイルサイズを削減します。
+ *
+ * ### Tree-shakingの仕組み
+ * 1. {@link JQueryManager}が使用されたメソッドを`usedMethods`として追跡
+ * 2. `JQueryHelper.generateHelper(usedMethods)`で必要なメソッドのみを含む$()関数を生成
+ * 3. 出力されるJavaScriptは使用されたメソッドのみを含む
+ *
+ * ### jQueryとの違い
+ * - フルサイズのjQueryライブラリ（約90KB minified）を避ける
+ * - プロジェクトで実際に使用されるメソッドのみを含む（通常1-5KB）
+ * - 依存関係なしで動作（Pure JavaScript）
+ *
+ * @example 基本的な使用方法
+ * ```typescript
+ * const usedMethods = new Set(['css', 'text', 'addClass']);
+ * const helper = JQueryHelper.generateHelper(usedMethods);
+ * // → css, text, addClassメソッドのみを持つ$()関数のJS文字列
+ * ```
+ *
+ * @example JQueryManagerと組み合わせたtree-shaking
+ * ```typescript
+ * // 1. JQueryManagerで操作を記録
+ * const jqm = new JQueryManager('my-element');
+ * jqm.css({ color: 'red' });
+ * jqm.addClass('active');
+ *
+ * // 2. 使用されたメソッドを取得
+ * const usedMethods = jqm.usedMethods;
+ * // → Set { 'css', 'addClass' }
+ *
+ * // 3. 必要最小限の$()関数を生成
+ * const helper = JQueryHelper.generateHelper(usedMethods);
+ *
+ * // 4. 出力されるJavaScriptにはcssとaddClassのみが含まれる
+ * // text, html, removeClassなどの未使用メソッドは含まれない
+ * ```
+ *
+ * @example 複数のマネージャーからメソッドを集約
+ * ```typescript
+ * const managers = [
+ *   new JQueryManager('element1'),
+ *   new JQueryManager('element2'),
+ *   new JQueryManager('element3'),
+ * ];
+ *
+ * managers[0].css({ color: 'red' });
+ * managers[1].text('Hello');
+ * managers[2].addClass('active');
+ *
+ * // 全マネージャーの使用メソッドを集約
+ * const allMethods = new Set<JQueryMethodType>();
+ * managers.forEach(m => {
+ *   m.usedMethods.forEach(method => allMethods.add(method));
+ * });
+ *
+ * // 全体で使用されたメソッドのみを含む$()関数を生成
+ * const helper = JQueryHelper.generateHelper(allMethods);
+ * ```
+ *
+ * @example querySelectorAllサポート（$$.all）
+ * ```typescript
+ * const usedMethods = new Set(['css', 'addClass']);
+ * const helper = JQueryHelper.generateHelperWithAll(usedMethods);
+ *
+ * // 生成されるコードの例:
+ * // function $(...) { ... }
+ * // const $$ = { all(selector) { return Array.from(document.querySelectorAll(selector)); } };
+ * ```
+ *
+ * @public
+ */
+declare class JQueryHelper {
+    /**
+     * 使用メソッドのみを含む$()ヘルパー関数を生成
+     *
+     * @param methods - 使用するJQueryMethodTypeのSet
+     * @returns 生成されたJavaScript文字列（空Setの場合は空文字列）
+     *
+     * @remarks
+     * 生成される$()関数は以下の特徴を持ちます:
+     * - セレクタ文字列またはDOM要素を受け取る
+     * - 指定されたメソッドのみを実装（未使用メソッドは含まれない）
+     * - null要素に対しても安全に動作（メソッドチェーンを壊さない）
+     * - メソッドチェーンをサポート（各メソッドはthisを返す）
+     *
+     * @example 最小限のバンドル（css, textのみ）
+     * ```typescript
+     * const methods = new Set(['css', 'text']);
+     * const helper = JQueryHelper.generateHelper(methods);
+     *
+     * // 生成されるコード（簡略版）:
+     * // function $(selectorOrEl) {
+     * //   const el = typeof selectorOrEl === "string" ? document.querySelector(selectorOrEl) : selectorOrEl;
+     * //   return {
+     * //     css(props) { ... },
+     * //     text(value) { ... }
+     * //   };
+     * // }
+     * ```
+     *
+     * @example 空のSet（メソッド未使用時）
+     * ```typescript
+     * const methods = new Set<JQueryMethodType>();
+     * const helper = JQueryHelper.generateHelper(methods);
+     * console.log(helper); // → ""（空文字列）
+     * ```
+     *
+     * @public
+     */
+    static generateHelper(methods: ReadonlySet<JQueryMethodType>): string;
+    /**
+     * $()関数に加えて$$.all()関数も生成
+     *
+     * @param methods - 使用するJQueryMethodTypeのSet
+     * @returns 生成されたJavaScript文字列（空Setの場合は空文字列）
+     *
+     * @remarks
+     * `generateHelper()`に加えて、`$$.all(selector)`ヘルパーを追加します。
+     * `$$.all()`は`document.querySelectorAll()`のラッパーで、配列として結果を返します。
+     *
+     * @example 複数要素の一括操作
+     * ```typescript
+     * const methods = new Set(['addClass']);
+     * const helper = JQueryHelper.generateHelperWithAll(methods);
+     *
+     * // 生成されるコード（簡略版）:
+     * // function $(...) { ... }
+     * // const $$ = {
+     * //   all(selector) {
+     * //     return Array.from(document.querySelectorAll(selector));
+     * //   }
+     * // };
+     *
+     * // 使用例:
+     * // $$.all('.item').forEach(el => $(el).addClass('active'));
+     * ```
+     *
+     * @public
+     */
+    static generateHelperWithAll(methods: ReadonlySet<JQueryMethodType>): string;
+}
+
+/**
+ * jsTemplate: HTMLTagProtocol ツリーから DOM 生成 JavaScript コードを生成する
+ *
+ * param() でマーカーオブジェクトを作成し、jsTemplate() でタグツリーを走査して
+ * document.createElement / appendChild を使った JS 関数コードを出力する。
+ */
+
+/**
+ * JsParam マーカーオブジェクトを作成する。
+ *
+ * jsTemplate() に渡すタグツリー内の属性値として使用することで、
+ * 生成される JS コード内で文字列リテラルではなく変数参照になる。
+ *
+ * @param name - JS 関数の引数名
+ * @returns JsParam マーカーオブジェクト
+ *
+ * @example
+ * ```typescript
+ * const result = jsTemplate('createLabel', ['text'],
+ *   span({ textContent: param('text') })
+ * );
+ * result.render();
+ * // → "el0.textContent = text;" (クォートなし)
+ * ```
+ */
+declare function param(name: string): JsParam;
+/**
+ * jsTemplate() の戻り値。name・params・render() を持つ。
+ */
+interface JsTemplateResult {
+    /** 生成する JS 関数名 */
+    readonly name: string;
+    /** JS 関数の引数名リスト */
+    readonly params: readonly string[];
+    /** JS コード文字列を生成する */
+    render(): string;
+}
+/**
+ * HTMLTagProtocol タグツリーから DOM 生成 JS 関数を生成する。
+ *
+ * @param name - 生成する JS 関数名
+ * @param params - 関数引数名のリスト
+ * @param rootElement - DraftOle タグツリーのルート要素
+ * @param afterCreate - オプション。{ jsName: varName } のマップを受け取り
+ *   return 文の直前に挿入する生 JS コードを返すコールバック
+ * @returns render() メソッドを持つ JsTemplateResult
+ *
+ * @example
+ * ```typescript
+ * const result = jsTemplate('createBox', [], div({ className: 'box' }));
+ * console.log(result.render());
+ * // function createBox() {
+ * //   const el0 = document.createElement("div");
+ * //   el0.className = "box";
+ * //   return el0;
+ * // }
+ * ```
+ */
+declare function jsTemplate(name: string, params: string[], rootElement: HTMLTagProtocol, afterCreate?: (refs: Record<string, string>) => string): JsTemplateResult;
+
+/**
+ * `ElementRef` / `ElementListRef` と生成関数 (`ref` / `fromSelector` / `fromExpr`)、
+ * および `JsExpr` チェーンヘルパ（`eq` / `ne` / `or` / `trim` / `isFalsy` / `isTruthy`）の実装。
+ *
+ * 設計書 `design.md` の「element-ref」「types: JsExpr / JsBoolExpr」節に対応。
+ * 値オブジェクトとして扱い、メソッドは新しいオブジェクトを返す純関数。
+ */
+
+/**
+ * `jsName` 由来の変数名（または既に存在する JS 識別子）を指す `ElementRef` を生成する。
+ *
+ * @param varName - JS 識別子として有効な名前（空文字・無効識別子は `Error`）。
+ * @returns `kind: 'var'`、`code === varName` の新しい `ElementRef`。
+ * @throws 空文字・無効 JS 識別子のとき `Error`。
+ */
+declare function ref<E extends Element = HTMLElement>(varName: string): ElementRef<E>;
+
+/**
+ * トランスフォーマーなし環境でイベントハンドラを定義するユーティリティ。
+ *
+ * `.on()` に渡すハンドラの定形パターンをライブラリ側で吸収する。
+ * トランスフォーマー使用時は不要（自動変換される）。
+ *
+ * @example
+ * button.on('click', emitHandler(`__draftole__.state('${id}').set([])`))
+ */
+declare function emitHandler(code: string, params?: readonly string[]): ((s: ScriptScope) => void) & {
+    _draftoleEmitted: true;
+};
+
+/**
+ * MVP-3.3: DOMContentLoaded ラッパー
+ *
+ * JS コードを document.addEventListener("DOMContentLoaded", ...) でラップする。
+ * 既にラップ済みの場合は二重ラップしない。
+ */
+/**
+ * JS コードを DOMContentLoaded イベントリスナーでラップする。
+ * 空文字列や既にラップ済みのコードはそのまま返す。
+ */
+declare function wrapDOMReady(js: string): string;
+
+/**
+ * ファイルエクスポート時のエラー
+ *
+ * {@link FileExporter}でのファイル書き込み失敗時にスローされる専用エラークラスです。
+ *
+ * @remarks
+ * {@link DraftOleError}を継承し、DraftOleのエラー型階層に統合されています（タスク3.3）。
+ * エラーコードとファイルパスを保持し、デバッグを容易にします。
+ *
+ * ### エラーコード
+ * - `invalidPath`: 出力パスが空または無効
+ * - `writeFailed`: ファイル書き込みまたはディレクトリ作成失敗
+ *
+ * ### プロパティ
+ * - `code`: {@link ExportableErrorCode} - エラーの種類を識別
+ * - `module`: 常に `'publisher'` - エラーが発生したモジュール
+ * - `filePath`: エラーが発生したファイルパス
+ * - `message`: エラーメッセージ（カスタマイズ可能）
+ *
+ * @example 基本的なスロー
+ * ```typescript
+ * throw new ExportableError('writeFailed', '/output/file.html', 'Disk full');
+ * ```
+ *
+ * @example エラーコードによるハンドリング
+ * ```typescript
+ * try {
+ *   exporter.export(html, css, js, '');
+ * } catch (error) {
+ *   if (error instanceof ExportableError) {
+ *     switch (error.code) {
+ *       case 'invalidPath':
+ *         console.error('Please provide a valid output path');
+ *         break;
+ *       case 'writeFailed':
+ *         console.error('Failed to write files:', error.message);
+ *         console.error('Target path:', error.filePath);
+ *         break;
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example デフォルトメッセージ
+ * ```typescript
+ * // カスタムメッセージを省略した場合
+ * throw new ExportableError('invalidPath', '/output');
+ * // → message: 'ExportableError [invalidPath]: Failed to process file at "/output"'
+ * ```
+ *
+ * @example DraftOleErrorとしてキャッチ
+ * ```typescript
+ * try {
+ *   exporter.export(html, css, js, outputPath);
+ * } catch (error) {
+ *   if (error instanceof DraftOleError) {
+ *     console.error(`Module: ${error.module}`);
+ *     console.error(`Error: ${error.message}`);
+ *
+ *     // ExportableErrorの場合のみ追加情報を表示
+ *     if (error instanceof ExportableError) {
+ *       console.error(`Code: ${error.code}`);
+ *       console.error(`File: ${error.filePath}`);
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example ログ記録
+ * ```typescript
+ * function logExportError(error: ExportableError): void {
+ *   const logEntry = {
+ *     timestamp: new Date().toISOString(),
+ *     module: error.module,
+ *     code: error.code,
+ *     filePath: error.filePath,
+ *     message: error.message,
+ *     stack: error.stack,
+ *   };
+ *   console.error(JSON.stringify(logEntry, null, 2));
+ * }
+ * ```
+ *
+ * @public
+ */
+declare class ExportableError extends DraftOleError {
+    /**
+     * Publisher エラーコード
+     */
+    readonly code: ExportableErrorCode;
+    /**
+     * エラーが発生したモジュール（常に 'publisher'）
+     */
+    readonly module: "publisher";
+    /**
+     * エラーが発生したファイルパス
+     */
+    readonly filePath: string;
+    /**
+     * ExportableError のコンストラクタ
+     *
+     * @param code - エラーコード
+     * @param filePath - エラーが発生したファイルパス
+     * @param message - カスタムエラーメッセージ（オプション）
+     */
+    constructor(code: ExportableErrorCode, filePath: string, message?: string);
+}
+
+/**
+ * layout-factories.ts
+ *
+ * SwiftUI ライクなレイアウトコンテナファクトリ関数。
+ * hstack / vstack / zstack / spacer / divider を提供する。
+ *
+ * Requirements: 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.1, 2.2, 2.3, 2.4, 3.1, 3.2, 3.3, 3.4,
+ *               4.1, 4.2, 4.3, 4.4, 5.1, 5.2, 5.3, 5.4
+ */
+
+/**
+ * 水平スタックコンテナ（display: flex; flex-direction: row）を生成するファクトリ。
+ *
+ * **呼び出しパターン:**
+ * ```typescript
+ * hstack()                                // 空コンテナ
+ * hstack(child1, child2)                  // 子要素のみ
+ * hstack({ spacing: 12 })                 // オプションのみ
+ * hstack({ spacing: 8, alignment: 'center' }, child1, child2) // オプション + 子要素
+ * ```
+ *
+ * **生成 CSS:**
+ * - `display: flex; flex-direction: row`
+ * - `spacing` → `gap: {n}px`
+ * - `alignment` → `align-items: {value}`
+ * - `wrap: true` → `flex-wrap: wrap`
+ *
+ * Requirements: 1.1, 1.2, 1.3, 1.4, 1.5, 1.6
+ *
+ * @param optionsOrChild - StackOptions または最初の子要素（省略可）
+ * @param children - 追加の子要素
+ * @returns display:flex; flex-direction:row が設定された PairType
+ */
+declare function hstack(optionsOrChild?: StackOptions | LayoutChild, ...children: LayoutChild[]): PairType;
+/**
+ * 垂直スタックコンテナ（display: flex; flex-direction: column）を生成するファクトリ。
+ *
+ * **呼び出しパターン:**
+ * ```typescript
+ * vstack()                                // 空コンテナ
+ * vstack(child1, child2)                  // 子要素のみ
+ * vstack({ spacing: 14 })                 // オプションのみ
+ * vstack({ spacing: 8, alignment: 'center' }, child1, child2) // オプション + 子要素
+ * ```
+ *
+ * **生成 CSS:**
+ * - `display: flex; flex-direction: column`
+ * - `spacing` → `gap: {n}px`
+ * - `alignment` → `align-items: {value}`
+ * - `wrap: true` → `flex-wrap: wrap`
+ *
+ * Requirements: 2.1, 2.2, 2.3, 2.4
+ *
+ * @param optionsOrChild - StackOptions または最初の子要素（省略可）
+ * @param children - 追加の子要素
+ * @returns display:flex; flex-direction:column が設定された PairType
+ */
+declare function vstack(optionsOrChild?: StackOptions | LayoutChild, ...children: LayoutChild[]): PairType;
+/**
+ * 重ね合わせスタックコンテナ（CSS Grid overlap 方式）を生成するファクトリ。
+ *
+ * **呼び出しパターン:**
+ * ```typescript
+ * zstack()                                    // 空コンテナ（デフォルト: center/center）
+ * zstack(child1, child2)                      // 子要素のみ
+ * zstack({ alignment: 'topLeading' })         // オプションのみ
+ * zstack({ alignment: 'center' }, child1)     // オプション + 子要素
+ * ```
+ *
+ * **生成 CSS:**
+ * - `display: grid`
+ * - `grid-template-areas: "stack"`
+ * - `grid-template-rows: 1fr`
+ * - `grid-template-columns: 1fr`
+ * - `align-items: center`（デフォルト）
+ * - `justify-content: center`（デフォルト）
+ *
+ * **注意:** 子要素への `grid-area: stack` の自動適用は行わない。
+ *
+ * Requirements: 3.1, 3.2, 3.3, 3.4
+ *
+ * @param optionsOrChild - ZStackOptions または最初の子要素（省略可）
+ * @param children - 追加の子要素
+ * @returns CSS Grid overlap が設定された PairType
+ */
+declare function zstack(optionsOrChild?: ZStackOptions | LayoutChild, ...children: LayoutChild[]): PairType;
+/**
+ * フレキシブルスペーサー（flex:1 1 auto）を生成するファクトリ。
+ *
+ * **呼び出しパターン:**
+ * ```typescript
+ * spacer()                    // flex:1 1 auto のみ
+ * spacer({ minLength: 8 })    // flex:1 1 auto; min-width:8px
+ * ```
+ *
+ * **生成 CSS:**
+ * - `flex: 1 1 auto`
+ * - `minLength` → `min-width: {n}px`
+ *
+ * Requirements: 4.1, 4.2, 4.3, 4.4
+ *
+ * @param options - SpacerOptions（省略可）
+ * @returns flex:1 1 auto が設定された PairType
+ */
+declare function spacer(options?: SpacerOptions): PairType;
+/**
+ * 区切り線（水平または垂直）を生成するファクトリ。
+ *
+ * **呼び出しパターン:**
+ * ```typescript
+ * divider()               // 水平区切り線（デフォルト）
+ * divider('horizontal')   // 水平区切り線
+ * divider('vertical')     // 垂直区切り線
+ * ```
+ *
+ * **生成 CSS:**
+ * - 水平: `height:1px; background:currentColor; opacity:0.15; width:100%`
+ * - 垂直: `width:1px; background:currentColor; opacity:0.15; align-self:stretch`
+ *
+ * Requirements: 5.1, 5.2, 5.3, 5.4
+ *
+ * @param direction - 'horizontal'（デフォルト）または 'vertical'
+ * @returns 区切り線 CSS が設定された PairType
+ */
+declare function divider(direction?: 'horizontal' | 'vertical'): PairType;
+
+declare const sel: {
+    readonly tagA: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagAbbr: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagAddress: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagArea: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagArticle: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagAside: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagAudio: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagB: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagBase: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagBdi: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagBdo: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagBlockquote: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagBody: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagBr: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagButton: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagCanvas: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagCaption: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagCite: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagCode: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagCol: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagColgroup: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagData: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDatalist: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDd: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDel: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDetails: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDfn: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDialog: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDiv: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDl: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagDt: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagEm: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagEmbed: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagFieldset: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagFigcaption: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagFigure: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagFooter: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagForm: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagH1: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagH2: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagH3: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagH4: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagH5: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagH6: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagHead: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagHeader: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagHgroup: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagHr: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagHtml: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagI: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagIframe: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagImg: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagInput: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagIns: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagKbd: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagLabel: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagLegend: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagLi: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagLink: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagMain: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagMap: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagMark: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagMenu: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagMeta: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagMeter: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagNav: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagNoscript: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagObject: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagOl: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagOptgroup: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagOption: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagOutput: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagP: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagPicture: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagPre: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagProgress: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagQ: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagRp: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagRt: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagRuby: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagS: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSamp: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagScript: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSearch: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSection: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSelect: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSlot: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSmall: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSource: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSpan: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagStrong: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagStyle: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSub: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSummary: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagSup: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTable: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTbody: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTd: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTemplate: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTextarea: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTfoot: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTh: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagThead: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTime: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTitle: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTr: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagTrack: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagU: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagUl: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagVar: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagVideo: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly tagWbr: (properties: {
+        [x: string]: string;
+    }) => GlobalCss;
+    readonly root: typeof root;
+    readonly all: typeof all;
+    readonly tag: typeof tag;
+    readonly rule: typeof rule;
+    readonly media: typeof media;
+    readonly keyframes: typeof keyframes;
+};
+
+export { ARIA_ATTRIBUTE_KEYS, type AriaAttributeKey, type AttributeBuilderProtocol, type AttributeMap, BOOLEAN_ATTRIBUTE_KEYS, BUTTON_TYPES, BaseAttributeBuilder, type BooleanAttributeKey, ButtonAttributeBuilder, type ButtonType, CSSPropertyKey, type ChildArg, CssConfig, type CssErrorCode, CssLayoutBuilder, CssManager, CssManagerInstance, CssPlaceDescription, CssPositionMaker, CssPositionMakerType, CssStyleManager, CssStyleManagerType, DefaultCssManager, DraftOleError, type DraftOleErrorCode, DuplicateCssPropertyError, ExportableError, type ExportableErrorCode, FormAttributeBuilder, GlobalCss, HTMLFormatter, HTMLTagProtocol, HlUnit, HtmlAttribute, type HtmlAttributeManagerProtocol, HtmlAttributeShape, HtmlAttributeValue, type HtmlErrorCode, HtmlStyle, HtmlTag, HtmlTagOptions, INPUT_TYPES, ImageAttributeBuilder, InputAttributeBuilder, type InputType, JQueryHelper, JQueryManager, JQueryManagerInstance, JQueryMethodType, type JsErrorCode, type JsParam, type JsTemplateResult, KEY_VALUE_ATTRIBUTE_KEYS, type KeyValueAttributeKey, LayoutChild, LayoutRegisteredItem, LazyLayoutManager, LazyLayoutRegister, LinkAttributeBuilder, PairType, RelationShip, ScriptScope, SelfClosingType, SharedStyle, SpacerOptions, StackOptions, type TagGenerateProtocol, TagType, Text, TextType, type Theme, type UnifiedTheme, type UnifiedThemeInput, ZStackOptions, __draftole_label__, a, abbr, address, area, article, aside, audio, b, base, blockquote, body, br, button, canvas, caption, cite, code, col, colgroup, css, datalist, dd, details, dialog, div, divider, djb2Hash, dl, dt, tags as el, em, embed, emitHandler, escapeHtml, fieldset, figcaption, figure, footer, form, generateScopedClassName, guardDuplicateCssProperty, h1, h2, h3, h4, h5, h6, head, header, hr, hstack, html, i, iframe, img, input, isJsParam, jsTemplate, kbd, keyframes, label, legend, li, link, main, mark, media, meta, nav, normalizeClassNames, noscript, ol, optgroup, option, output, p, param, picture, pre, q, ref, s, samp, script, section, sel, select, small, source, spacer, span, strong, sub, summary, sup, svg, table, tags, tbody, td, textarea, tfoot, th, thead, time, title, tr, track, u, ul, varTag, video, vstack, wbr, wrapDOMReady, zstack };