fieldsmith 0.1.0

package/dist/spec/layout.js

@@ -0,0 +1,215 @@
+/**
+ * フォームレイアウトの組み立て。
+ *
+ * kintone にフィールドを追加すると、既定では 1 行に 1 つずつ縦に並ぶ。
+ * 似た性質のフィールドを横に並べたほうが、記入する人にとって見通しが良い。
+ *
+ * まとめ方の基準は 2 段構え。
+ *   1. フィールドに `group` (「書誌情報」「貸出」など意味のまとまり) があればそれを使う
+ *   2. 無ければフィールド型の系統で代用する
+ *
+ * `group` は意味の判断が要るので、`plan` / `create` ではモデルが付ける。
+ * デプロイ層は付いた結果を使うだけで、判断はしない。
+ *
+ * どちらの場合も **並び順は変えない**ので、AppSpec に書いた順序の意図は保たれる。
+ */
+/**
+ * フィールドの系統。同じ系統どうしだけを横に並べる。
+ * ここに無い型 (複数行テキスト、リッチエディター、添付ファイルなど) は
+ * 幅を取るか背が高くなるため、常に単独行にする。
+ */
+const FIELD_FAMILY = {
+    SINGLE_LINE_TEXT: "テキスト",
+    LINK: "テキスト",
+    NUMBER: "数値",
+    CALC: "数値",
+    DROP_DOWN: "選択",
+    RADIO_BUTTON: "選択",
+    CHECK_BOX: "選択",
+    MULTI_SELECT: "選択",
+    DATE: "日時",
+    TIME: "日時",
+    DATETIME: "日時",
+    USER_SELECT: "ユーザー",
+    ORGANIZATION_SELECT: "ユーザー",
+    GROUP_SELECT: "ユーザー",
+    RECORD_NUMBER: "自動項目",
+    CREATOR: "自動項目",
+    MODIFIER: "自動項目",
+    CREATED_TIME: "自動項目",
+    UPDATED_TIME: "自動項目",
+};
+/** 1 行にまとめられる上限の既定値。 */
+export const DEFAULT_MAX_PER_ROW = 3;
+/** そのフィールドが属する系統。単独行にすべきものは null。 */
+export function familyOf(type) {
+    return FIELD_FAMILY[type] ?? null;
+}
+/**
+ * そのフィールドをまとめる基準。単独行にすべきものは null。
+ *
+ * 幅や高さを取る型は、意味のまとまりがあっても横に並べない
+ * (見た目の制約は意味とは別の話なので)。
+ */
+export function groupKeyOf(field, groups = {}) {
+    const family = familyOf(field.type);
+    if (family === null)
+        return null;
+    const group = groups[field.code];
+    return group === undefined || group === "" ? family : `group:${group}`;
+}
+/**
+ * フィールドの並びを、系統ごとに最大 maxPerRow 個までの行にまとめる。
+ *
+ * 並び順は保つ。系統が変わったところ、単独行にすべき型が来たところ、
+ * 上限に達したところで行を切る。
+ */
+export function groupIntoRows(fields, options = {}) {
+    const maxPerRow = Math.max(1, options.maxPerRow ?? DEFAULT_MAX_PER_ROW);
+    const rows = [];
+    let current = [];
+    let currentFamily = null;
+    const flush = () => {
+        if (current.length > 0)
+            rows.push(current);
+        current = [];
+        currentFamily = null;
+    };
+    for (const field of fields) {
+        const key = groupKeyOf(field, options.groups);
+        // 単独行にすべき型は、前後と混ぜずにそれだけの行にする。
+        if (key === null) {
+            flush();
+            rows.push([field]);
+            continue;
+        }
+        if (key !== currentFamily || current.length >= maxPerRow) {
+            flush();
+            currentFamily = key;
+        }
+        current.push(field);
+    }
+    flush();
+    return rows;
+}
+/**
+ * kintone から取得した既存のレイアウトを並べ替える。
+ *
+ * GROUP と SUBTABLE の行はそのまま残す (中身の構造が別なので触らない)。
+ * 連続する ROW だけをいったん平らにして、系統ごとにまとめ直す。
+ */
+export function regroupLayout(layout, options = {}) {
+    const result = [];
+    let pending = [];
+    const flushPending = () => {
+        for (const row of groupIntoRows(pending, options)) {
+            result.push({ type: "ROW", fields: row });
+        }
+        pending = [];
+    };
+    for (const row of layout) {
+        if (row.type === "ROW") {
+            const fields = row.fields;
+            if (Array.isArray(fields)) {
+                pending.push(...fields);
+            }
+            continue;
+        }
+        // GROUP / SUBTABLE の前後で行の連続は途切れる。
+        flushPending();
+        result.push(row);
+    }
+    flushPending();
+    return result;
+}
+/** 並べ替えの結果を人が読める形にする (--dry-run と進捗表示で使う)。 */
+export function describeRows(rows) {
+    return rows.map((row) => row.map((field) => field.code).join(" | "));
+}
+/**
+ * 削除候補グループのフィールドコード。
+ * 毎回同じコードを使うことで、更新を繰り返してもグループが増えない。
+ */
+export const ORPHAN_GROUP_CODE = "_削除候補";
+export const ORPHAN_GROUP_LABEL = "削除候補";
+/** レイアウトから、そのフィールドコードを取り除く。空になった行は落とす。 */
+function withoutFields(layout, remove) {
+    const result = [];
+    for (const row of layout) {
+        if (row.type === "ROW") {
+            const fields = (row.fields ?? []).filter((field) => !remove.has(field.code));
+            if (fields.length > 0)
+                result.push({ type: "ROW", fields });
+            continue;
+        }
+        if (row.type === "GROUP") {
+            const nested = withoutFields((row.layout ?? []), remove);
+            result.push({ ...row, type: "GROUP", layout: nested });
+            continue;
+        }
+        result.push(row);
+    }
+    return result;
+}
+/** レイアウトに載っているフィールドを、入れ子も含めて集める。 */
+export function collectLayoutFields(layout) {
+    const fields = [];
+    for (const row of layout) {
+        const own = row.fields;
+        if (row.type === "ROW" && Array.isArray(own))
+            fields.push(...own);
+        const nested = row.layout;
+        if (Array.isArray(nested))
+            fields.push(...collectLayoutFields(nested));
+    }
+    return fields;
+}
+/**
+ * 更新後のフォームレイアウトを組み立てる。
+ *
+ * レイアウト変更 API は「フォーム上のすべてのフィールド」の指定を求めるので、
+ * 現在のレイアウトを起点に、載せ替えと退避を行う。
+ *
+ * 削除候補のフィールドは**消さずに**、畳んだグループへ移す。
+ * 逆に、削除候補グループの中にあったフィールドが目標に戻ってきたら、外に出す。
+ */
+export function buildUpdatedLayout(input) {
+    const orphans = new Set(input.orphans);
+    const desiredCodes = new Set(input.desired.map((field) => field.code));
+    // 既存の削除候補グループの中身を把握する。目標に戻ったものは外へ出す。
+    const existingGroup = input.current.find((row) => row.type === "GROUP" && row.code === ORPHAN_GROUP_CODE);
+    const parked = existingGroup === undefined
+        ? []
+        : collectLayoutFields((existingGroup.layout ?? []));
+    const revived = parked.filter((field) => desiredCodes.has(field.code));
+    // 型が分かるように、退避するフィールドの情報を現在のレイアウトから拾っておく。
+    const known = new Map(collectLayoutFields(input.current).map((field) => [field.code, field]));
+    // 削除候補グループと、そこへ入るもの・戻るものを、いったん全部どかす。
+    const removed = new Set([...orphans, ...parked.map((field) => field.code)]);
+    let base = withoutFields(input.current.filter((row) => !(row.type === "GROUP" && row.code === ORPHAN_GROUP_CODE)), removed);
+    if (input.regroup) {
+        // ROW は目標の並びで作り直す。GROUP / SUBTABLE はそのまま残す。
+        const others = base.filter((row) => row.type !== "ROW");
+        const rows = groupIntoRows(input.desired.filter((field) => !orphans.has(field.code)), {
+            ...(input.maxPerRow === undefined ? {} : { maxPerRow: input.maxPerRow }),
+            ...(input.groups === undefined ? {} : { groups: input.groups }),
+        }).map((row) => ({ type: "ROW", fields: row }));
+        base = [...rows, ...others];
+    }
+    else {
+        // 手を触れない場合でも、戻ってきたフィールドは行として足す必要がある。
+        base = [...base, ...revived.map((field) => ({ type: "ROW", fields: [field] }))];
+    }
+    const parkedNow = [...orphans].map((code) => known.get(code) ?? { code, type: "SINGLE_LINE_TEXT" });
+    if (parkedNow.length === 0)
+        return base;
+    return [
+        ...base,
+        {
+            type: "GROUP",
+            code: ORPHAN_GROUP_CODE,
+            layout: parkedNow.map((field) => ({ type: "ROW", fields: [field] })),
+        },
+    ];
+}
+//# sourceMappingURL=layout.js.map

