@rex0220/print-craft-authoring-tools 1.1.0 → 1.3.0

package/dist/types/_print-craft/src/authoring/api.d.ts

@@ -0,0 +1,3 @@
+// 中核の型（dist/types/）を作るときだけ使う代わりの型。印刷屋の authoring API の型は印刷屋のリポジトリにあり、npm には出さない。
+// 公開の型では any とする（中核を使う側は engine.api を直接使わず、中核の関数に渡すだけ）。tools の開発中の型の検査は本物の型で行う（tsconfig.json）
+export type PrintCraftAuthoringApi = any;

package/dist/types/_print-craft/src/config/load.d.ts

@@ -0,0 +1,4 @@
+// 中核の型（dist/types/）を作るときだけ使う代わりの型（api.d.ts と同じ考え）
+export type FieldInfo = any;
+export type FieldProp = any;
+export type PrintCraftSaved = any;

package/dist/types/_print-craft/src/config/schema.d.ts

@@ -0,0 +1,5 @@
+// 中核の型（dist/types/）を作るときだけ使う代わりの型（api.d.ts と同じ考え）
+export type MenuRow = any;
+export type CssRow = any;
+export type TagRow = any;
+export type CalcField = any;

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

@@ -0,0 +1,19 @@
+/**
+ * buttons <settings.json> [--button <名前>]
+ * 設定 JSON（封筒形式。normalize の前でも後でも）のボタンを 1 ボタン数行で一覧にする。--button でそのボタンの HTML 設定と更新項目の中身を出す
+ * （data: の URL は先頭と長さだけ。ファイルには元のまま）。通信しない・印刷屋の zip を読まない。
+ * 既存の設定（数十 KB。社印の data URL を含む）を AI が丸ごと読まずに済むように（2026-10-05、試用の納品書の計測で AI が node -e で同じ一覧を作っていた）
+ */
+export declare class ButtonNotFoundError extends Error {
+}
+/** data: の URL を先頭と長さだけにする（社印の SVG などで数 KB〜数十 KB になる） */
+export declare function shortenDataUrls(s: string, opt?: {
+    hash?: boolean;
+}): string;
+export interface ButtonsOptions {
+    /** 画面に出すファイル名 */
+    file: string;
+    /** この名前のボタンの中身を出す（同じ名前が複数あればすべて） */
+    button?: string;
+}
+export declare function listButtons(settings: Record<string, unknown>, opt: ButtonsOptions): string;

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

@@ -0,0 +1,6 @@
+type Obj = Record<string, unknown>;
+export declare function diffSettings(beforeEnvelope: Obj, afterEnvelope: Obj, opt?: {
+    derived?: boolean;
+}): string;
+export declare const DERIVED_KEYS: Set<string>;
+export {};

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

@@ -0,0 +1,54 @@
+/**
+ * fields --app N [--lang ja] [--preview] [--guest S] [--out fields/<file>]
+ * 項目定義（/k/v1/app/form/fields の properties）、レイアウト（/k/v1/app/form/layout）、アプリ名（/k/v1/app）を 1 つの JSON に保存する。
+ * 設定画面は preview の API を読む（load.ts 204 / 209 行）ので --preview で同じ API に切り替えられる（既定は運用中の形。
+ * preview は API トークンでは呼べないことがある）。normalize / preview はこのファイルから pp と更新項目の一覧を作る。
+ */
+import type { RestClient } from "../kintone-rest.ts";
+export interface FieldProperty {
+    type: string;
+    code: string;
+    label: string;
+    fields?: Record<string, FieldProperty>;
+    [key: string]: unknown;
+}
+export interface LayoutRow {
+    type?: string;
+    code?: string;
+    fields?: Array<{
+        type?: string;
+        code?: string;
+        [key: string]: unknown;
+    }>;
+    layout?: LayoutRow[];
+    [key: string]: unknown;
+}
+/** fields/<app>.json の形 */
+export interface FieldsFile {
+    tool: "pcraft-authoring fields";
+    fetchedAt: string;
+    baseUrl: string;
+    appId: number;
+    appName: string;
+    guestSpaceId?: number;
+    preview: boolean;
+    lang: string;
+    revision: string;
+    properties: Record<string, FieldProperty>;
+    layout: LayoutRow[];
+}
+export interface FieldsOptions {
+    app: number;
+    lang?: string;
+    preview?: boolean;
+    guestSpaceId?: number;
+    now?: () => Date;
+}
+export declare function fetchFields(client: RestClient, opt: FieldsOptions): Promise<FieldsFile>;
+/**
+ * fields --summary: 取得済みの fields/<app>.json を 1 項目 1 行で（レイアウトの順。テーブルの子は字下げ。通信しない）。
+ * AI が項目定義の JSON を丸ごと読まずに済むように（2026-10-05、試用の納品書の計測で AI が node -e で同じ要約を作っていた）
+ */
+export declare function listFields(file: FieldsFile): string;
+/** 画面に出す要約（項目の数と型。値は無い） */
+export declare function summarizeFields(file: FieldsFile): string;

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

