CEL Scripting in Template Builder

Your Script                    The Engine                     Result
あなたのスクリプト                 エンジン                          結果
    |                              |                              |
    v                              v                              v
documents.get("article", "intro") --> データベースから取得       --> { headline: "Welcome", body: "..." }
         .headline                --> フィールドを抽出        --> "Welcome"

// 現在のドキュメントの price フィールドにアクセス
doc.price

// 現在のドキュメントのフィールドを使って合計を計算
doc.price * doc.quantity

// 現在のドキュメントのステータスに基づく条件分岐
doc.status == "published" ? doc.title : "Draft: " + doc.title

// CMS 内での保存形式: article / welcome-post
{
  "headline": "私たちのプラットフォームへようこそ",
  "author": "Sarah Chen",
  "body": "私たちは発表できることを嬉しく思います...",
  "tags": ["お知らせ", "ニュース"]
}

documents.get("article", "welcome-post")

{
  "headline": "私たちのプラットフォームへようこそ",
  "author": "Sarah Chen",
  "body": "私たちは発表できることを嬉しく思います...",
  "tags": ["お知らせ", "ニュース"]
}

documents.get("article", "welcome-post").headline

documents.get("article", "welcome-post").author

documents.get("article", meta.params.slug).headline

// すべての国を取得
documents.find("country")

[
  { "code": "us", "name": "アメリカ合衆国", "flag": "US" },
  { "code": "sa", "name": "サウジアラビア", "flag": "SA" },
  { "code": "gb", "name": "イギリス", "flag": "GB" }
]

// フィルターを使って国を取得
documents.find("country", { "where": { "code": "us" } })

[
  { "code": "us", "name": "アメリカ合衆国", "flag": "US" }
]

// meta.locale が "fr" の場合、英語のベースドキュメントにフランス語の翻訳がマージされる
documents.get("greeting", "welcome").headline

// 常にスペイン語の翻訳を取得
documents.translated("greeting", "welcome", "es").headline

// URL パラメータに基づいて翻訳を取得
documents.translated("product", meta.params.id, meta.params.lang).description

// 翻訳を比較
documents.translated("article", "intro", "en").title + " / " + documents.translated("article", "intro", "fr").title

// ベースドキュメント: greeting / welcome
{ "headline": "Welcome", "subheadline": "私たちのプラットフォームへようこそ" }

// 翻訳（言語: "fr"）
{ "headline": "Bienvenue", "subheadline": "Bienvenue sur notre plateforme" }

// 翻訳（言語: "es"）
{ "headline": "Bienvenido", "subheadline": "Bienvenido a nuestra plataforma" }

// meta.locale = "fr" の場合
documents.get("greeting", "welcome").headline
// 戻り値: "Bienvenue"

// スペイン語の翻訳を明示的に取得
documents.translated("greeting", "welcome", "es").headline
// 戻り値: "Bienvenido"

// 翻訳がない場合のフォールバックパターン
documents.translated("greeting", "welcome", meta.params.lang) != null
  ? documents.translated("greeting", "welcome", meta.params.lang).headline
  : documents.get("greeting", "welcome").headline

{
  "headline": "より速く構築し、賢く出荷",
  "subheadline": "開発者のためのモダンな CMS"
}

documents.get("article", "homepage-hero").headline

// country / us
{ "code": "us", "name": "アメリカ合衆国", "flag": "US", "languages": ["en", "es"] }

// country / sa
{ "code": "sa", "name": "サウジアラビア", "flag": "SA", "languages": ["ar", "en"] }

documents.get("country", meta.params.code).name

meta.locale == "ar-SA" ? "皆さん、ようこそ" : "ようこそ"

{ "headline": "米国からのニュース", "countryCode": "us" }

documents.get("country", documents.get("article", "us-news").countryCode).name

documents.get("article", meta.params.slug) != null
  ? documents.get("article", meta.params.slug).headline
  : "記事が見つかりません"

documents.get("article", "intro").author != null
  ? documents.get("article", "intro").author
  : "著者不明"

"featured" in documents.get("article", "welcome-post").tags

documents.get("article", "welcome-post").tags[0]

size(documents.get("article", "welcome-post").tags)

{
  "pattern": "/{lang}/landingPage",
  "param_bindings": {
    "lang": "language"
  }
}

// greeting / ko
{ "code": "ko", "headline": "환영", "subheadline": "私たちのプラットフォームへようこそ", "ctaText": "開始する", "ctaUrl": "/ko/get-started" }

// greeting / en
{ "code": "en", "headline": "Welcome", "subheadline": "私たちのプラットフォームへようこそ", "ctaText": "Get Started", "ctaUrl": "/en/get-started" }

// greeting / ja
{ "code": "ja", "headline": "いらっしゃいませ", "subheadline": "私たちのプラットフォームへようこそ", "ctaText": "スタート", "ctaUrl": "/ja/get-started" }

documents.get("greeting", meta.params.lang).headline

{
  "pattern": "/{country}/{lang}/products",
  "param_bindings": {
    "country": "country",
    "lang": "language"
  }
}

