cards2pack

概要

cards2pack は Adaptive Card の JSON ファイルを Greentic packs に変換する CLI ツールです。次のことを行います:

cards を走査し、依存グラフを構築して .ygtc flows を生成する
i18n 用に翻訳可能な文字列を抽出する
greentic-i18n-translator によって cards を自動翻訳する
すべてをデプロイ可能な .gtpack にパッケージングする

インストール

cargo install greentic-cards2pack

必要なツール:

cargo install greentic-flow greentic-pack
cargo install greentic-i18n-translator  # optional, for --auto-translate

クイックスタート

Adaptive Cards を作成する

{
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    { "type": "TextBlock", "text": "Welcome!", "size": "Large" },
    { "type": "TextBlock", "text": "How can I help you today?" }
  ],
  "actions": [
    {
      "type": "Action.Submit",
      "title": "Get Started",
      "data": { "flow": "demo", "step": "next-card" }
    }
  ]
}

pack を生成する

greentic-cards2pack generate \
  --cards ./cards \
  --out ./my-pack \
  --name my-pack

出力

my-pack/
  pack.yaml
  flows/main.ygtc
  assets/cards/welcome.json
  dist/my-pack.gtpack
  .cards2pack/manifest.json

CLI リファレンス

`generate`

メインコマンドです。cards を走査し、flows を生成して、pack をビルドします。

greentic-cards2pack generate [OPTIONS]

Flag	説明
`--cards <DIR>`	Adaptive Card JSON ファイルのディレクトリ（必須）
`--out <DIR>`	出力 workspace ディレクトリ（必須）
`--name <NAME>`	Pack 名（必須）
`--strict`	欠落した target、重複、無効な JSON をエラーにする
`--group-by <MODE>`	Flow のグループ化: `folder` または `flow-field`
`--default-flow <NAME>`	グループ化されない cards のデフォルト flow 名
`--prompt`	prompt ベースのルーティングを有効にする（`prompt2flow` node を追加）
`--prompt-json <FILE>`	prompt ルーティング用の回答 JSON（`--prompt` が必要）
`--auto-translate`	最大 8 並列スレッドで cards を自動翻訳する（`greentic-i18n-translator` が必要）
`--langs <CODES>`	カンマ区切りの言語コード。省略すると対応する 65 以上のすべての locale に翻訳
`--glossary <FILE>`	一貫した翻訳のための glossary JSON
`--verbose`	詳細出力を表示する

`extract-i18n`

cards から翻訳可能な文字列を JSON bundle に抽出します。

greentic-cards2pack extract-i18n [OPTIONS]

Flag	説明
`--input <DIR>`	card JSON ファイルのディレクトリ（必須）
`--output <FILE>`	出力 JSON パス（デフォルト: `i18n/en.json`）
`--prefix <PREFIX>`	キー接頭辞（デフォルト: `card`）
`--include-existing`	すでに `$t()` パターンを含む文字列も含める
`--verbose`	抽出レポートを表示する

Card の識別

cards は次の優先順で識別されます:

card JSON 内の greentic.cardId フィールド
ファイル名の stem（例: welcome.json → welcome）

cards は次の方法で flows にグループ化されます:

action data 内の flow フィールド
--group-by folder（ディレクトリ構造）
--default-flow fallback

i18n と自動翻訳

文字列を抽出する

greentic-cards2pack extract-i18n \
  --input ./cards \
  --output i18n/en.json \
  --verbose

出力:

{
  "card.welcome.body_0.text": "Welcome!",
  "card.welcome.body_1.text": "How can I help you today?",
  "card.welcome.actions_0.title": "Get Started"
}

抽出されるフィールドの種類

Field	ソース
`text`	TextBlock の内容
`title`	Action titles、card titles、toggle titles
`label`	Input labels
`placeholder`	Input placeholders
`errorMessage`	Validation errors
`altText`	画像の代替テキスト
`fallbackText`	フォールバック内容
FactSet `title`/`value`	Fact entries
ChoiceSet `title`	Choice options

自動翻訳（1 コマンド）

greentic-cards2pack generate \
  --cards ./cards \
  --out ./my-pack \
  --name my-pack \
  --auto-translate \
  --langs fr,de

これにより、元の card ファイルから文字列を抽出し、最大 8 並列スレッドで greentic-i18n-translator によって翻訳し、すべてをまとめて bundle します:

my-pack/assets/i18n/
  en.json   # English (source)
  fr.json   # French
  de.json   # German

Glossary

brand 名や技術用語の表記を統一するには glossary を使います:

{
  "Greentic": "Greentic",
  "Dashboard": "Dashboard"
}

greentic-cards2pack generate \
  --cards ./cards --out ./pack --name demo \
  --auto-translate --langs fr,de \
  --glossary glossary.json

Flow の生成

生成された flow セクションは markers で囲まれます:

# BEGIN GENERATED (cards2pack)
# ... generated nodes ...
# END GENERATED (cards2pack)

# Developer space below (preserved on regen)

markers の外側の内容は再生成時にも保持されます。

strict モード

--strict を使うと:

欠落した route targets はエラーになる（stub nodes ではなく）
重複した cardId 値はエラーになる
無効な JSON はエラーになる

テンプレート変数

動的コンテンツには Handlebars 構文を使います:

{
  "type": "TextBlock",
  "text": "Hello, {{name}}!"
}

例: 翻訳付きマルチステップフォーム

# Create cards in cards/ directory, then:
greentic-cards2pack generate \
  --cards ./cards \
  --out ./checkout-pack \
  --name checkout \
  --auto-translate \
  --langs fr,ja,es \
  --glossary glossary.json \
  --strict