@@ -0,0 +1,40 @@
+import type { Engine } from "../engine.ts";
+import type { FieldsFile } from "./fields.ts";
+import { Findings } from "../normalize/findings.ts";
+import { loadPolicy, type Policy } from "../normalize/policy.ts";
+import { type StoredSize } from "../normalize/size.ts";
+export declare const PLUGIN_NAME = "\u5370\u5237\u5C4B\u30D7\u30E9\u30B0\u30A4\u30F3";
+/** fields / record / 設定 JSON のファイルの上限（設定 JSON はさらに kit の 4 MB） */
+export declare const MAX_INPUT_BYTES: number;
+export declare class InputError extends Error {
+}
+export interface NormalizeInput {
+    settingsText: string;
+    settingsFile?: string;
+    fields: FieldsFile;
+    engine: Engine;
+    policy?: Policy;
+    check?: boolean;
+    /** .env の KINTONE_BASE_URL（検証済み）。iframe の同一オリジンの判定はこちらを使い、fields の baseUrl と違えば警告 */
+    baseUrl?: string;
+    now?: () => Date;
+}
+export interface NormalizeResult {
+    findings: Findings;
+    output?: Record<string, unknown>;
+    body?: Record<string, unknown>;
+    size?: StoredSize;
+    checkDiffs?: string[];
+    summary: string;
+}
+export declare function formatDate(d: Date): string;
+/** 2 つの値の差を path 付きで集める（短く） */
+export declare function jsonDiff(a: unknown, b: unknown, pathStr: string, out: string[]): void;
+export declare function normalizeSettings(input: NormalizeInput): Promise<NormalizeResult>;
+/** 大きさの上限を確かめてからテキストを読む */
+export declare function readTextLimited(file: string, maxBytes?: number): string;
+/** 大きさの上限を確かめてから JSON を読む（最上位はオブジェクト） */
+export declare function readJsonLimited(file: string, maxBytes?: number): Record<string, unknown>;
+export declare function readFieldsFile(file: string): Promise<FieldsFile>;
+export declare function relativeSettingsPath(file: string, cwd: string): string;
+export { loadPolicy };

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

@@ -0,0 +1,39 @@
+/**
+ * preview <settings.json> --fields <fields.json> --record <record.json> [--button <名前>] [--out-dir <dir>] [--json]
+ * 正規化（normalize と同じ手順。エラーがあれば止まる）→ 有効なボタンごとに帳票 HTML（sandbox の iframe + CSP）→ out/<ボタン名>.html。
+ * 一覧帳票（list）は 1 レコードでは作れないので対象外（段階 2）。式の失敗は帳票に赤字で埋め、終了コード 1。
+ * Web フォントは配信元が承認済み（policy。Google Fonts は既定）のときだけ帳票の文書に入れる（render.ts）。
+ * ファイル名はボタン名から使えない文字と Windows の予約名を除き、同じ名前になるときは -2、-3 を付ける（1-10 レビュー MAJOR 4）。
+ */
+import { type Engine } from "../engine.ts";
+import type { FieldsFile } from "./fields.ts";
+import { type KintoneRecord } from "./record.ts";
+import { type Policy } from "../normalize/policy.ts";
+import { Findings } from "../normalize/findings.ts";
+import { type RenderedButton } from "../preview/render.ts";
+export interface PreviewInput {
+    settingsText: string;
+    settingsFile?: string;
+    fields: FieldsFile;
+    recordFile: unknown;
+    engine: Engine;
+    policy?: Policy;
+    button?: string;
+    /** .env の KINTONE_BASE_URL（検証済み。normalize と同じ） */
+    baseUrl?: string;
+}
+export interface PreviewResult {
+    findings: Findings;
+    results: Array<RenderedButton & {
+        file: string;
+    }>;
+    skipped: string[];
+    summary: string;
+}
+/** レコードの形を 3 通り受ける */
+export declare function extractRecord(file: unknown): KintoneRecord;
+/** ボタン名 → 出力ファイル名（重複は -2、-3 …） */
+export declare function previewFileNames(rows: Array<{
+    menu: string;
+}>): string[];
+export declare function runPreview(input: PreviewInput): Promise<PreviewResult>;

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