// 国名を取得
documents.get("country", meta.params.country).name

// 国に基づいたローカライズ製品リスト
documents.find("product", { "where": { "country": meta.params.country } })

// 組み合わせ：ユーザーの言語で国別の挨拶を表示
documents.get("greeting", meta.params.lang).headline + " from " + documents.get("country", meta.params.country).name

// 最初のセグメントを取得（言語コードであることが多い）
meta.segments[0]

// パスの深さを確認
size(meta.segments) > 2 ? "deep" : "shallow"

// 管理セクションかどうかを確認
"admin" in meta.segments ? "admin mode" : "public mode"

// パラメータがバインドされていない場合のフォールバック
has(meta.params.lang) ? meta.params.lang : meta.segments[0]

// RTL 言語かどうかを確認
meta.locale == "ar-SA" || meta.locale == "he-IL" ? "rtl" : "ltr"

// 言語部分のみを取得
meta.locale.split("-")[0]  // 未対応 - 代わりに meta.params.lang を使用

// 名前付きパラメータにアクセス
meta.params.lang           // "ko"
meta.params.country        // "us"
meta.params.slug           // "welcome-post"

// パラメータが存在するか確認
has(meta.params.category)  // true/false

// ドキュメント取得に使用
documents.get("greeting", meta.params.lang)
documents.ref("airports").get(meta.params.code)

// インデックス（0 始まり）でアクセス
meta.segments[0]           // 最初のセグメント
meta.segments[1]           // 2 番目のセグメント

// 長さを確認
size(meta.segments)        // セグメント数

// 含まれているか確認
"products" in meta.segments  // パスに "products" が含まれているか？

// 既存ドキュメントを編集している時のみ利用可能
meta.docId != null ? "editing" : "creating new"

// 条件付きロジックで使用
meta.docId != null ? documents.get("article", meta.docId).status : "draft"

// 表示に使用
"編集中: " + meta.title

// タイトルに基づく条件
meta.title.contains("Draft") ? "作業中" : "公開済み"

// 従来のアプローチ
documents.get("airports", meta.params.code).name

// ref() を使用 - スキーマと動的識別子を分けて記述
documents.ref("airports").get(meta.params.code).name

documents.get("schema", "identifier")       // 単一ドキュメントを取得
documents.get("schema", "id").fieldName     // 特定フィールドを取得
documents.find("schema")                    // すべてのドキュメントを取得
documents.find("schema", { "where": {...}}) // フィルター付きクエリ
documents.ref("schema").get(identifier)     // 連鎖ルックアップ
documents.translated("schema", "id", "fr")  // 明示的ロケール付き取得

meta.locale          // "en-US"、"ar-SA" など
meta.params.xyz      // "xyz" という名前の URL パラメータ
meta.segments        // URL パスを配列化: ["articles", "intro"]
meta.segments[0]     // 最初のパスセグメント
meta.docId           // 現在のドキュメント ID（または null）
meta.title           // 現在のドキュメントタイトル
doc.fieldName        // エディターコンテキスト内の現在ドキュメントのフィールド値

// 比較
==  !=  <  <=  >  >=

// 論理
&&  ||  !

// 三項演算子（if-else）
condition ? valueIfTrue : valueIfFalse

// 含有判定
"value" in listOrMap

size(list)                    // 要素数を数える
size(string)                  // 文字列の長さ
"text".startsWith("te")       // true
"text".endsWith("xt")         // true
"text".contains("ex")         // true
has(object.property)          // プロパティが存在するか確認
hasProperty(obj, "key")       // オブジェクトにキーがあるか確認（別構文）

// 将来予定：MCP を介した外部サービス呼び出し
mcp.translate(meta.params.text, "en", meta.params.lang)
mcp.analyze(documents.get("article", meta.params.id).body)

// 将来予定：AI を活用したコンテンツ生成
ai.summarize(documents.get("article", meta.params.id).body, 100)
ai.translate(meta.params.text, meta.params.targetLang)
ai.classify(meta.params.input, ["positive", "negative", "neutral"])

// 記事が著者 ID を保持し、著者名を取得
documents.get("author", documents.get("article", "intro").authorId).name

// 従来のアプローチ
documents.get("country", documents.get("airport", meta.params.code).countryCode).name

// ref() を使用 - スキーマは固定で識別子のみ動的
documents.ref("country").get(documents.get("airport", meta.params.code).countryCode).name

// 空港 → 国 → 地域 → 大陸
documents.get("continent",
  documents.get("region",
    documents.get("country",
      documents.get("airport", meta.params.code).countryCode
    ).regionCode
  ).continentCode
).name

// 空港のローカライズされた国名を取得
documents.translated("country",
  documents.get("airport", meta.params.code).countryCode,
  meta.params.lang
).name

// article / tech-news
{ "title": "テックアップデート", "authorId": "author-123", "categoryId": "cat-tech" }

// 著者名を解決
documents.get("author", documents.get("article", meta.params.slug).authorId).name

