fandhe-frontend

name	fandhe-frontend
description	Rust 製フロントエンドフレームワーク fandhe-frontend のリファレンス。 SSR / SPA / SSG / View Transitions 統合、hydration、単一実行ファイル配布。 既定エスケープ・forbid(unsafe_code) の安全設計。 主要クレート core / app / interactive / headless-ui(Primitives) / pre-styled-ui(Themes) / server(SSG generate_pages/generate_assets)（fandhe-frontend- 接頭）。 CLI fw（new / gate / structure / impact）。
user-invocable	false

fandhe-frontend

fandhe-frontend は Rust 製フロントエンドフレームワーク。SSR / SPA / SSG / View Transitions を単一フレームワークで網羅し、単一実行ファイル（Docker 想定）でのデプロイまでを担う。テキスト補間の既定エスケープ・unsafe の排除（core / interactive は forbid(unsafe_code)）・依存クレート数の上限管理を製品仕様として固定した、AI 時代のセキュリティリスク低減志向の設計。

他スキルとの使い分け — 本スキルの Primitives（fandhe-frontend-headless-ui）・Themes（fandhe-frontend-pre-styled-ui）はコンポーネント名・anatomy 構成が Ark UI / Chakra UI v3 と対応するが、すべて Rust API であり @ark-ui/react / @chakra-ui/react の JS/TS API とは別物（相互に import できない）。Primitives はスタイル無しの anatomy と状態機械のみを提供する headless 層（skills/ark-ui/ 相当）、Themes は Primitives に既定 CSS と variant を足した薄い styled ラッパー層（skills/chakra-ui/ 相当）。React/JS プロジェクトの調査には skills/ark-ui/ skills/chakra-ui/ を、Rust プロジェクトの調査には本スキルを使うこと。バックエンド（Rust 製 HTTP サーバーフレームワーク）を調べる場合は skills/fandhe-backend/ を参照すること。

公式ドキュメント: https://fandhe-ai.github.io/fandhe-frontend/ / リポジトリ: https://github.com/Fandhe-AI/fandhe-frontend

ディレクトリ構成

skills/fandhe-frontend/
  SKILL.md
  references/
    getting-started/
      README.md
      introduction.md
      quickstart.md
    guides/
      README.md
      component-authoring.md
      embedding-guide.md
      view-transitions.md
      npm-asset-build.md
      no-js-ssg.md
    api/
      README.md
      component-api.md
      app-api.md
      interactive-api.md
      hydration-api.md
      hydration-state-format.md
      router-path-matching.md
      headless-ui-api.md
      pre-styled-ui-api.md
      pre-styled-recipe-api.md
      server-api.md
      keyed-list-api.md
      binding-api.md
    primitives/                    # fandhe-frontend-headless-ui（Rust, unstyled）
      form/                        # 22 ページ
        README.md
        checkbox.md
        slider.md
        color-picker.md
        ...
      collections/                 # 9 ページ
        README.md
        combobox.md
        select.md
        tree-view.md
        ...
      overlays/                    # 10 ページ
        README.md
        dialog.md
        popover.md
        toast.md
        ...
      disclosure/                  # 5 ページ
        README.md
        accordion.md
        tabs.md
        splitter.md
        ...
      date-time/                   # 4 ページ
        README.md
        calendar.md
        date-input.md
        date-picker.md
        timer.md
      navigation/                  # 6 ページ
        README.md
        breadcrumb.md
        navigation-menu.md
        skip-nav.md
        ...
      display/                     # 7 ページ
        README.md
        avatar.md
        progress.md
        qr-code.md
        ...
    themes/                        # fandhe-frontend-pre-styled-ui（Rust, styled）
      forms/                       # 24 ページ
        README.md
        button.md
        checkbox.md
        input.md
        ...
      data-display/                # 15 ページ
        README.md
        card.md
        table.md
        badge.md
        ...
      typography/                  # 14 ページ
        README.md
        heading.md
        text.md
        link.md
        ...
      charts/                      # 11 ページ
        README.md
        charts.md
        bar-chart.md
        line-chart.md
        ...
      collections/                 # 10 ページ
        README.md
        select.md
        menu.md
        tree-view.md
        ...
      overlays/                    # 10 ページ
        README.md
        dialog.md
        toast.md
        tooltip.md
        ...
      feedback/                    # 6 ページ
        README.md
        alert.md
        spinner.md
        skeleton.md
        ...
      navigation/                  # 5 ページ
        README.md
        breadcrumb.md
        navigation-menu.md
        toolbar.md
        ...
      disclosure/                  # 4 ページ
        README.md
        accordion.md
        scroll-area.md
        splitter.md
        tabs.md
      date-time/                   # 4 ページ
        README.md
        calendar.md
        date-input.md
        date-picker.md
        timer.md
      utilities/                   # 4 ページ
        README.md
        download-trigger.md
        separator.md
        skip-nav.md
        visually-hidden.md
  samples/
    README.md
    ssr-routing.md
    ssg-blog.md
    dist-server-docker.md
    interactive-view-transitions.md
    headless-pre-styled-ui.md
  scripts/
    README.md
    install.md
    cli.md
    build.md
    deploy.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

1. 下記マッピング表でタスクに対応するカテゴリを探す（primitives/* と themes/* はコンポーネント名が重複するため、Rust API のスタイル無し版が必要か styled 版が必要かで区別する）
2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスク	カテゴリ	参照 README
fandhe-frontend とは何か、特徴・設計思想を知りたい / fw new での最短経路	getting-started	references/getting-started/README.md
マクロ非依存のコンポーネント記述 / 既存 HTML への埋め込み / View Transitions 有効化 / NPM 静的アセット取り込み	guides	references/guides/README.md
el/text/render/raw_html などコア API、App/Loader/Router API、Hydration API・状態フォーマット、headless-ui/pre-styled-ui の公開 API・slot recipe、keyed list diff（keyed/keyed_diff）、属性・テキスト・class バインディング（bind/binding）	api	references/api/README.md
クライアント JS ゼロの SSG 構成での制約・代替パターン、fandhe-frontend-server の SSG API（generate/generate_with/generate_pages/generate_assets）	guides / api	references/guides/README.md / references/api/README.md
Checkbox, Slider, Color Picker などフォーム系 Primitives（unstyled）API を知りたい	primitives/form	references/primitives/form/README.md
Combobox, Select, Tree View などコレクション系 Primitives（unstyled）API を知りたい	primitives/collections	references/primitives/collections/README.md
Dialog, Popover, Toast などオーバーレイ系 Primitives（unstyled）API を知りたい	primitives/overlays	references/primitives/overlays/README.md