@@ -0,0 +1,36 @@
+/**
+ * pull --app N [--preview] [--guest S] [--out settings/<file>] [--force] [--plugin-id <id>]
+ * アプリに入っている印刷屋プラグインの今の設定を kintone から取って、設定画面の「設定をダウンロード」と同じ封筒形式で settings/ に保存する
+ * （Takashi 2026-10-05「対象は、tools のみで GET だけ。プラグインは対象外」）。
+ *   - API は kintone の API ラボ「アプリに追加されているプラグインの設定情報を取得する」（GET /k/v1/app/plugin/config.json、
+ *     動作テスト環境は /k/v1/preview/app/plugin/config.json）。使うには cybozu.com 共通管理者がアップデートオプションの「検討中の新機能」で
+ *     「アプリに追加されているプラグインの設定情報を取得または更新するREST API」を有効にする。変更の PUT は呼ばない（tools は GET だけ）
+ *   - 権限: 運用中の設定はレコード閲覧（API トークンでも可。資料は「閲覧と追加」だが閲覧だけで取れた。2026-10-09 アプリ 3740 で確かめた）、
+ *     --preview（動作テスト環境 = 設定画面で保存してまだ反映していないもの）はアプリ管理（閲覧だけのトークンでは 403 GAIA_NO01）
+ *   - プラグイン ID は印刷屋の zip の PUBKEY から（plugin-zip.ts の pluginIdOf。5 変種とも同じ）
+ *   - 保存値は設定画面と同じ手順で読む: kit の readConfig（圧縮形式など）→ 設定のスキーマで検証（未知のキーと共通項目の更新日時などは落ちる）
+ */
+import type { RestClient } from "../kintone-rest.ts";
+import type { Engine } from "../engine.ts";
+export interface PullOptions {
+    app: number;
+    /** 動作テスト環境の設定（既定は運用中） */
+    preview?: boolean;
+    guestSpaceId?: number;
+    pluginId: string;
+    now?: () => Date;
+}
+export interface PullResult {
+    envelope: Record<string, unknown>;
+    appName: string;
+    revision: string;
+    /** 保存値の形式（compressed など。kit の readConfig） */
+    format: string;
+}
+export declare const PLUGIN_ID_PATTERN: RegExp;
+export declare function pullSettings(client: RestClient, engine: Engine, opt: PullOptions): Promise<PullResult>;
+/**
+ * 既定の保存先のファイル名 APP<番号>-<アプリ名>.json（ファイル名に使えない文字は _。safe-path.ts の safeFileName）。
+ * テンプレートの settings/ の決まり（APP3740-見積書-ご提案書.json）とそろえる（2026-10-06 Takashi「APP3740- がよいのでは？」）
+ */
+export declare function defaultPullName(appName: string, appId: number): string;

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

