draft-ole 0.9.0

package/dist/page-DylNkWXm.d.ts

@@ -0,0 +1,366 @@
+import { aF as Root, aG as StaticView, al as PageOptions, b as HtmlTag, T as TagType, e as HtmlTagOptions, R as RenderContext, a as HTMLTagProtocol, v as ButtonOptions, ay as View, ad as HeadingLevel, ak as LinkOptions } from './types-BXV3vhHS.js';
+
+/**
+ * 静的ページ書き出しのオプション。
+ *
+ * design.md §6.3 で定義された `StaticExportOptions` インターフェース。
+ *
+ * - `htmlFileName`: 出力 HTML ファイル名（デフォルト: `'index.html'`）
+ * - `cssFileName`: 出力 CSS ファイル名（デフォルト: `'style.css'`）。`inlineCss=false` のときのみ使用
+ * - `inlineCss`: CSS を `<style>` タグとして HTML 内に埋め込むか（デフォルト: `true`）
+ *
+ * @public
+ */
+interface StaticExportOptions {
+    readonly htmlFileName?: string;
+    readonly cssFileName?: string;
+    readonly inlineCss?: boolean;
+}
+
+/**
+ * 静的ページの境界オブジェクト。
+ *
+ * 内部で {@link Root} を保持するが外部 API では露出しない。
+ * `render()` は HTML + inline CSS を返し、`export()` は {@link StaticPageWriter} に委譲する。
+ *
+ * design.md §6.3 / requirements.md 4.2, 5.1, 5.2 に対応。
+ *
+ * 構築時 pure validation を {@link page} ファクトリで 1 度だけ実施するため、
+ * `render()` / `export()` 側では再検証しない（冪等性）。
+ */
+declare class PageDocument {
+    private readonly _root;
+    /**
+     * @internal `page()` ファクトリからのみ呼び出されることを想定する。
+     *           外部から直接構築すると静的性検証を素通りするため非推奨。
+     */
+    constructor(root: Root);
+    render(): string;
+    export(outputPath: string, options?: StaticExportOptions): void;
+}
+/**
+ * 静的ページのファクトリ。
+ *
+ * design.md §6.2 に準拠し `StaticView` を受け取り {@link PageDocument} を返す。
+ *
+ * **レイアウト契約**: 渡した StaticView は `<main>` の直接の子として縦方向に積まれる（ブロックフロー）。
+ * ページルート自体のレイアウト変更は不可。横並び等が必要な場合は View 側でコンテナを組むこと。
+ *
+ * 構築時 pure validation:
+ * - 新規 `Root` 構築直後に `_root.collectUsedMethods()` / `_root.collectJsContent()`
+ *   を 1 回だけ読み取り専用 walk として実行する。
+ * - いずれかが非空なら `Error('page surface does not allow runtime content: <hint>')`
+ *   を throw し、`PageDocument` は生成されない（requirements.md 3.2）。
+ * - `protoRender()` は呼ばないため `RenderContext.registry.reset()` 等の
+ *   レンダー副作用は発生しない（design.md §6.3 冪等性）。
+ */
+declare function page(...views: StaticView[]): PageDocument;
+declare function page(...args: [...StaticView[], PageOptions]): PageDocument;
+
+/**
+ * Alignment 定数と型定義
+ *
+ * SwiftUI の Alignment に対応する CSS 値の定数を提供する。
+ */
+declare const Alignment: {
+    readonly center: "center";
+    readonly leading: "flex-start";
+    readonly trailing: "flex-end";
+    readonly top: "flex-start";
+    readonly bottom: "flex-end";
+};
+type AlignmentValue = typeof Alignment[keyof typeof Alignment];
+declare const ZStackAlignment: {
+    readonly center: {
+        readonly alignItems: "center";
+        readonly justifyContent: "center";
+    };
+    readonly topLeading: {
+        readonly alignItems: "flex-start";
+        readonly justifyContent: "flex-start";
+    };
+    readonly topTrailing: {
+        readonly alignItems: "flex-start";
+        readonly justifyContent: "flex-end";
+    };
+    readonly bottomLeading: {
+        readonly alignItems: "flex-end";
+        readonly justifyContent: "flex-start";
+    };
+    readonly bottomTrailing: {
+        readonly alignItems: "flex-end";
+        readonly justifyContent: "flex-end";
+    };
+    readonly top: {
+        readonly alignItems: "flex-start";
+        readonly justifyContent: "center";
+    };
+    readonly bottom: {
+        readonly alignItems: "flex-end";
+        readonly justifyContent: "center";
+    };
+    readonly leading: {
+        readonly alignItems: "center";
+        readonly justifyContent: "flex-start";
+    };
+    readonly trailing: {
+        readonly alignItems: "center";
+        readonly justifyContent: "flex-end";
+    };
+};
+type ZStackAlignmentKey = keyof typeof ZStackAlignment;
+
+/**
+ * レイアウト型定義
+ *
+ * SwiftUI の HStack / VStack / ZStack / Spacer に対応するオプション型と
+ * 子要素型を定義する。
+ *
+ * Requirements: 1.1, 2.1, 3.1, 4.1, 5.1
+ */
+
+/**
+ * HStack / VStack のオプション。
+ *
+ * - `spacing`: 子要素間のギャップ（px 単位の数値）。CSS `gap` に対応する。
+ * - `alignment`: 交差軸方向の整列。CSS `align-items` に対応する。
+ * - `wrap`: 折り返し有無。CSS `flex-wrap: wrap` に対応する。
+ */
+interface StackOptions {
+    spacing?: number;
+    alignment?: AlignmentValue;
+    wrap?: boolean;
+}
+/**
+ * ZStack のオプション。
+ *
+ * - `alignment`: 重ね合わせ時の整列キー。`ZStackAlignment` の各キーに対応する。
+ */
+interface ZStackOptions {
+    alignment?: ZStackAlignmentKey;
+}
+/**
+ * Spacer のオプション。
+ *
+ * - `minLength`: スペーサーの最小サイズ（px 単位の数値）。
+ *   水平方向では `min-width`、垂直方向では `min-height` に対応する。
+ */
+interface SpacerOptions {
+    minLength?: number;
+}
+/**
+ * レイアウトコンテナの子要素型。
+ *
+ * `HtmlTag` インスタンスまたはテキスト文字列を受け付ける。
+ */
+type LayoutChild = HtmlTag | string;
+
+/**
+ * Task 4.2: PairType ペアタグ要素
+ *
+ * 開始タグと終了タグを持つペア要素（div, p, span等）を表現する。
+ * HtmlTag 基底クラスを継承し、<tag attrs>children</tag> 形式でレンダリングする。
+ *
+ * PairType は HtmlTag の全動作をそのまま継承する最も標準的なタグ種別であり、
+ * addChild()/addChildren() で子要素を追加順に保持し、
+ * protoRender() で <tag attrs>children</tag> を出力する。
+ *
+ * Requirements: 3.2, 3.5, 3.6, 6.5, 6.8
+ */
+
+/**
+ * Represents HTML elements with opening and closing tags.
+ *
+ * PairType is the most common HTML element type, used for elements like
+ * `<div>`, `<p>`, `<span>`, etc. These elements have both an opening tag
+ * and a closing tag, and can contain child elements.
+ *
+ * **Rendering Format:**
+ * ```html
+ * <tag attrs>children</tag>
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using factory functions (recommended)
+ * const element = div(
+ *   p('Hello'),
+ *   span('World')
+ * );
+ *
+ * // Direct instantiation (less common)
+ * const custom = new PairType('div');
+ * custom.addChild(new TextType('Content'));
+ * ```
+ *
+ * @example
+ * With attributes:
+ * ```typescript
+ * const element = div(
+ *   { class: 'container', id: 'main' },
+ *   p('Content')
+ * );
+ * console.log(element.render());
+ * // <div class="container" id="main">
+ * //   <p>Content</p>
+ * // </div>
+ * ```
+ *
+ * @remarks
+ * **Preconditions:** tagType must be a valid pair tag (not self-closing)
+ *
+ * **Postconditions:** `protoRender()` returns `<tag attrs>children</tag>` format
+ *
+ * **Invariants:** Children order is preserved in insertion order
+ */
+declare class PairType extends HtmlTag {
+    /**
+     * Creates a new PairType element.
+     *
+     * @param tagType - The HTML tag type (e.g., 'div', 'p', 'span')
+     *
+     * @remarks
+     * It's recommended to use factory functions like {@link div}, {@link p}, {@link span}
+     * instead of direct instantiation.
+     */
+    constructor(tagType: TagType, options?: HtmlTagOptions);
+    /**
+     * Task 3.2: PairType の protoRender override。
+     *
+     * 受け取った ctx を基底クラス実装に伝搬し、基底クラスが内部で
+     * 子要素 `protoRender(ctx)` に同一インスタンスを渡せるようにする。
+     * 出力フォーマット（`<tag attrs>children</tag>`）は基底クラス挙動を維持する。
+     */
+    protoRender(ctx?: RenderContext): string;
+}
+
+/**
+ * Task 4.3: SelfClosingType 自己終了タグ要素
+ *
+ * 終了タグを持たない自己終了要素（br, hr, img, input, meta, link 等）を表す。
+ * HtmlTag を継承し、addChild/addChildren をオーバーライドして
+ * 子要素追加を静かに無視する（no-op）。
+ *
+ * レンダリングは基底クラスの protoRender() が SELF_CLOSING_TAGS を参照して
+ * `<tag attrs>` 形式を生成するため、追加のオーバーライドは不要。
+ *
+ * Requirements: 3.3, 6.4, 10.1
+ */
+
+/**
+ * Represents self-closing (void) HTML elements.
+ *
+ * Self-closing elements don't have closing tags and cannot contain children.
+ * Examples include `<br>`, `<hr>`, `<img>`, `<input>`, `<meta>`, `<link>`, etc.
+ *
+ * **Rendering Format:**
+ * ```html
+ * <tag attrs>
+ * ```
+ *
+ * **Child Handling:**
+ * Attempts to add children are silently ignored (no-op) to maintain API consistency.
+ * This design choice prevents runtime errors while maintaining fluent method chaining.
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * // Using factory functions (recommended)
+ * const lineBreak = br();
+ * const image = img({ src: 'photo.jpg', alt: 'My photo' });
+ * const inputField = input({ type: 'text', placeholder: 'Enter name' });
+ * ```
+ *
+ * @example
+ * Child elements are silently ignored:
+ * ```typescript
+ * const lineBreak = br();
+ * lineBreak.addChild(p('This will be ignored'));
+ * console.log(lineBreak.render());
+ * // Output: <br>
+ * // (no error, child is simply not rendered)
+ * ```
+ *
+ * @remarks
+ * **Preconditions:** tagType must be in {@link SELF_CLOSING_TAGS}
+ *
+ * **Postconditions:** `protoRender()` returns `<tag attrs>` format
+ *
+ * **Invariants:** Children array is always empty (addChild/addChildren are no-ops)
+ */
+declare class SelfClosingType extends HtmlTag {
+    /**
+     * Creates a new SelfClosingType element.
+     *
+     * @param tagType - The HTML tag type (must be a self-closing tag like 'br', 'img', etc.)
+     *
+     * @remarks
+     * It's recommended to use factory functions like {@link br}, {@link img}, {@link input}
+     * instead of direct instantiation.
+     */
+    constructor(tagType: TagType, options?: HtmlTagOptions);
+    /**
+     * Silently ignores child element addition (no-op).
+     *
+     * Self-closing tags cannot have children, so this method does nothing.
+     * This design prevents runtime errors while maintaining method chaining compatibility.
+     *
+     * @param _child - The child element (ignored)
+     * @returns This instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const element = br()
+     *   .addChild(p('Ignored'))  // No error, just ignored
+     *   .addHtmlAttribute(HtmlAttribute.className('line-break'));
+     * ```
+     */
+    addChild(_child: HTMLTagProtocol): this;
+    /**
+     * Silently ignores multiple child elements addition (no-op).
+     *
+     * Self-closing tags 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 3.2: SelfClosingType の protoRender override。
+     *
+     * SelfClosing 要素は子を持たないが、シグネチャを ctx 受理形に widen し、
+     * 基底クラス実装に ctx を伝搬する。出力フォーマット（`<tag attrs>`）は
+     * 基底クラス挙動を維持する。
+     */
+    protoRender(ctx?: RenderContext): string;
+}
+
+declare function VStack(options?: StackOptions, ...children: View[]): PairType;
+declare function HStack(options?: StackOptions, ...children: View[]): PairType;
+declare function Text(content: string): PairType;
+declare function Image(src: string, alt: string): SelfClosingType;
+declare function Section(...children: View[]): PairType;
+declare function Spacer(options?: SpacerOptions): PairType;
+declare function Heading(level: HeadingLevel, content: string): PairType;
+declare function Link(options: LinkOptions, ...children: View[]): PairType;
+declare function Button(options: ButtonOptions | undefined, ...children: View[]): PairType;
+
+/**
+ * AppSlot — マウントポイントを表す StaticView プリミティブ。
+ *
+ * `data-draftole-mount` 属性を持つ `<div>` を生成し、
+ * ランタイム系の App コンポーネントをマウントする際の
+ * プレースホルダとして機能する。
+ *
+ * - `protoRender()` は `<div data-draftole-mount="${id}"></div>` を返す。
+ * - `collectCssStyleString()` は空文字列を返す（CSS なし）。
+ * - runtime メソッド（jqm / state / script 等）は持たない。
+ * - `app/` モジュールへの依存を持たない。
+ */
+interface AppSlotOptions {
+    readonly id: string;
+}
+declare function AppSlot(options: AppSlotOptions): StaticView;
+declare function AppSlot(id: string): StaticView;
+
+export { Alignment as A, Button as B, HStack as H, Image as I, type LayoutChild as L, PairType as P, SelfClosingType as S, Text as T, VStack as V, type ZStackOptions as Z, type StackOptions as a, type SpacerOptions as b, type AlignmentValue as c, AppSlot as d, type AppSlotOptions as e, Heading as f, Link as g, PageDocument as h, Section as i, Spacer as j, ZStackAlignment as k, type ZStackAlignmentKey as l, type StaticExportOptions as m, page as p };