package/dist/spec/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/spec/layout.ts"],"names":[],"mappings":"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"}

package/dist/spec/toKintone.js

@@ -0,0 +1,170 @@
+import { BUILT_IN_FIELD_CODES, resolveFieldCode, } from "./appSpec.js";
+import { isOptionFieldType } from "./fieldSpec.js";
+export function toKintonePayloads(spec) {
+    return {
+        appName: spec.name,
+        properties: toFieldProperties(spec.fields),
+        settings: toAppSettings(spec),
+        views: spec.views === undefined ? null : toViews(spec.views),
+    };
+}
+/**
+ * FieldSpec[] を kintone の properties に変換する。
+ * properties のキーはフィールドコードと一致している必要がある。
+ */
+export function toFieldProperties(fields) {
+    const properties = {};
+    for (const field of fields) {
+        const code = resolveFieldCode(field);
+        properties[code] = toFieldProperty(field, code);
+    }
+    return properties;
+}
+function toFieldProperty(field, code) {
+    const property = {
+        type: field.type,
+        code,
+        label: field.label,
+    };
+    setIfDefined(property, "required", field.required);
+    setIfDefined(property, "unique", field.unique);
+    setIfDefined(property, "noLabel", field.noLabel);
+    if (isOptionFieldType(field.type)) {
+        const optionField = field;
+        property["options"] = toOptions(optionField.options);
+        if (optionField.defaultValue !== undefined) {
+            // kintone は複数選択系の defaultValue を配列で受け取る。
+            const multiSelect = field.type === "CHECK_BOX" || field.type === "MULTI_SELECT";
+            property["defaultValue"] = multiSelect
+                ? toArray(optionField.defaultValue)
+                : optionField.defaultValue;
+        }
+        return property;
+    }
+    switch (field.type) {
+        case "SINGLE_LINE_TEXT":
+            setIfDefined(property, "defaultValue", field.defaultValue);
+            setIfDefined(property, "minLength", toStringOrUndefined(field.minLength));
+            setIfDefined(property, "maxLength", toStringOrUndefined(field.maxLength));
+            break;
+        case "MULTI_LINE_TEXT":
+        case "RICH_TEXT":
+            setIfDefined(property, "defaultValue", field.defaultValue);
+            break;
+        case "NUMBER":
+            setIfDefined(property, "defaultValue", toStringOrUndefined(field.defaultValue));
+            setIfDefined(property, "minValue", toStringOrUndefined(field.minValue));
+            setIfDefined(property, "maxValue", toStringOrUndefined(field.maxValue));
+            setIfDefined(property, "digit", field.digit);
+            setIfDefined(property, "displayScale", toStringOrUndefined(field.displayScale));
+            setIfDefined(property, "unit", field.unit);
+            setIfDefined(property, "unitPosition", field.unitPosition);
+            break;
+        case "CALC":
+            property["expression"] = field.expression;
+            setIfDefined(property, "format", field.format);
+            setIfDefined(property, "displayScale", toStringOrUndefined(field.displayScale));
+            setIfDefined(property, "unit", field.unit);
+            setIfDefined(property, "unitPosition", field.unitPosition);
+            setIfDefined(property, "hideExpression", field.hideExpression);
+            break;
+        case "DATE":
+        case "TIME":
+        case "DATETIME":
+            setIfDefined(property, "defaultNowValue", field.defaultNowValue);
+            setIfDefined(property, "defaultValue", field.defaultValue);
+            break;
+        case "LINK":
+            property["protocol"] = field.protocol;
+            setIfDefined(property, "defaultValue", field.defaultValue);
+            setIfDefined(property, "maxLength", toStringOrUndefined(field.maxLength));
+            break;
+        case "USER_SELECT":
+        case "ORGANIZATION_SELECT":
+        case "GROUP_SELECT":
+            setIfDefined(property, "entities", field.entities);
+            setIfDefined(property, "defaultValue", field.defaultValue);
+            break;
+        case "FILE":
+            setIfDefined(property, "thumbnailSize", field.thumbnailSize);
+            break;
+    }
+    return property;
+}
+/**
+ * 選択肢の配列を kintone の options 形式に変換する。
+ * kintone は `{ ラベル: { label, index } }` を要求し、index は文字列でなければならない。
+ */
+export function toOptions(options) {
+    const result = {};
+    options.forEach((label, index) => {
+        result[label] = { label, index: String(index) };
+    });
+    return result;
+}
+/** 一般設定・アプリ説明・テーマを kintone の一般設定変更 API のパラメータに変換する。 */
+export function toAppSettings(spec) {
+    const settings = {};
+    setIfDefined(settings, "description", spec.description);
+    setIfDefined(settings, "theme", spec.theme);
+    const general = spec.settings;
+    if (general !== undefined) {
+        if (general.titleFieldCode !== undefined) {
+            settings["titleField"] = { selectionMode: "MANUAL", code: general.titleFieldCode };
+        }
+        setIfDefined(settings, "enableComments", general.enableComments);
+        setIfDefined(settings, "enableThumbnails", general.enableThumbnails);
+        setIfDefined(settings, "enableBulkDeletion", general.enableBulkDeletion);
+        setIfDefined(settings, "enableDuplicateRecord", general.enableDuplicateRecord);
+        setIfDefined(settings, "enableInlineRecordEditing", general.enableInlineRecordEditing);
+        setIfDefined(settings, "firstMonthOfFiscalYear", toStringOrUndefined(general.firstMonthOfFiscalYear));
+    }
+    return Object.keys(settings).length > 0 ? settings : null;
+}
+/**
+ * ViewSpec[] を kintone の views 形式に変換する。
+ * views のキーは一覧名で、index は表示順を表す文字列。
+ */
+export function toViews(views) {
+    const result = {};
+    views.forEach((view, index) => {
+        const entry = {
+            index: String(index),
+            type: view.type,
+            name: view.name,
+        };
+        if (view.type === "LIST") {
+            setIfDefined(entry, "fields", view.fields);
+        }
+        else {
+            setIfDefined(entry, "date", view.date);
+            setIfDefined(entry, "title", view.title);
+        }
+        setIfDefined(entry, "filterCond", view.filterCond);
+        setIfDefined(entry, "sort", view.sort);
+        setIfDefined(entry, "pager", view.pager);
+        setIfDefined(entry, "device", view.device);
+        result[view.name] = entry;
+    });
+    return result;
+}
+/** 一覧の fields に指定できるフィールドコードの集合 (spec 由来 + 組み込み)。 */
+export function selectableFieldCodes(spec) {
+    const codes = new Set(BUILT_IN_FIELD_CODES);
+    for (const field of spec.fields) {
+        codes.add(resolveFieldCode(field));
+    }
+    return codes;
+}
+function setIfDefined(target, key, value) {
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+function toStringOrUndefined(value) {
+    return value === undefined ? undefined : String(value);
+}
+function toArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+//# sourceMappingURL=toKintone.js.map

package/dist/spec/toKintone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toKintone.js","sourceRoot":"","sources":["../../src/spec/toKintone.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "fieldsmith",
+  "version": "0.1.0",
+  "description": "AppSpec (JSON) から kintone アプリを何度でも作る CLI。AppSpec は要件の文章からも作れる",
+  "keywords": [
+    "kintone",
+    "cli",
+    "codegen",
+    "claude",
+    "anthropic",
+    "infrastructure-as-code"
+  ],
+  "license": "MIT",
+  "author": "Daisuke Motohashi",
+  "homepage": "https://github.com/motohasystem/fieldsmith#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/motohasystem/fieldsmith.git"
+  },
+  "bugs": {
+    "url": "https://github.com/motohasystem/fieldsmith/issues"
+  },
+  "type": "module",
+  "bin": {
+    "fieldsmith": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "fieldsmith": "tsx src/cli/index.ts",
+    "e2e:manual": "tsx scripts/e2e-manual.ts",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.117.1",
+    "@kintone/rest-api-client": "^5.7.5",
+    "@resvg/resvg-js": "^2.6.2",
+    "commander": "^14.0.1",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "msw": "^2.11.3",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}