@@ -0,0 +1,63 @@
+/**
+ * record --app N --id R [--fields-from <settings.json>] [--guest S] [--out records/<file>]
+ * レコードを /k/v1/record（{ type, value }、テーブルは入れ子）で取って records/<app>-<id>.json に保存する。preview の入力。
+ * レコードは個人情報を含むので、--fields-from で設定が使う項目だけ残し、中身は画面とログに出さない（Codex MAJOR 5）。
+ */
+import type { RestClient } from "../kintone-rest.ts";
+import type { FieldsFile } from "./fields.ts";
+export type FieldValue = {
+    type: string;
+    value: unknown;
+};
+export type KintoneRecord = Record<string, FieldValue>;
+export interface RecordFile {
+    tool: "pcraft-authoring record";
+    fetchedAt: string;
+    baseUrl: string;
+    appId: number;
+    id: number;
+    guestSpaceId?: number;
+    /** --fields-from で絞ったときの残した項目（絞らなければ無い） */
+    keptFields?: string[];
+    record: KintoneRecord;
+}
+export interface RecordOptions {
+    app: number;
+    id: number;
+    guestSpaceId?: number;
+    /** 残す項目（undefined なら全部） */
+    keep?: Set<string>;
+    now?: () => Date;
+}
+/**
+ * 式の中で項目コードになりうる語（"…" の文字列の中身と数値を除く）。計算式の文字列は \ を解釈しないので "…" は次の " まで。
+ * 関数名やコメントの語も拾うが、絞るときはレコードにある項目しか残らないので害は無い（多めに拾う。絞りすぎるとプレビューが空欄になる）
+ */
+export declare function identifiersOf(expr: string): string[];
+/**
+ * 設定 JSON（封筒形式。正規化済みでなくてもよい）から、帳票と更新項目が使う項目コードを集める。
+ * usedFields（あれば）、HTML 欄の ${式} と計算式の本文の語、更新項目の fieldcode、filecode。何も見つからなければ null（絞らない）。
+ * usedFields は計算式欄だけから作られ、HTML 欄の ${式}（宛名、合計など）を含まない（2026-10-06 のリハーサルで、--fields-from が宛名などを落として
+ * プレビューが空欄になっていたのを見つけた）
+ */
+export declare function usedFieldCodes(settings: unknown): Set<string> | null;
+/** keep の項目だけ残す。テーブルは、テーブル自身か子のどれかが keep にあれば残し、子は keep にあるものだけ（テーブル自身が keep なら全部） */
+export declare function narrowRecord(record: KintoneRecord, keep: Set<string>): {
+    record: KintoneRecord;
+    kept: string[];
+};
+/**
+ * 設定が使う項目のうち、プレビューのレコードに無いもの（fields にある項目だけを見る。テーブルの子は、テーブルが無いか行があって子が無いとき）。
+ * 古い records/ や絞りすぎたレコードで帳票が空欄になるのを preview の警告で知らせる（2026-10-06）
+ */
+export declare function missingInRecord(settings: unknown, fields: Pick<FieldsFile, "properties">, record: KintoneRecord): string[];
+export declare function fetchRecord(client: RestClient, opt: RecordOptions): Promise<RecordFile>;
+/**
+ * record --summary: 取得済みの records/<app>-<id>.json を 1 項目 1 行で。**値は出さず形だけ**（文字数・行数・数値の桁・件数・添付の種類。
+ * SECURITY.md「レコードの値を標準出力に出さない」）。プレビューのレコードとして使えるか（備考に改行、明細が複数行、添付あり）を見るため（2026-10-05）
+ */
+export declare function describeRecord(file: RecordFile): string;
+/** レコードの形を 1 項目 1 行で（値は出さない。record --summary と kintone_list_records が使う） */
+export declare function shapeLines(record: KintoneRecord): string[];
+/** 画面に出す要約（項目の数だけ。値は出さない） */
+export declare function summarizeRecord(file: RecordFile): string;

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

@@ -0,0 +1,36 @@
+/**
+ * レコードを数件、形の要約だけで見る（段階 0-2 の段 4。print-craft MCP の kintone_list_records の本体。docs/api-table.md、実装案 5.4）。
+ * プレビュー用の代表の 1 件を選ぶため。値・ファイル名・ユーザー名は返さない（形だけ。record --summary と同じ shapeLines）。保存もしない。
+ *   - query は条件と並べ替えだけ。limit / offset を含めば止める（件数は AI に決めさせない。サーバーが末尾に limit を付ける）
+ *   - query は 500 文字まで（URL の 8 KB の上限に届かないように）
+ *   - 返す JSON の UTF-8 のバイト数に上限を付け、超える前の件で打ち切る（truncated。項目コードの日本語・エスケープ・query を含めて測る）
+ */
+import type { RestClient } from "../kintone-rest.ts";
+export declare const LIST_LIMIT = 5;
+export declare const QUERY_MAX = 500;
+/** AI に返す JSON の上限（docs/api-table.md の 64 KiB。JSON.stringify した UTF-8 のバイト数。Codex レビュー MINOR 7） */
+export declare const SHAPE_TEXT_MAX: number;
+export declare class QueryError extends Error {
+}
+/** 受け取った query を検査し、末尾に limit を付けた query を返す */
+export declare function listQueryOf(query: string | undefined): string;
+export interface RecordShape {
+    /** レコード番号（$id） */
+    id: string;
+    /** 1 項目 1 行の形（値は出さない） */
+    lines: string[];
+}
+export interface RecordShapes {
+    appId: number;
+    query: string;
+    records: RecordShape[];
+    /** 返す文字の上限で打ち切った */
+    truncated: boolean;
+}
+/** maxBytes は試験用（既定 SHAPE_TEXT_MAX） */
+export declare function listRecordShapes(client: RestClient, opt: {
+    app: number;
+    query?: string;
+    guestSpaceId?: number;
+    maxBytes?: number;
+}): Promise<RecordShapes>;

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