// カテゴリーをフォールバック付きで解決
documents.get("article", meta.params.slug).categoryId != null
  ? documents.get("category", documents.get("article", meta.params.slug).categoryId).name
  : "未分類"

// airport / JFK
{ "code": "JFK", "name": "ジョン・F・ケネディ国際空港", "countryCode": "us" }

// country / us
{ "code": "us", "name": "アメリカ合衆国", "currencyCode": "usd" }

// currency / usd
{ "code": "usd", "symbol": "$", "name": "米ドル" }

// 空港 → 国 → 通貨のチェーン
documents.get("currency",
  documents.get("country",
    documents.get("airport", meta.params.code).countryCode
  ).currencyCode
).symbol
// JFK の場合: "$" を返す

// 製品ドキュメント内で、関連カテゴリの詳細を取得
documents.get("category", doc.categoryId).description

// 製品の原産国に基づいた配送料を計算
documents.get("shipping-rates", doc.originCountry).baseRate * doc.weight

// 記事の著者を取得し、その著者の他の記事も取得（フェッチ数に注意！）
documents.find("article", { "where": { "authorId": documents.get("article", meta.params.slug).authorId } })

// content-block / hero-1
{ "type": "hero", "sourceType": "article", "sourceId": "welcome-post" }

// content-block / hero-2
{ "type": "hero", "sourceType": "product", "sourceId": "featured-item" }

// sourceType に応じて動的にスキーマを切り替える
documents.get("content-block", "hero-1").sourceType == "article"
  ? documents.get("article", documents.get("content-block", "hero-1").sourceId).headline
  : documents.get("product", documents.get("content-block", "hero-1").sourceId).name

// 悪い例: 同じドキュメントを 2 回取得
documents.get("author", documents.get("article", "intro").authorId).name + " - " +
documents.get("author", documents.get("article", "intro").authorId).bio

// 良い例: 一度チェックして条件分岐
documents.get("article", "intro").authorId != null
  ? documents.get("author", documents.get("article", "intro").authorId).name
  : "著者不明"

{
  "name": "greeting",
  "fields": [
    { "name": "code", "type": "string", "required": true },
    { "name": "headline", "type": "string", "required": true },
    { "name": "subheadline", "type": "string" },
    { "name": "ctaText", "type": "string" },
    { "name": "ctaUrl", "type": "string" }
  ]
}

{
  "code": "ko",
  "headline": "환영",
  "subheadline": "私たちのプラットフォームへようこそ",
  "ctaText": "開始する",
  "ctaUrl": "/ko/get-started"
}

{
  "code": "en",
  "headline": "Welcome",
  "subheadline": "私たちのプラットフォームへようこそ",
  "ctaText": "Get Started",
  "ctaUrl": "/en/get-started"
}

{
  "code": "ja",
  "headline": "いらっしゃいませ",
  "subheadline": "私たちのプラットフォームへようこそ",
  "ctaText": "スタート",
  "ctaUrl": "/ja/get-started"
}

  {
    "lang": "language"
  }

documents.get("greeting", meta.params.lang).headline

documents.get("greeting", meta.params.lang).subheadline

documents.get("greeting", meta.params.lang).ctaText

documents.get("greeting", meta.params.lang).ctaUrl

// app/[...slug]/page.tsx
import ParametricRoutePage from 'cms-renderer/lib/renderer';
import { registry } from '@/lib/registry';
import { cmsConfig } from '@/lib/cms-config';

export const dynamic = 'force-static';

interface PageProps {
  params: Promise<{ slug: string[] }>;
}

export default async function Page({ params }: PageProps) {
  const { slug } = await params;

  return (
    <ParametricRoutePage
      registry={registry}
      apiKey={cmsConfig.apiKey}
      websiteId={cmsConfig.websiteId}
      cmsUrl={cmsConfig.cmsUrl}
      params={Promise.resolve({ slug })}
    />
  );
}

interface CelMeta {
  /** 現在のロケールコード（例: 'en-US'） */
  locale: string;
  /** URL から抽出したルートパラメータ */
  params: Record<string, string>;
  /** URL パスのセグメント */
  segments: string[];
  /** 現在のドキュメント ID（既存ドキュメントを編集している場合） */
  docId: string | null;
  /** 現在のドキュメントタイトル */
  title: string;
}

Pattern: /{country}/{lang}/products
Path:    /us/en/products

アルゴリズム:
1. 両方を正規化（末尾のスラッシュを削除）
2. セグメントに分割: ["us", "en", "products"] と ["{country}", "{lang}", "products"]
3. セグメント数が一致するか確認
4. 各セグメントペアについて:
   - パターンが : または {} で始まる場合、パラメータとして抽出
   - それ以外は完全一致である必要
5. 戻り値: { country: "us", lang: "en" }

// シンプルなバインディング（"code" フィールドでルックアップ）
{ "lang": "language" }

// 詳細なバインディング（カスタム slug フィールド）
{
  "lang": {
    "schemaName": "language",
    "slugField": "code"
  },
  "slug": {
    "schemaName": "article",
    "slugField": "slug"
  }
}