@rex0220/formula-authoring-tools 0.3.0 → 0.3.1

package/README.md

@@ -30,7 +30,7 @@ Projects/
 - `src/meta.ts` … tools の版、扱う計算式プラグイン（プラグイン ID `FORMULA_PLUGIN_ID`、封筒の `FORMULA_CONFIG_PLUGIN_ID`、版の下限 `MIN_PLUGIN_VERSION`）、API の版（`SUPPORTED_API_VERSIONS`）、API の契約（`REQUIRED_API`）
 - `src/commands/save.ts` … 保存の約束（formula MCP の `fml_save_settings` / `fml_update_fields` の本体。CLI は使わない）。新しい設定は同じ名前があれば保存しない、既存の設定は `fml_summary` の digest を照合して項目の行（`fieldcode`）を複数まとめて差し替える。normalize は Worker で行い、エラーがあれば確定しない。確定はロック付き（`commit-file.ts`）
 - `src/core.ts` … 共通の中核の入口（npm の `@rex0220/formula-authoring-tools/core`。formula MCP が使う。`CORE_API_VERSION` 2）。`scripts/build.mjs` が `dist/core.mjs` と `dist/types/` を作る。MCP が使う名前は `test/core-exports.test.mjs` で固定する
-- `scripts/vendor.mjs` … moment 2.24.0 を CDN から `vendor/` に取る（`vendor/moment.json` の SHA-256 と照合）。`scripts/build.mjs` … esbuild で `dist/cli.mjs` / `dist/eval-worker.mjs` / `dist/core.mjs`。`scripts/gen-docs.mjs` … `docs/`（設定ファイル仕様、関数一覧、functions.json、schema-manifest、既定のテストデータ）と `samples/users.json` を zip から機械生成
+- `scripts/vendor.mjs` … moment 2.24.0 を CDN から `vendor/` に取る（`vendor/moment.json` の SHA-256 と照合）。`scripts/build.mjs` … esbuild で `dist/cli.mjs` / `dist/eval-worker.mjs` / `dist/core.mjs`。`scripts/gen-docs.mjs` … `docs/`（設定ファイル仕様、関数一覧、functions.json、schema-manifest、既定のテストデータ）と `samples/users.json` を zip から機械生成。`scripts/verify-patterns.mjs` + `scripts/pattern-cases.mjs` … 計算パターン集の例を同梱のサンプルアプリと架空の値で `try` に評価させ、関数一覧の使用例も評価して `docs/計算パターン_検証.md` を作る（`test/docs-sync.test.mjs` が最新と全部一致を確かめる = エンジンの版が変わったときの回帰検査）
 - `pending/` … print-craft から写してまだ計算式用にしていないもの（`diff.ts` / `normalize.ts` は計算式用の `src/commands/` が別にあるので使っていない）。npm には入らない
 - `test/` … `node --test`（src の .ts を直接読む。`test/helpers.mjs` が fixture の zip を読む。`test/fixtures/formula/` はテスト用アプリ 2305 の項目定義と設定）
 
@@ -60,7 +60,8 @@ npm pack --dry-run  # 公開前に中身を確かめる（dist、vendor、LICENS
 
 ## 履歴
 
-- 0.3.0（2026-10）: 式の試し計算 `try`（計画 25 章。formula MCP 0.2.0 の `fml_try`）。同梱のサンプルアプリ（`src/sample-app/`）に 1 行だけの設定を組んで normalize → calc。架空の項目と値（`src/commands/try-data.ts`: `--fields` で標本に項目を足す、`--data` で簡略形の値のレコード、`--app` で利用者のアプリの項目定義に架空の値）。`core` に `trySettings` / `SAMPLE_APP` / `describeSampleApp`、評価の仕事の kind `try`（`EvalJob` の `settingsText` / `settingsFile` / `fields` は try では省略できる）、`calcSettings` の `allowDefaultBaseUrl`。`CORE_API_VERSION` は 2 のまま（足しただけ）
+- 0.3.1（2026-10）: normalize がスペース項目（要素 ID のある SPACER）とヘッダーの行の計算式を `field.type` で誤って止めていたのを直した（設定画面は許す）。`try` でスペース項目を対象にできる（`--as sp1` / `SPACER`。標本に `sp1` を足した。レコードに値が無いので式の返り値をそのまま返す）
+- 0.3.0（2026-10）: 計算パターン集の例の検証（`docs/計算パターン_検証.md`。gen-docs）。式の試し計算 `try`（計画 25 章。formula MCP 0.2.0 の `fml_try`）。同梱のサンプルアプリ（`src/sample-app/`）に 1 行だけの設定を組んで normalize → calc。架空の項目と値（`src/commands/try-data.ts`: `--fields` で標本に項目を足す、`--data` で簡略形の値のレコード、`--app` で利用者のアプリの項目定義に架空の値）。`core` に `trySettings` / `SAMPLE_APP` / `describeSampleApp`、評価の仕事の kind `try`（`EvalJob` の `settingsText` / `settingsFile` / `fields` は try では省略できる）、`calcSettings` の `allowDefaultBaseUrl`。`CORE_API_VERSION` は 2 のまま（足しただけ）
 - 0.2.1（2026-10）: formula MCP の Codex レビューへの対応。`updateFields` の `common` を共通の設定のキー（`COMMON_KEYS`）だけに。Worker の中の誤りの種類（`EvalError.kind`）と名前を中核が instanceof で決める（zip のコードの例外の name / constructor.name / 文を応答や標準エラーに出さない。`classifyEvalError` / `builtinErrorName`）。保存の結果の想定外の誤りも種類だけ（`zipCode`）。CLI の想定外の誤りは種類だけ（`FORMULA_DEBUG=1` で文とスタック）。接続の誤りの文の print-craft の名残を直した
 - 0.2.0（2026-10）: formula MCP のための中核の入口（`CORE_API_VERSION` 2。CLI の動きは変えない）。`core` に workspace / connections / permission / commit-file / take / users の参照コード / JSON の誤りの文 / 行のキーを追加。`src/commands/save.ts`（`saveNewSettings` / `updateFields`）。`runEval` の `workerFile`（Worker の入口の絶対パス）と `captureOutput`（Worker の標準出力・標準エラーを親に流さず受け取る）、`loadEngine` の `vendorDir`（moment の置き場所）。評価の結果に `findings` と calc のレコードごとの行
 - 0.1.0（2026-10）: 最初の公開。version / fields / record / records / pull / summary / diff / users / normalize / calc / take / edit / files。扱う計算式プラグイン Ver.101 以降、authoring API 1

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/*! @rex0220/formula-authoring-tools 0.3.0 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit cfbd850. */
+/*! @rex0220/formula-authoring-tools 0.3.1 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit 3788114. */
 
 // src/cli.ts
 import { chmodSync, existsSync as existsSync9, mkdirSync as mkdirSync2, realpathSync as realpathSync5, writeFileSync as writeFileSync3 } from "node:fs";