@@ -0,0 +1,50 @@
+import type { Engine } from "../engine.ts";
+import type { Policy } from "../normalize/policy.ts";
+import type { Finding } from "../normalize/findings.ts";
+export type SaveStatus = "ok" | "invalid" | "conflict" | "denied" | "failed";
+export interface SaveResult {
+    status: SaveStatus;
+    /** 作業フォルダーからの相対パス（区切りは /） */
+    path: string;
+    /** 確定したファイルの digest（sha256。ok のとき） */
+    digest?: string;
+    findings: Finding[];
+    /** status が ok でないときの理由（決まった文） */
+    message?: string;
+    /** status が ok でないときの誤りの種類（ConflictError、PermissionError、PathError、InputError など。想定外の失敗は Error） */
+    code?: string;
+    /** ok だが、確定の後に一時ファイルかロックを消せなかった（確定はしている。利用者に伝えて消してもらう） */
+    cleanup?: string[];
+}
+export interface SaveContext {
+    /** 作業フォルダーの実際のパス（WorkContext.root） */
+    root: string;
+    engine: Engine;
+    policy: Policy;
+    /** iframe の同一オリジンの判定に使う接続先（検証済み） */
+    baseUrl?: string;
+    /** 試験用: 確定の直後（片付けの前）に呼ぶ。print-craft MCP と CLI は渡さない */
+    afterPlace?: () => void;
+}
+/** 入力（content / replacement）の上限（バイト） */
+export declare const MAX_SAVE_INPUT_BYTES: number;
+/** ファイルの digest（sha256。pcraft_buttons が返し、pcraft_update_button が照合する） */
+export declare function digestOf(text: string | Buffer): string;
+/** 新しい設定を保存する（expectedAbsent: true が要る。同じ名前のファイルがあれば conflict） */
+export declare function saveNewSettings(ctx: SaveContext, opt: {
+    path: string;
+    content: string;
+    fields?: string;
+    expectedAbsent: true;
+}): Promise<SaveResult>;
+/**
+ * 既存の設定のボタン 1 つを差し替える（無ければ末尾に足す）。expectedDigest は pcraft_buttons（buttons --json）が返した値。
+ * replacement はボタン 1 つ（pluginInfos の 1 行）の JSON。その menu が button と違えば invalid
+ */
+export declare function updateButton(ctx: SaveContext, opt: {
+    path: string;
+    button: string;
+    expectedDigest: string;
+    replacement: string;
+    fields?: string;
+}): Promise<SaveResult>;

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

@@ -0,0 +1,19 @@
+import { type Workspace } from "../workspace.ts";
+/** 印刷屋の設定の封筒の pluginID（印刷屋の PLUGIN_ID_NAME と同じ。engine の api.pluginId で確かめている） */
+export declare const PRINT_CRAFT_PLUGIN_ID = "rex0220 Print craft plugin";
+export interface TakeResult {
+    /** leftInInbox: 行き先には置いたが inbox の元を消せなかった（消してよい。次の take でも「同じもの」として消す） */
+    moved: Array<{
+        file: string;
+        to: string;
+        same: boolean;
+        leftInInbox?: boolean;
+    }>;
+    skipped: Array<{
+        file: string;
+        reason: string;
+    }>;
+    /** 置いたが一時ファイルを消せなかった、など（移したことは変わらない） */
+    warnings: string[];
+}
+export declare function takeInbox(cwdIn: string, ws: Workspace, envName?: string): TakeResult;

package/dist/types/commit-file.d.ts

@@ -0,0 +1,38 @@
+export declare const LOCK_STALE_MS = 60000;
+/** 確定先に同じ名前のファイルが既にある（確かめた後に作られた場合を含む） */
+export declare class FileExistsError extends Error {
+}
+/** 同じファイルへの別の書き込みがロックを持っている */
+export declare class LockBusyError extends Error {
+}
+/** EPERM / EBUSY なら短く待ってやり直す（tries 回まで）。それ以外の失敗はそのまま投げる */
+export declare function withRetry<T>(fn: () => T, tries?: number): T;
+/** 片付けを 1 つずつ試し、失敗の文を返す（一方の失敗で他方を飛ばさない。EPERM / EBUSY は短く待ってやり直す） */
+export declare function cleanupAll(steps: Array<() => void>, tries?: number): string[];
+/** 確定先と同じフォルダーの一時ファイルの名前 */
+export declare function tempPathFor(target: string): string;
+/** 一時ファイルを新しい名前で確定する（同じ名前があれば FileExistsError。上書きしない）。link は試験用（ハードリンクが使えない場合を作る） */
+export declare function placeNew(tmp: string, target: string, link?: (from: string, to: string) => void): void;
+export interface WriteNewResult {
+    /** 確定の後の片付けの失敗（確定はしている） */
+    cleanup: string[];
+}
+/**
+ * 新しいファイルとして書く。recheck は一時ファイルを書く前と確定の直前に呼ぶ（書ける場所・許可を確かめ直す。投げれば確定しない）。
+ * 同じ名前があれば FileExistsError（確かめた後に作られた場合も）。失敗したら一時ファイルを消す
+ */
+export declare function writeNewFile(target: string, text: string, recheck?: () => void): WriteNewResult;
+export interface Lock {
+    /** まだ自分のロックか（確定の直前に確かめる） */
+    owned(): boolean;
+    /** 自分のロックなら外す（他の保存が取り直したロックは消さない）。外したら true */
+    release(): boolean;
+}
+export declare function lockPathFor(target: string): string;
+/** 試験用: 古いロックを付け替える直前・戻す直前に呼ぶ（その間に替わる場合を作る） */
+export interface LockTestHooks {
+    beforeClaim?: () => void;
+    beforeRestore?: () => void;
+}
+/** 確定先のロックを取る。取れなければ LockBusyError */
+export declare function acquireLock(target: string, staleMs?: number, hooks?: LockTestHooks): Lock;

package/dist/types/context.d.ts

@@ -0,0 +1,10 @@
+export interface WorkContext {
+    /** 作業フォルダーの実際のパス（絶対パス） */
+    readonly root: string;
+    /** 環境変数（OS のもの、または MCP の設定項目から作ったもの）。中核は process.env を直接読まない */
+    readonly env: Readonly<Record<string, string | undefined>>;
+}
+export declare function createContext(opt: {
+    cwd: string;
+    env: Readonly<Record<string, string | undefined>>;
+}): WorkContext;

package/dist/types/core.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 共通の中核の入口（npm の @rex0220/print-craft-authoring-tools/core。print-craft-authoring-mcp の print-craft MCP が使う）。
+ * 2026-10-09 Takashi「B」: 別のパッケージにせず、tools のパッケージに入口を足す（公開も版も 1 つ。CLI と同じ版）。
+ *   - 中核は process.cwd() / process.env を読まない。作業フォルダー（実際のパス）と環境変数は呼ぶ側が引数で渡す（context.ts）
+ *   - 印刷屋のコード（計算式エンジン、authoring API）は含まない。利用者の印刷屋の zip から loadEngine が読む
+ *   - ここに出すものが公開の約束。CLI（cli.ts）と開発用の dev-paths.ts は出さない
+ * ビルド: scripts/build.mjs が dist/core.mjs（ESM。happy-dom は依存のまま外に置く）と dist/types/（型）を作る。
+ */
+export declare const CORE_API_VERSION = 1;
+export { createContext, type WorkContext } from "./context.ts";
+export { PathError, WRITE_ROOTS, isInside, realResolve, resolveRead, resolveWrite } from "./safe-path.ts";
+export { PermissionError, assertChangeAllowed, classOfAppPath, roleOfTarget, type ChangeOp, type TargetClass, type TargetRole } from "./permission.ts";
+export { EDIT_RE, INBOX, KINTONE_ROOT, SNAPSHOT_RE, WORKSPACE_FILE, WorkspaceError, appDirFor, appFolderOfFile, editNameOf, envOfAppFolder, findAppDir, folderNameOf, listAppFolder, loadWorkspace, parseWorkspace, pickEnv, resolveApp, snapshotNameOf, type EnvRole, type EnvironmentDef, type Workspace } from "./workspace.ts";
+export { MIN_PLUGIN_VERSION, PRINT_CRAFT_PLUGIN_ID, SUPPORTED_API_VERSIONS, isSupportedPluginVersion, toolsMeta, type ToolsMeta } from "./meta.ts";
+export { DEFAULT_CONTEXT_BASE_URL, loadEngine, type Engine, type LoadEngineOptions } from "./engine.ts";
+export { PluginZipError } from "./plugin-zip.ts";
+export { AuthError, baseUrlFromEnv, describeAuth, loadAuth, loadAuthForEnv, pluginZipPath, unquote, type KintoneAuth, type LoadAuthOptions } from "./env.ts";
+export { KintoneUrlError, isKintoneBaseUrl, normalizeKintoneBaseUrl } from "./kintone-url.ts";
+export { ALLOWED_APIS, NotAllowedError, RECEIVE_LIMITS, RestError, createRestClient, type AllowedApi, type FetchLike, type RestClient } from "./kintone-rest.ts";
+export { InputError, MAX_INPUT_BYTES, normalizeSettings, readFieldsFile, readJsonLimited, readTextLimited, relativeSettingsPath, type NormalizeInput, type NormalizeResult } from "./commands/normalize.ts";
+export { loadPolicy, type Policy } from "./normalize/policy.ts";
+export { type Finding } from "./normalize/findings.ts";
+export { MAX_SAVE_INPUT_BYTES, digestOf, saveNewSettings, updateButton, type SaveContext, type SaveResult, type SaveStatus } from "./commands/save.ts";
+export { ButtonNotFoundError, listButtons, shortenDataUrls, type ButtonsOptions } from "./commands/buttons.ts";
+export { DERIVED_KEYS, diffSettings } from "./commands/diff.ts";
+export { fetchFields, listFields, summarizeFields, type FieldsFile, type FieldsOptions } from "./commands/fields.ts";
+export { describeRecord, fetchRecord, missingInRecord, narrowRecord, shapeLines, summarizeRecord, usedFieldCodes, type KintoneRecord, type RecordFile, type RecordOptions } from "./commands/record.ts";
+export { LIST_LIMIT, QUERY_MAX, QueryError, SHAPE_TEXT_MAX, listQueryOf, listRecordShapes, type RecordShape, type RecordShapes } from "./commands/records.ts";
+export { extractRecord, previewFileNames, runPreview, type PreviewInput, type PreviewResult } from "./commands/preview.ts";
+export { defaultPullName, pullSettings, type PullOptions, type PullResult } from "./commands/pull.ts";
+export { takeInbox, type TakeResult } from "./commands/take.ts";
+export { FileExistsError, LockBusyError, writeNewFile } from "./commit-file.ts";