@@ -355,7 +355,7 @@ function devMeta() {
   return { toolsVersion: pkg.version, pluginId: FORMULA_PLUGIN_ID, minPluginVersion: MIN_PLUGIN_VERSION, supportedApiVersions: [...SUPPORTED_API_VERSIONS], commit: gitCommit(AUTHORING_ROOT), builtAt: "", mode: "dev" };
 }
 function toolsMeta() {
-  if (true) return JSON.parse('{"toolsVersion":"0.3.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"cfbd850","builtAt":"2026-10-18T05:24:49.527Z","mode":"build"}');
+  if (true) return JSON.parse('{"toolsVersion":"0.3.1","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"3788114","builtAt":"2026-10-18T08:08:27.541Z","mode":"build"}');
   return devMeta();
 }
 
@@ -3613,6 +3613,14 @@ var fields_default = {
             width: "250",
             innerHeight: "125"
           }
+        },
+        {
+          type: "SPACER",
+          elementId: "sp1",
+          size: {
+            width: "458",
+            height: "163"
+          }
         }
       ]
     },
@@ -3998,14 +4006,14 @@ var fields_default = {
           type: "RADIO_BUTTON",
           code: "T1_ラジオ",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
           type: "CHECK_BOX",
           code: "T1_チェック",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
@@ -4019,7 +4027,7 @@ var fields_default = {
           type: "DROP_DOWN",
           code: "T1_ドロップダウン",
           size: {
-            width: "150"
+            width: "158"
           }
         },
         {
@@ -4125,14 +4133,14 @@ var fields_default = {
           type: "RADIO_BUTTON",
           code: "T2_ラジオ",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
           type: "CHECK_BOX",
           code: "T2_チェック",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
@@ -4146,7 +4154,7 @@ var fields_default = {
           type: "DROP_DOWN",
           code: "T2_ドロップダウン",
           size: {
-            width: "150"
+            width: "158"
           }
         },
         {
@@ -5540,6 +5548,17 @@ var SAMPLE_APP = {
 function sampleApp() {
   return structuredClone(SAMPLE_APP);
 }
+function spacerIds(layout) {
+  const out = [];
+  for (const row of layout) {
+    if (row.type === "GROUP" && Array.isArray(row.layout)) {
+      out.push(...spacerIds(row.layout));
+      continue;
+    }
+    for (const f of row.fields ?? []) if (f.type === "SPACER" && typeof f.elementId === "string" && f.elementId) out.push(f.elementId);
+  }
+  return out;
+}
 var tableRows = (record, code) => {
   const v = record[code]?.value;
   return Array.isArray(v) ? v.length : 0;
@@ -5554,6 +5573,7 @@ function describeSampleApp(targetTypes) {
     "項目（1 項目 1 行。○ = 計算式を設定できる型。テーブルの子は T1_ / T2_ の接頭辞）:",
     listFields(fields, { targetTypes }),
     "",
+    `スペース項目（要素 ID。as に要素 ID か SPACER。レコードに値は無く、式の返り値をそのまま返す）: ${spacerIds(fields.layout).join(", ") || "無し"}`,
     "レコード（try の records で選ぶ。既定は 3 件とも）:",
     ...records.map((r) => `  ${r.id}: ${r.label}。${tables.map((t) => `${t} ${tableRows(r.record, t)} 行`).join("、")}`),
     "ユーザー・組織・グループの値は既定のテストデータ（架空の 10 人。demo_user01 …）のコード"
@@ -5811,7 +5831,7 @@ async function normalizeSettings(input) {
   for (const r of rows) {
     const where = `${file} ${r.fieldcode}`;
     const t = typeOf(r);
-    if (r.formulaSet && r.formulaSet.trim() && !targetTypes.has(t)) findings.error("field.type", where, `${t} の項目には計算式を設定できない`);
+    if (r.formulaSet && r.formulaSet.trim() && !targetTypes.has(t) && !isSpacerRow(r) && !isHeaderRow(r)) findings.error("field.type", where, `${t} の項目には計算式を設定できない`);
     if (r.edit && (isHeaderRow(r) || isSpacerRow(r) || isGroupRow(r))) findings.error("field.flag", where, `${t} に「編集」は付けられない`);
     if (r.hide && (isHeaderRow(r) || isSpacerRow(r))) findings.error("field.flag", where, `${t} に「非表示」は付けられない`);
     if (r.state && r.formulaSet && isLookupRow(r)) findings.warning("field.lookup", where, "ルックアップ項目に計算式（ルックアップの値を上書きする）");
@@ -6494,12 +6514,33 @@ var TRY_MAX_FORMULA_CHARS = 4e3;
 var TRY_DEFAULT_AS = "TEXT";
 var TRY_OWN_RULES = /* @__PURE__ */ new Set(["misc.changed", "fieldno.screen", "size.bytes", "schema.derived"]);
 var isTable2 = (v) => Array.isArray(v) && v.every((r) => r && typeof r === "object" && "value" in r);
+function spacersOf(fields) {
+  const out = [];
+  const walk = (rows) => {
+    for (const row of rows) {
+      if (row.type === "GROUP" && Array.isArray(row.layout)) {
+        walk(row.layout);
+        continue;
+      }
+      for (const f of row.fields ?? []) if (f.type === "SPACER" && typeof f.elementId === "string" && f.elementId) out.push(f.elementId);
+    }
+  };
+  walk(fields.layout);
+  return out;
+}
 function resolveTryTarget(fields, targetTypes, as, table, referenced = /* @__PURE__ */ new Set()) {
   const props = fields.properties;
   const tables = Object.values(props).filter((p) => p.type === "SUBTABLE").map((p) => p.code).sort();
   const want = (as ?? TRY_DEFAULT_AS).trim();
   if (!want) throw new InputError("as が空（型 NUMBER / TEXT / DATE … か項目コード）");
   const upper = want.toUpperCase();
+  const spacers = spacersOf(fields);
+  const spacer = upper === "SPACER" || upper === "SPACE" ? spacers[0] : spacers.find((id) => id === want || `(${id})` === want);
+  if (upper === "SPACER" || upper === "SPACE" || spacer !== void 0) {
+    if (table !== void 0) throw new InputError("スペース項目はテーブルの中に置けない（table を外す）");
+    if (spacer === void 0) throw new InputError("サンプルアプリに要素 ID のあるスペース項目が無い");
+    return { code: `(${spacer})`, type: "SPACER", elementId: spacer };
+  }
   const type = TYPE_ALIASES[upper] ?? (targetTypes.has(upper) ? upper : void 0);
   let scope = props;
   let tableCode;
@@ -6550,6 +6591,16 @@ function buildTryEnvelope(engine, fields, code, formula, lang) {
     pluginInfos: [{ fieldcode: code, state: true, formulaSet: formula, edit: false, hide: false, rank: "" }]
   };
 }
+function normalizedMarks(n, code) {
+  const scan = n.scans.get(code);
+  if (!scan) return [];
+  const used = Object.keys(scan.functions);
+  const marks = [];
+  if (used.some((f) => /^(UINFO|OINFO|GINFO|OUSERS|GUSERS)$/.test(f))) marks.push("ユーザー情報は既定のテストデータ（架空）で計算（実機では変わる）");
+  if (used.includes("EV_INFO")) marks.push("イベントに依る");
+  if (used.some((f) => /^(RAND|RANDBETWEEN|NOW|TODAY|UUID)$/.test(f))) marks.push("再計算で変わる");
+  return marks;
+}
 function plain(v) {
   try {
     const s = JSON.stringify(v);
@@ -6711,6 +6762,23 @@ async function trySettings(input) {
     }
     contextLine ||= c.contextLine;
     calcNotice ||= c.notice;
+    if (target.type === "SPACER") {
+      for (const r of c.records) {
+        const src = picked.find((p) => p.id === r.id);
+        engine.clearSinkCalls();
+        const raw = src ? rawValueOf(engine, n.saved.pluginPP, structuredClone(src.record), stripped, target, input.evType, input.event) : null;
+        const v = { record: r.id, value: raw };
+        if (engine.sinkCalls().length) {
+          v.failed = true;
+          v.error = `実行時の sink が呼ばれた: ${engine.sinkCalls().map((s) => `${s.sink} ${s.detail}`.trim()).join(", ")}`;
+          res.status = "failed";
+        }
+        engine.clearSinkCalls();
+        res.values.push(v);
+      }
+      res.marks = [...normalizedMarks(n, target.code), "スペース項目（返り値をそのまま。表示は実機で）"];
+      continue;
+    }
     const lineCode = target.table ?? target.code;
     for (const r of c.records) {
       const line = r.lines.find((l) => l.fieldcode === lineCode);
@@ -6743,7 +6811,7 @@ async function trySettings(input) {
   if (extraFields.length) text2.push(`足した項目（架空）: ${extraFields.join("、")}`);
   for (const r of picked) if (r.id.startsWith("d")) text2.push(`レコード ${r.id}: ${r.label}`);
   for (const r of results) {
-    const head = r.target ? `${r.target.code}（${r.target.type}${r.target.table ? `。${r.target.table} の中` : ""}）← ` : "";
+    const head = r.target ? `${r.target.type === "SPACER" ? `スペース項目 ${r.target.elementId}` : r.target.code}（${r.target.type}${r.target.table ? `。${r.target.table} の中` : ""}）← ` : "";
     text2.push(`[${r.index}] ${head}${r.formula.replace(/\s*\n\s*/g, " ")}`);
     for (const v of r.values) text2.push(`    レコード ${v.record}: ${short2(v.value)}${v.raw !== void 0 ? `（生の値 ${short2(v.raw)}）` : ""}${v.error ? `  ！ ${v.error}` : ""}${v.failed ? "  ！ 結果を採らない（実行時の sink）" : ""}`);
     if (r.marks.length) text2.push(`    印: ${r.marks.join("、")}`);
@@ -6945,7 +7013,7 @@ var USAGE = `使い方: npx @rex0220/formula-authoring-tools <command> [options]
       [--fields '<JSON>'] [--data '<JSON>'] [--base 3] [--app N]
                                             同梱のサンプルアプリ（全項目タイプ × 2、テーブル 2 つ、レコード 3 件 = 典型 / 端 / 空）に 1 行だけの設定を組んで
                                             検査と模擬の計算（関数の使い方や式の断片を確かめる。利用者のアプリは使わない）。--as は型（NUMBER / TEXT / DATE …。
-                                            既定 TEXT = 文字列 1 行）か項目コード、テーブルの中で計算するなら --table テーブル1。
+                                            既定 TEXT = 文字列 1 行）か項目コード、テーブルの中で計算するなら --table テーブル1。スペース項目は --as sp1（返り値をそのまま）。
                                             --fields '[{"code":"単価","type":"NUMBER"},{"code":"分類","type":"DROP_DOWN","options":["明細","小計"]}]' で項目を足す、
                                             --data '[{"単価":100,"テーブル1":[{"T1_数値":1}]}]' で架空の値のレコード（土台は --base の標本。既定 3 = 空）、
                                             --app N で利用者のアプリの項目定義（fields/N.json かアプリのフォルダー）に --data の架空の値を当てる

package/dist/core.mjs

@@ -1,4 +1,4 @@
-/*! @rex0220/formula-authoring-tools/core 0.3.0 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit cfbd850. */
+/*! @rex0220/formula-authoring-tools/core 0.3.1 (c) rex0220. MIT License. 計算式エンジンと計算式プラグインのコードは利用者の計算式プラグインプラグインの zip から読む（このファイルには含まれない）。commit 3788114. */
 
 // src/safe-path.ts
 import { lstatSync, realpathSync } from "node:fs";
@@ -190,7 +190,7 @@ function devMeta() {
   return { toolsVersion: pkg.version, pluginId: FORMULA_PLUGIN_ID, minPluginVersion: MIN_PLUGIN_VERSION, supportedApiVersions: [...SUPPORTED_API_VERSIONS], commit: gitCommit(AUTHORING_ROOT), builtAt: "", mode: "dev" };
 }
 function toolsMeta() {
-  if (true) return JSON.parse('{"toolsVersion":"0.3.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"cfbd850","builtAt":"2026-10-18T05:24:49.527Z","mode":"build"}');
+  if (true) return JSON.parse('{"toolsVersion":"0.3.1","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"3788114","builtAt":"2026-10-18T08:08:27.541Z","mode":"build"}');
   return devMeta();
 }
 
@@ -2078,7 +2078,7 @@ async function normalizeSettings(input) {
   for (const r of rows) {
     const where = `${file} ${r.fieldcode}`;
     const t = typeOf(r);
-    if (r.formulaSet && r.formulaSet.trim() && !targetTypes.has(t)) findings.error("field.type", where, `${t} の項目には計算式を設定できない`);
+    if (r.formulaSet && r.formulaSet.trim() && !targetTypes.has(t) && !isSpacerRow(r) && !isHeaderRow(r)) findings.error("field.type", where, `${t} の項目には計算式を設定できない`);
     if (r.edit && (isHeaderRow(r) || isSpacerRow(r) || isGroupRow(r))) findings.error("field.flag", where, `${t} に「編集」は付けられない`);
     if (r.hide && (isHeaderRow(r) || isSpacerRow(r))) findings.error("field.flag", where, `${t} に「非表示」は付けられない`);
     if (r.state && r.formulaSet && isLookupRow(r)) findings.warning("field.lookup", where, "ルックアップ項目に計算式（ルックアップの値を上書きする）");
@@ -4269,6 +4269,14 @@ var fields_default = {
             width: "250",
             innerHeight: "125"
           }
+        },
+        {
+          type: "SPACER",
+          elementId: "sp1",
+          size: {
+            width: "458",
+            height: "163"
+          }
         }
       ]
     },
@@ -4654,14 +4662,14 @@ var fields_default = {
           type: "RADIO_BUTTON",
           code: "T1_ラジオ",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
           type: "CHECK_BOX",
           code: "T1_チェック",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
@@ -4675,7 +4683,7 @@ var fields_default = {
           type: "DROP_DOWN",
           code: "T1_ドロップダウン",
           size: {
-            width: "150"
+            width: "158"
           }
         },
         {
@@ -4781,14 +4789,14 @@ var fields_default = {
           type: "RADIO_BUTTON",
           code: "T2_ラジオ",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
           type: "CHECK_BOX",
           code: "T2_チェック",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
@@ -4802,7 +4810,7 @@ var fields_default = {
           type: "DROP_DOWN",
           code: "T2_ドロップダウン",
           size: {
-            width: "150"
+            width: "158"
           }
         },
         {
@@ -6196,6 +6204,17 @@ var SAMPLE_APP = {
 function sampleApp() {
   return structuredClone(SAMPLE_APP);
 }
+function spacerIds(layout) {
+  const out = [];
+  for (const row of layout) {
+    if (row.type === "GROUP" && Array.isArray(row.layout)) {
+      out.push(...spacerIds(row.layout));
+      continue;
+    }
+    for (const f of row.fields ?? []) if (f.type === "SPACER" && typeof f.elementId === "string" && f.elementId) out.push(f.elementId);
+  }
+  return out;
+}
 var tableRows = (record, code) => {
   const v = record[code]?.value;
   return Array.isArray(v) ? v.length : 0;
@@ -6210,6 +6229,7 @@ function describeSampleApp(targetTypes) {
     "項目（1 項目 1 行。○ = 計算式を設定できる型。テーブルの子は T1_ / T2_ の接頭辞）:",
     listFields(fields, { targetTypes }),
     "",
+    `スペース項目（要素 ID。as に要素 ID か SPACER。レコードに値は無く、式の返り値をそのまま返す）: ${spacerIds(fields.layout).join(", ") || "無し"}`,
     "レコード（try の records で選ぶ。既定は 3 件とも）:",
     ...records.map((r) => `  ${r.id}: ${r.label}。${tables.map((t) => `${t} ${tableRows(r.record, t)} 行`).join("、")}`),
     "ユーザー・組織・グループの値は既定のテストデータ（架空の 10 人。demo_user01 …）のコード"
@@ -6631,12 +6651,33 @@ var TRY_MAX_FORMULA_CHARS = 4e3;
 var TRY_DEFAULT_AS = "TEXT";
 var TRY_OWN_RULES = /* @__PURE__ */ new Set(["misc.changed", "fieldno.screen", "size.bytes", "schema.derived"]);
 var isTable2 = (v) => Array.isArray(v) && v.every((r) => r && typeof r === "object" && "value" in r);
+function spacersOf(fields) {
+  const out = [];
+  const walk = (rows) => {
+    for (const row of rows) {
+      if (row.type === "GROUP" && Array.isArray(row.layout)) {
+        walk(row.layout);
+        continue;
+      }
+      for (const f of row.fields ?? []) if (f.type === "SPACER" && typeof f.elementId === "string" && f.elementId) out.push(f.elementId);
+    }
+  };
+  walk(fields.layout);
+  return out;
+}
 function resolveTryTarget(fields, targetTypes, as, table, referenced = /* @__PURE__ */ new Set()) {
   const props = fields.properties;
   const tables = Object.values(props).filter((p) => p.type === "SUBTABLE").map((p) => p.code).sort();
   const want = (as ?? TRY_DEFAULT_AS).trim();
   if (!want) throw new InputError("as が空（型 NUMBER / TEXT / DATE … か項目コード）");
   const upper = want.toUpperCase();
+  const spacers = spacersOf(fields);
+  const spacer = upper === "SPACER" || upper === "SPACE" ? spacers[0] : spacers.find((id) => id === want || `(${id})` === want);
+  if (upper === "SPACER" || upper === "SPACE" || spacer !== void 0) {
+    if (table !== void 0) throw new InputError("スペース項目はテーブルの中に置けない（table を外す）");
+    if (spacer === void 0) throw new InputError("サンプルアプリに要素 ID のあるスペース項目が無い");
+    return { code: `(${spacer})`, type: "SPACER", elementId: spacer };
+  }
   const type = TYPE_ALIASES[upper] ?? (targetTypes.has(upper) ? upper : void 0);
   let scope = props;
   let tableCode;
@@ -6687,6 +6728,16 @@ function buildTryEnvelope(engine, fields, code, formula, lang) {
     pluginInfos: [{ fieldcode: code, state: true, formulaSet: formula, edit: false, hide: false, rank: "" }]
   };
 }
+function normalizedMarks(n, code) {
+  const scan = n.scans.get(code);
+  if (!scan) return [];
+  const used = Object.keys(scan.functions);
+  const marks = [];
+  if (used.some((f) => /^(UINFO|OINFO|GINFO|OUSERS|GUSERS)$/.test(f))) marks.push("ユーザー情報は既定のテストデータ（架空）で計算（実機では変わる）");
+  if (used.includes("EV_INFO")) marks.push("イベントに依る");
+  if (used.some((f) => /^(RAND|RANDBETWEEN|NOW|TODAY|UUID)$/.test(f))) marks.push("再計算で変わる");
+  return marks;
+}
 function plain(v) {
   try {
     const s = JSON.stringify(v);
@@ -6848,6 +6899,23 @@ async function trySettings(input) {
     }
     contextLine ||= c.contextLine;
     calcNotice ||= c.notice;
+    if (target.type === "SPACER") {
+      for (const r of c.records) {
+        const src = picked.find((p) => p.id === r.id);
+        engine.clearSinkCalls();
+        const raw = src ? rawValueOf(engine, n.saved.pluginPP, structuredClone(src.record), stripped, target, input.evType, input.event) : null;
+        const v = { record: r.id, value: raw };
+        if (engine.sinkCalls().length) {
+          v.failed = true;
+          v.error = `実行時の sink が呼ばれた: ${engine.sinkCalls().map((s) => `${s.sink} ${s.detail}`.trim()).join(", ")}`;
+          res.status = "failed";
+        }
+        engine.clearSinkCalls();
+        res.values.push(v);
+      }
+      res.marks = [...normalizedMarks(n, target.code), "スペース項目（返り値をそのまま。表示は実機で）"];
+      continue;
+    }
     const lineCode = target.table ?? target.code;
     for (const r of c.records) {
       const line = r.lines.find((l) => l.fieldcode === lineCode);
@@ -6880,7 +6948,7 @@ async function trySettings(input) {
   if (extraFields.length) text2.push(`足した項目（架空）: ${extraFields.join("、")}`);
   for (const r of picked) if (r.id.startsWith("d")) text2.push(`レコード ${r.id}: ${r.label}`);
   for (const r of results) {
-    const head = r.target ? `${r.target.code}（${r.target.type}${r.target.table ? `。${r.target.table} の中` : ""}）← ` : "";
+    const head = r.target ? `${r.target.type === "SPACER" ? `スペース項目 ${r.target.elementId}` : r.target.code}（${r.target.type}${r.target.table ? `。${r.target.table} の中` : ""}）← ` : "";
     text2.push(`[${r.index}] ${head}${r.formula.replace(/\s*\n\s*/g, " ")}`);
     for (const v of r.values) text2.push(`    レコード ${v.record}: ${short2(v.value)}${v.raw !== void 0 ? `（生の値 ${short2(v.raw)}）` : ""}${v.error ? `  ！ ${v.error}` : ""}${v.failed ? "  ！ 結果を採らない（実行時の sink）" : ""}`);
     if (r.marks.length) text2.push(`    印: ${r.marks.join("、")}`);
@@ -7524,6 +7592,7 @@ export {
   shapeLines,
   snapshotNameOf,
   snapshotOf,
+  spacersOf,
   stronglyConnected,
   summarizeFields,
   summarizeRecord,

package/dist/eval-worker.mjs

@@ -93,7 +93,7 @@ function devMeta() {
   return { toolsVersion: pkg.version, pluginId: FORMULA_PLUGIN_ID, minPluginVersion: MIN_PLUGIN_VERSION, supportedApiVersions: [...SUPPORTED_API_VERSIONS], commit: gitCommit(AUTHORING_ROOT), builtAt: "", mode: "dev" };
 }
 function toolsMeta() {
-  if (true) return JSON.parse('{"toolsVersion":"0.3.0","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"cfbd850","builtAt":"2026-10-18T05:24:49.527Z","mode":"build"}');
+  if (true) return JSON.parse('{"toolsVersion":"0.3.1","pluginId":"dhgihghfgfmibkdldkeibboabfnmdpke","minPluginVersion":101,"supportedApiVersions":[1],"commit":"3788114","builtAt":"2026-10-18T08:08:27.541Z","mode":"build"}');
   return devMeta();
 }
 
@@ -996,7 +996,7 @@ async function normalizeSettings(input) {
   for (const r of rows) {
     const where = `${file} ${r.fieldcode}`;
     const t = typeOf(r);
-    if (r.formulaSet && r.formulaSet.trim() && !targetTypes.has(t)) findings.error("field.type", where, `${t} の項目には計算式を設定できない`);
+    if (r.formulaSet && r.formulaSet.trim() && !targetTypes.has(t) && !isSpacerRow(r) && !isHeaderRow(r)) findings.error("field.type", where, `${t} の項目には計算式を設定できない`);
     if (r.edit && (isHeaderRow(r) || isSpacerRow(r) || isGroupRow(r))) findings.error("field.flag", where, `${t} に「編集」は付けられない`);
     if (r.hide && (isHeaderRow(r) || isSpacerRow(r))) findings.error("field.flag", where, `${t} に「非表示」は付けられない`);
     if (r.state && r.formulaSet && isLookupRow(r)) findings.warning("field.lookup", where, "ルックアップ項目に計算式（ルックアップの値を上書きする）");
@@ -2319,6 +2319,14 @@ var fields_default = {
             width: "250",
             innerHeight: "125"
           }
+        },
+        {
+          type: "SPACER",
+          elementId: "sp1",
+          size: {
+            width: "458",
+            height: "163"
+          }
         }
       ]
     },
@@ -2704,14 +2712,14 @@ var fields_default = {
           type: "RADIO_BUTTON",
           code: "T1_ラジオ",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
           type: "CHECK_BOX",
           code: "T1_チェック",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
@@ -2725,7 +2733,7 @@ var fields_default = {
           type: "DROP_DOWN",
           code: "T1_ドロップダウン",
           size: {
-            width: "150"
+            width: "158"
           }
         },
         {
@@ -2831,14 +2839,14 @@ var fields_default = {
           type: "RADIO_BUTTON",
           code: "T2_ラジオ",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
           type: "CHECK_BOX",
           code: "T2_チェック",
           size: {
-            width: "150"
+            width: "227"
           }
         },
         {
@@ -2852,7 +2860,7 @@ var fields_default = {
           type: "DROP_DOWN",
           code: "T2_ドロップダウン",
           size: {
-            width: "150"
+            width: "158"
           }
         },
         {
@@ -4661,12 +4669,33 @@ var TRY_MAX_FORMULA_CHARS = 4e3;
 var TRY_DEFAULT_AS = "TEXT";
 var TRY_OWN_RULES = /* @__PURE__ */ new Set(["misc.changed", "fieldno.screen", "size.bytes", "schema.derived"]);
 var isTable2 = (v) => Array.isArray(v) && v.every((r) => r && typeof r === "object" && "value" in r);
+function spacersOf(fields) {
+  const out = [];
+  const walk = (rows) => {
+    for (const row of rows) {
+      if (row.type === "GROUP" && Array.isArray(row.layout)) {
+        walk(row.layout);
+        continue;
+      }
+      for (const f of row.fields ?? []) if (f.type === "SPACER" && typeof f.elementId === "string" && f.elementId) out.push(f.elementId);
+    }
+  };
+  walk(fields.layout);
+  return out;
+}
 function resolveTryTarget(fields, targetTypes, as, table, referenced = /* @__PURE__ */ new Set()) {
   const props = fields.properties;
   const tables = Object.values(props).filter((p) => p.type === "SUBTABLE").map((p) => p.code).sort();
   const want = (as ?? TRY_DEFAULT_AS).trim();
   if (!want) throw new InputError("as が空（型 NUMBER / TEXT / DATE … か項目コード）");
   const upper = want.toUpperCase();
+  const spacers = spacersOf(fields);
+  const spacer = upper === "SPACER" || upper === "SPACE" ? spacers[0] : spacers.find((id) => id === want || `(${id})` === want);
+  if (upper === "SPACER" || upper === "SPACE" || spacer !== void 0) {
+    if (table !== void 0) throw new InputError("スペース項目はテーブルの中に置けない（table を外す）");
+    if (spacer === void 0) throw new InputError("サンプルアプリに要素 ID のあるスペース項目が無い");
+    return { code: `(${spacer})`, type: "SPACER", elementId: spacer };
+  }
   const type = TYPE_ALIASES[upper] ?? (targetTypes.has(upper) ? upper : void 0);
   let scope = props;
   let tableCode;
@@ -4717,6 +4746,16 @@ function buildTryEnvelope(engine, fields, code, formula, lang) {
     pluginInfos: [{ fieldcode: code, state: true, formulaSet: formula, edit: false, hide: false, rank: "" }]
   };
 }
+function normalizedMarks(n, code) {
+  const scan = n.scans.get(code);
+  if (!scan) return [];
+  const used = Object.keys(scan.functions);
+  const marks = [];
+  if (used.some((f) => /^(UINFO|OINFO|GINFO|OUSERS|GUSERS)$/.test(f))) marks.push("ユーザー情報は既定のテストデータ（架空）で計算（実機では変わる）");
+  if (used.includes("EV_INFO")) marks.push("イベントに依る");
+  if (used.some((f) => /^(RAND|RANDBETWEEN|NOW|TODAY|UUID)$/.test(f))) marks.push("再計算で変わる");
+  return marks;
+}
 function plain(v) {
   try {
     const s = JSON.stringify(v);
@@ -4878,6 +4917,23 @@ async function trySettings(input) {
     }
     contextLine ||= c.contextLine;
     calcNotice ||= c.notice;
+    if (target.type === "SPACER") {
+      for (const r of c.records) {
+        const src = picked.find((p) => p.id === r.id);
+        engine.clearSinkCalls();
+        const raw = src ? rawValueOf(engine, n.saved.pluginPP, structuredClone(src.record), stripped, target, input.evType, input.event) : null;
+        const v = { record: r.id, value: raw };
+        if (engine.sinkCalls().length) {
+          v.failed = true;
+          v.error = `実行時の sink が呼ばれた: ${engine.sinkCalls().map((s) => `${s.sink} ${s.detail}`.trim()).join(", ")}`;
+          res.status = "failed";
+        }
+        engine.clearSinkCalls();
+        res.values.push(v);
+      }
+      res.marks = [...normalizedMarks(n, target.code), "スペース項目（返り値をそのまま。表示は実機で）"];
+      continue;
+    }
     const lineCode = target.table ?? target.code;
     for (const r of c.records) {
       const line = r.lines.find((l) => l.fieldcode === lineCode);
@@ -4910,7 +4966,7 @@ async function trySettings(input) {
   if (extraFields.length) text2.push(`足した項目（架空）: ${extraFields.join("、")}`);
   for (const r of picked) if (r.id.startsWith("d")) text2.push(`レコード ${r.id}: ${r.label}`);
   for (const r of results) {
-    const head = r.target ? `${r.target.code}（${r.target.type}${r.target.table ? `。${r.target.table} の中` : ""}）← ` : "";
+    const head = r.target ? `${r.target.type === "SPACER" ? `スペース項目 ${r.target.elementId}` : r.target.code}（${r.target.type}${r.target.table ? `。${r.target.table} の中` : ""}）← ` : "";
     text2.push(`[${r.index}] ${head}${r.formula.replace(/\s*\n\s*/g, " ")}`);
     for (const v of r.values) text2.push(`    レコード ${v.record}: ${short2(v.value)}${v.raw !== void 0 ? `（生の値 ${short2(v.raw)}）` : ""}${v.error ? `  ！ ${v.error}` : ""}${v.failed ? "  ！ 結果を採らない（実行時の sink）" : ""}`);
     if (r.marks.length) text2.push(`    印: ${r.marks.join("、")}`);

package/dist/types/commands/try.d.ts

@@ -7,6 +7,8 @@
  *   - 対象は式が参照していない項目を選ぶ（数値1 を使う式なら 数値2）。自己参照になるときのために、1 行の設定は各種設定の circular_refer を ON にして組む（設定画面の検査だけの決まり）
  *   - 文脈は calc と同じ（イベント、ログインユーザー、mobile、ユーザー情報のテストデータ、policy の allowFunctions）。APP_URL はサンプルアプリの接続先（既定の例の URL）で評価する
  *   - 走査の上の制限（副作用のある関数は policy の承認、EV_SET は不可）も calc と同じ。結果を採らない sink も同じ
+ *   - スペース項目（レイアウトの SPACER で要素 ID のあるもの。設定画面の行はフィールドコード "(要素ID)"）も対象にできる（as: "SPACER" か要素 ID）。レコードに値が無いので calc は通らず、
+ *     実機のスペースの処理と同じく式を評価した返り値（ARRAY(ラベル, 書式, 値, 書式) や HTML）をそのまま返す。表示は実機で（計画 25.5。2026-10-18 Takashi）
  *   - 架空の項目と値（try-data.ts。計画 25.3）: fields で標本に項目を足す（案 2）、data で簡略形の値のレコードを作る（案 1。土台は標本の base = 3 の空のレコード）、
  *     appFields で利用者のアプリの項目定義に架空の値（案 3。標本のレコードは使わない。data が要る）
  */
@@ -32,6 +34,8 @@ export interface TryTarget {
     code: string;
     type: string;
     table?: string;
+    /** スペース項目のとき（type "SPACER"）の要素 ID。code は "(要素ID)" */
+    elementId?: string;
 }
 export interface TryValue {
     /** レコード（標本は "1"〜"3"、架空の値は "d1"〜） */
@@ -102,9 +106,11 @@ export interface TryResult {
     summary: string;
     text: string;
 }
+/** レイアウトのスペース項目（要素 ID のあるもの。グループ枠の中も）。設定画面の行と同じ順 */
+export declare function spacersOf(fields: FieldsFile): string[];
 /**
  * 対象の項目を決める（型か項目コード、テーブルの中かどうか）。型のときは、式が参照していない項目を優先し、短いコードの順で最初（文字列1、数値1 …。数値1 を使う式なら 数値2）。
- * referenced は式の識別子（scanFormula）
+ * referenced は式の識別子（scanFormula）。スペース項目は as: "SPACER"（最初の要素 ID）か要素 ID（"sp1" / "(sp1)"）
  */
 export declare function resolveTryTarget(fields: FieldsFile, targetTypes: ReadonlySet<string>, as: string | undefined, table: string | undefined, referenced?: ReadonlySet<string>): TryTarget;
 /**

package/dist/types/core.d.ts

@@ -29,7 +29,7 @@ export { normalizeSettings, findCycles, stronglyConnected, type ContextNeeds, ty
 export { DEFAULT_EVENT, EVENT_RE, RECORDS_MAX, calcSettings, validateEvent, type CalcInput, type CalcLine, type CalcRecordResult, type CalcResult } from "./commands/calc.ts";
 export { takeInbox, type TakeResult } from "./commands/take.ts";
 export { SAMPLE_APP, describeSampleApp, sampleApp, type SampleApp, type SampleRecord } from "./sample-app.ts";
-export { TRY_DEFAULT_AS, TRY_MAX_FORMULAS, TRY_MAX_FORMULA_CHARS, buildTryEnvelope, resolveTryTarget, trySettings, type TryFormula, type TryFormulaResult, type TryInput, type TryResult, type TryTarget, type TryValue } from "./commands/try.ts";
+export { TRY_DEFAULT_AS, TRY_MAX_FORMULAS, TRY_MAX_FORMULA_CHARS, buildTryEnvelope, resolveTryTarget, spacersOf, trySettings, type TryFormula, type TryFormulaResult, type TryInput, type TryResult, type TryTarget, type TryValue } from "./commands/try.ts";
 export { EXTRA_TYPES, TRY_MAX_DATA, TRY_MAX_EXTRA_FIELDS, TRY_MAX_OPTIONS, TRY_MAX_TABLE_ROWS, TRY_MAX_VALUE_CHARS, TYPE_ALIASES, applyData, canonicalType, checkDataList, convertValue, emptyRecordOf, extendFields, normalizeDefaults, type TryData, type TryFieldDef } from "./commands/try-data.ts";
 export { COMMON_KEYS, MAX_SAVE_INPUT_BYTES, MAX_UPDATE_ROWS, connectionStatusOf, digestOf, saveNewSettings, updateFields, type EvalSource, type SaveContext, type SaveResult, type SaveStatus } from "./commands/save.ts";
 export { DEFAULT_POLICY, POLICY_FILE, PolicyError, loadPolicy, parsePolicy, type Policy } from "./normalize/policy.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex0220/formula-authoring-tools",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "rex0220 計算式プラグイン（kintone）の設定を AI で作るための CLI。利用者のプラグインの zip から authoring API と計算式エンジンを読んで Node で動く",
   "license": "MIT",
   "type": "module",