package/dist/types/engine.d.ts

@@ -0,0 +1,64 @@
+import type { PrintCraftAuthoringApi } from "./_print-craft/src/authoring/api.ts";
+import { type PluginSources } from "./plugin-zip.ts";
+/** 計算式のインスタンス（print-craft の config/libs.ts の KintoneFormula と同じ形） */
+export interface FormulaInstance {
+    funs: Record<string, unknown>;
+    usedFields(init?: Record<string, unknown>): Record<string, unknown>;
+    dq(expression: string): unknown;
+    initTableInfo?(ptcode: string): void;
+}
+export type FormulaCtor = new (name: string, pp: unknown, record: unknown, fieldCheck: boolean, strict?: boolean) => FormulaInstance;
+export interface LoginUser {
+    id: string;
+    code: string;
+    name: string;
+    email: string;
+    language: string;
+}
+export interface KintoneContext {
+    baseUrl: string;
+    appId: number;
+    loginUser: LoginUser;
+}
+export interface EngineSource {
+    kind: "zip" | "dev";
+    from: string;
+    pluginVersion: string;
+    engineSha256: string;
+    apiSha256?: string;
+    /** プラグイン ID（zip の PUBKEY から。印刷屋のものでなければ読み込まない。pull が使う。開発中の print-craft から読んだときは無い） */
+    pluginId?: string;
+}
+export interface Engine {
+    window: Record<string, unknown>;
+    Ctor: FormulaCtor;
+    /** 印刷屋の authoring API（設定画面・帳票のコードと kit） */
+    api: PrintCraftAuthoringApi;
+    source: EngineSource;
+    /** 読み込み時の注意（既知でない中身を許して続けたなど） */
+    warnings: string[];
+    setContext(ctx: Partial<KintoneContext>): void;
+    /** 設定画面と同じ検証用のインスタンス（createFormula） */
+    checker(pp: unknown, crec: unknown): FormulaInstance;
+    /** デスクトップと同じ実行用のインスタンス（newFormula） */
+    runner(pp: unknown, record: unknown): FormulaInstance;
+    functionNames(): string[];
+}
+export interface LoadEngineOptions {
+    /**
+     * 印刷屋の zip。中核は環境変数を読まない（段階 0-2。CLI は .env / OS の環境変数の PCRAFT_PLUGIN_ZIP を env.ts の pluginZipPath で
+     * 決めて渡す。print-craft MCP は設定項目から渡す）
+     */
+    pluginZip?: string;
+    /** 開発中（mode dev）の読み込み元（隣の print-craft の prod/）。CLI は環境変数 PCRAFT_ALLOW_DEV_PLUGIN=1 のときだけ dev-paths.ts の printCraftProdDir で決めて渡す */
+    devPluginDir?: string;
+    /** テスト用。省略時は toolsMeta().mode（ソースから動かすと dev、ビルドした bundle は build） */
+    mode?: "build" | "dev";
+}
+/** 接続先が分からないときの APP_URL などの元（実在しないテナント） */
+export declare const DEFAULT_CONTEXT_BASE_URL = "https://example.cybozu.com";
+/** 読み込み元を決める: zip（引数 → 環境変数）。開発中（mode dev + PCRAFT_ALLOW_DEV_PLUGIN=1）だけ隣の print-craft の prod/ */
+export declare function resolvePluginSources(opt?: LoadEngineOptions, mode?: "build" | "dev"): PluginSources & {
+    kind: "zip" | "dev";
+};
+export declare function loadEngine(opt?: LoadEngineOptions): Promise<Engine>;

package/dist/types/env.d.ts

@@ -0,0 +1,50 @@
+export interface KintoneAuth {
+    baseUrl: string;
+    token?: string;
+    username?: string;
+    password?: string;
+}
+/** 前後の空白と、対になった外側の " / ' を外す（.env の値と、OS の環境変数の場所・URL。Windows の「パスのコピー」で付く引用符。引用符の中の空白は値のうち） */
+export declare function unquote(raw: string): string;
+/** .env の形（KEY=VALUE。# の行と空行は無視。両端の " ' は外す。export KEY=… も可） */
+export declare function parseDotEnv(text: string): Record<string, string>;
+export interface LoadAuthOptions {
+    /** テスト用。CLI からは渡さない（.env は cwd のものだけ） */
+    envFile?: string;
+    /** 作業フォルダー（.env の場所。WorkContext.root） */
+    cwd: string;
+    /** 環境変数（WorkContext.env）。中核は process.env を直接読まない */
+    env: Readonly<Record<string, string | undefined>>;
+}
+export declare class AuthError extends Error {
+}
+/** 値と、その出所（OS の環境変数か .env か）。相対パスの解決の起点を出所で変えるため（段階 0-2 の段 2） */
+export interface Picked {
+    value: string;
+    /** process = OS の環境変数（print-craft MCP では設定項目から作った環境変数）、file = .env */
+    source: "process" | "file";
+    /** source が file のときの .env のパス */
+    file?: string;
+}
+export declare function envFileOf(opt: LoadAuthOptions): string;
+/** 接続先の URL（検証済み。無ければ undefined） */
+export declare function baseUrlFromEnv(opt: LoadAuthOptions): string | undefined;
+export declare function loadAuth(opt: LoadAuthOptions): KintoneAuth;
+/**
+ * environments.json の環境の認証（workspace.ts。2026-10-05）。接続先は environments.json の baseUrl、認証はその環境の envFile（.env か env/<名前>.env。
+ * 場所は environments.json の値だけで、CLI から指定できない）だけから読む。OS の KINTONE_* / KSQL_* は読まない（開発と本番の取り違えを防ぐ。
+ * OS に本番の KINTONE_BASE_URL があっても開発の環境で使わない）。envFile に KINTONE_BASE_URL があり environments.json と違えば止まる
+ */
+export declare function loadAuthForEnv(env: {
+    name: string;
+    baseUrl: string;
+    envFile: string;
+}, cwd: string): KintoneAuth;
+/**
+ * 印刷屋の zip の場所（OS の環境変数か .env の PCRAFT_PLUGIN_ZIP。無ければ undefined = 開発中の print-craft を探す）。
+ * .env に書いた相対パスは .env のフォルダーから解決する（今までどおり）。OS の環境変数（print-craft MCP では設定項目）の値は
+ * 絶対パスだけを受け付ける（相対パスの起点が起動の場所に左右されるため。Desktop の起動の場所は / や C:\Windows\System32。段階 0-2 の段 2）
+ */
+export declare function pluginZipPath(opt: LoadAuthOptions): string | undefined;
+/** 認証の種類だけを文言にする（値もユーザー名も出さない） */
+export declare function describeAuth(auth: KintoneAuth): string;