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

package/dist/types/kintone-rest.d.ts

@@ -0,0 +1,65 @@
+/**
+ * kintone REST API の読み取り専用クライアント（docs/authoring-plan.md 12.2、Codex MAJOR 5 の反映。1-10 レビュー BLOCKER 1 で送信先の検証を足した）。
+ *   - GET しか送らない（メソッドはここで固定。他のメソッドを送る口が無い）
+ *   - 送れるパスは ALLOWED_APIS に固定し、それ以外は送信前に止める（ゲストスペースの /k/guest/<id>/v1/… も同じ一覧）
+ *   - 送信先は kintone のドメイン（kintone-url.ts）だけ。URL は new URL(path, base) で組み、送信直前に origin が検証済みの origin と同じか確かめる
+ *   - 認証は API トークン（X-Cybozu-API-Token）か、ログインユーザー（X-Cybozu-Authorization）
+ *   - エラーの文言は HTTP の状態と kintone のコードと固定のヒントだけ（サーバーの message は出さない。認証情報とレコードの中身を混ぜない）
+ */
+import type { KintoneAuth } from "./env.ts";
+/**
+ * 許可する API（/k/v1/ と /k/guest/<id>/v1/ の後ろ）。app/plugin/config と preview/app/plugin/config は pull が使う（API ラボの
+ * 「アプリに追加されているプラグインの設定情報を取得する」。GET だけ。変更の PUT は呼ばない。Takashi 2026-10-05「tools のみで GET だけ」）
+ */
+export declare const ALLOWED_APIS: readonly ["app", "app/form/fields", "app/form/layout", "record", "records", "preview/app/form/fields", "preview/app/form/layout", "app/plugin/config", "preview/app/plugin/config"];
+/**
+ * 受け取る本文の上限（バイト。段階 0-2 の段 4。print-craft-authoring-mcp の docs/api-table.md 2 章）。CLI にも効くので、大きなアプリ
+ * （項目 500 前後、テーブルが多い）でも引っかからない値にする。超えたら本文を読み切らずに RestError（code LimitError）
+ */
+export declare const RECEIVE_LIMITS: Record<(typeof ALLOWED_APIS)[number], number>;
+export type AllowedApi = (typeof ALLOWED_APIS)[number];
+export declare class RestError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly apiPath: string | undefined;
+    constructor(message: string, status: number, code?: string, apiPath?: string);
+}
+export declare class NotAllowedError extends Error {
+}
+/**
+ * fetch の応答のうち使う部分。本文はストリーム（body）だけから読む（全文を読んでから大きさを確かめる経路は持たない。Codex レビュー MINOR 8）。
+ * body が null なら本文なし。headers は無くてもよい（Content-Length は読む前に止めるためだけ）
+ */
+export interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    headers?: {
+        get(name: string): string | null;
+    };
+    body: {
+        getReader(): {
+            read(): Promise<{
+                done: boolean;
+                value?: Uint8Array;
+            }>;
+            cancel(): Promise<void>;
+        };
+    } | null;
+}
+export type FetchLike = (url: string, init: {
+    method: "GET";
+    headers: Record<string, string>;
+}) => Promise<FetchResponseLike>;
+/**
+ * 上限を守って本文を読む。Content-Length が上限を超えれば読まずに止める。無い・偽りでも、読みながら上限 + 1 バイトで止める。
+ * 止めるときの cancel の失敗は無視する（上限の誤りを優先して返す）。JSON にするのは上限の確認の後だけ（呼ぶ側）
+ */
+export declare function readCapped(res: FetchResponseLike, limit: number, apiPath: string): Promise<string>;
+export interface RestClient {
+    readonly baseUrl: string;
+    /** 許可した API を GET で呼ぶ。api は "app" / "app/form/fields" など。guestSpaceId を渡すとゲストスペースの URL */
+    get<T>(api: AllowedApi, params: Record<string, string | number | boolean | undefined>, guestSpaceId?: number): Promise<T>;
+}
+export declare function apiPathOf(api: string, guestSpaceId?: number): string;
+export declare function authHeaders(auth: KintoneAuth): Record<string, string>;
+export declare function createRestClient(auth: KintoneAuth, fetchImpl?: FetchLike): RestClient;

package/dist/types/kintone-url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * kintone の接続先 URL の検証（Codex 1-10 レビュー BLOCKER 1）。認証ヘッダー（API トークン / ログインユーザー）を送る先を kintone のドメインだけに限る。
+ *   - https で、ユーザー情報（user:pass@）・ポート・パス・クエリ・フラグメントが無い
+ *   - ホストは *.cybozu.com / *.kintone.com / *.cybozu.cn（セキュアアクセスの *.s.cybozu.com も含む）
+ * 返すのは正規化した origin（小文字、末尾の / 無し）。REST の送信直前にも同じ origin か確かめる（kintone-rest.ts）。
+ */
+export declare const KINTONE_HOST_SUFFIXES: readonly [".cybozu.com", ".kintone.com", ".cybozu.cn"];
+export declare class KintoneUrlError extends Error {
+}
+export declare function normalizeKintoneBaseUrl(raw: string): string;
+export declare function isKintoneBaseUrl(raw: string): boolean;

package/dist/types/meta.d.ts

@@ -0,0 +1,30 @@
+/** 印刷屋プラグインの kintone のプラグイン ID（PUBKEY の SHA-256 から。plugin-zip.ts の pluginIdOf。5 変種とも同じ鍵） */
+export declare const PRINT_CRAFT_PLUGIN_ID = "lcapkanpjdabgphknkabojmcfhonhkhp";
+/** tools が扱う印刷屋の版の下限（manifest.json の version。authoring API を同梱したのが Ver.6） */
+export declare const MIN_PLUGIN_VERSION = 6;
+/** tools が対応する印刷屋の authoring API の版（print-craft の src/authoring/api.ts の AUTHORING_API_VERSION。2 = Ver.7 で webFontPageCss を追加） */
+export declare const SUPPORTED_API_VERSIONS: readonly number[];
+/** 印刷屋の版として扱えるか（整数で MIN_PLUGIN_VERSION 以上） */
+export declare function isSupportedPluginVersion(version: string): boolean;
+/** tools が使う authoring API のキーと型（契約。zip の API がこの形でなければ止める。1-10 レビュー MAJOR 8） */
+export declare const REQUIRED_API: Record<string, "function" | "object" | "string" | "number">;
+export interface ToolsMeta {
+    toolsVersion: string;
+    /** 扱う印刷屋の zip のプラグイン ID */
+    pluginId: string;
+    /** 扱う印刷屋の版の下限 */
+    minPluginVersion: number;
+    supportedApiVersions: number[];
+    /** tools のリポジトリ（print-craft-authoring）の commit（作業ツリーに変更があれば +dirty） */
+    commit: string;
+    builtAt: string;
+    mode: "build" | "dev";
+}
+/** RegExp を文字列にして JSON にする（CONFIG_SCHEMA の pattern を落とさない） */
+export declare function stableJson(v: unknown): string;
+export declare function sha256Hex(data: string | Buffer): string;
+/** CONFIG_SCHEMA のハッシュ（先頭 12 桁）。印刷屋の API から受けた schema で計算する */
+export declare function schemaRevisionOf(schema: unknown): string;
+export declare function gitCommit(dir: string): string;
+export declare function devMeta(): ToolsMeta;
+export declare function toolsMeta(): ToolsMeta;

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

@@ -0,0 +1,58 @@
+/**
+ * 正規化した設定の検査（docs/authoring-plan.md 12.3）。派生値は derive.ts が作った後に呼ぶ。列挙の定数は印刷屋の API から。
+ * 1-10 レビューと再レビューで足したこと:
+ *   - `isSafeExpression` は式全体を見る（"ESC_HTML(x) & HTML(…)" を安全にしない。& でつないだ項がすべて安全なら安全。REPLACE の置換文字列は <br> か記号無しの定数だけ）
+ *   - HTML 設定の 1 行目 $out / 2 行目 $fname の欠落、有効なボタンの HTML 設定の欠落、有効なボタン名の重複はエラー
+ * 2026-10-04 Takashi「ver.6 にチェックを組み込めばよい」: kintone 以外への読み込みとスクリプトは印刷屋 Ver.6 が描画の前に除く（共通の設定「外部参照」externalRefs = "block"。
+ * print-craft の src/shared/sanitize.ts）。計算式が作る HTML を tools の静的検査で止め切れない（Codex レビュー 5 回）ので、止めるのは本体、tools は次の分担にした:
+ *   - externalRefs が "allow"（Ver.5 と同じく何も除かない。自己責任）は、利用者が policy/authoring-policy.json の allowExternalRefs にその設定ファイルを
+ *     書いていなければエラー。キーが無い設定（Ver.5 のエクスポート）は印刷屋が "allow" として動かすので derive.ts が "allow" を明示する（同じ承認が要る）
+ *   - "block" の設定の HTML / CSS のテンプレートにある外部 URL はエラー（印刷屋が除くので帳票に出ない。添付ファイルか data:image にする）。
+ *     "allow" の設定では policy の allowExternal で承認（承認済みは情報、無ければ警告）
+ *   - Web フォント（fontInfo.cssUrl）は印刷屋が除かないので、外部参照の設定に関わらず policy の allowExternal で承認（Google Fonts は既定で承認）
+ *   - 帳票の行の計算式が作る HTML は警告だけ: HTML を作る関数の名前、TAG の要素名や ATTR / STYLE / BATTR の値が定数でない、
+ *     文字列の定数に HTML / CSS があれば HTML / CSS と同じ検査を警告として出す（外部 URL は "block" なら「除かれる」警告、"allow" なら承認の対象）
+ */
+import type { Findings } from "./findings.ts";
+import { type Model } from "./model.ts";
+import { type Policy } from "./policy.ts";
+export interface CheckOptions {
+    policy: Policy;
+    /** cwd からの相対パス（policy の files / allowExternalRefs と照合） */
+    settingsFile?: string;
+}
+/** 共通の設定「外部参照」（印刷屋 Ver.6 の shared/external-refs.ts と同じ値） */
+export type ExternalRefs = "block" | "allow";
+export declare const EXTERNAL_REFS: readonly ExternalRefs[];
+/**
+ * 文字列の定数の中の \n / \r / \t（2026-10-05）。実エンジンは " のエスケープ（\"）しか解釈しないので、"\n" は改行でなく \ と n の 2 文字で、
+ * REPLACE(ESC_HTML(備考), "\n", "<br>") は何も置き換えない（試用の納品書で発覚。文書と samples がこの形を勧めていた）。改行は NEWLINE()
+ */
+export declare function backslashEscapes(formula: string): string[];
+/** 最上位の区切り文字（, や &）で分ける（文字列と括弧の中は分けない）。括弧や引用符が合わなければ null */
+export declare function splitTopLevel(s: string, sep?: string): string[] | null;
+/** 式全体が 1 つの関数呼び出し NAME(args) か（"A(1) & B(2)" は違う） */
+export declare function parseCall(e: string): {
+    name: string;
+    args: string[];
+} | null;
+/**
+ * 文字列の定数の中に // があるか。印刷屋の stripComments（load.ts）は文字列を見ずに // 以降を行末まで捨てるので、
+ * "https://…" のような文字列は設定画面でもデスクトップでも壊れる（印刷屋の仕様。URL は HTML の属性か ##目印## に置く）。
+ * 文字列の規則は実エンジンの p.dq と同じ: 二重引用符だけ、直前に \ がある " はエスケープ（\\" も閉じない）、' は文字
+ */
+export declare function commentInsideString(formulaSet: string): boolean;
+/** 式の中の文字列の定数（"…" と '…'。エスケープは外す） */
+export declare function stringLiterals(formula: string): string[];
+/** 式の中の NAME(...) の呼び出しをすべて見つけ、引数を最上位のカンマで分けて返す（入れ子も見る） */
+export declare function callsOf(formula: string, name: string): string[][];
+/**
+ * HTML の ${式} が安全な差し込みか（12.3 の html.rawExpression）。式**全体**が次のどれか（& でつないだ項はすべてがこれなら安全）:
+ *   ESC_HTML(…)、REPLACE(ESC_HTML(…), NEWLINE() か "文字列", "<br>" か記号無しの文字列)、数値・日付の項目そのもの、数値・日付の項目（と算術・整える関数の入れ子）を
+ *   整える関数（FVAL(合計) など。残りの引数は記号無しの文字列や数の定数）、TODAY() / NOW()、数の定数、HTML の記号を含まない文字列の定数
+ * それ以外（文字列系の項目、FVAL(文字列項目)、HTML(…)、記号を含む定数）は警告
+ */
+export declare function isSafeExpression(expr: string, pp: Record<string, {
+    type: string;
+}>): boolean;
+export declare function checkBody(body: Record<string, unknown>, model: Model, f: Findings, opt: CheckOptions): Promise<void>;

package/dist/types/normalize/css-check.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CSS の検査（docs/authoring-plan.md 12.3、Codex BLOCKER 1。1-10 レビュー BLOCKER 3 と再レビュー BLOCKER 2 / MINOR 1 で Chrome の解釈に合わせた）。
+ * 簡易トークナイザー（tokenizeCss）で、
+ *   1. コメントを外す（文字列の中の /* は壊さない。エスケープで /* を作っても注釈にはならない）
+ *   2. 文字列を番号の印（\u0001N\u0001）に置き換えて別に持つ（文字列の中の url( や @import を禁止構文と誤認しない。再レビュー MINOR 1）
+ *   3. CSS のエスケープを復号する（\75rl → url、@\69mport → @import。16 進の後ろの空白は改行・CR・FF・CRLF も 1 つ消費する = 仕様どおり。再レビュー BLOCKER 2）
+ * その上で、外部に接続する手段をすべて拾って URL を分類する: url()、image-set() / -webkit-image-set() / image() / src() の文字列、@import の文字列。
+ * 禁止: @import、expression(、behavior:、-moz-binding:（文字列の外だけ見る）。
+ * URL の分類は Chrome の URL パーサーに合わせる: タブ・改行を捨て、両端の制御文字と空白を外し、\ は / と同じ（\\evil はスキーム相対）。
+ * 印刷屋の置き換えタグ #{&f(…)} は添付ファイルの画像（data URL に置き換わる）なので許す。
+ */
+export interface CssUrl {
+    url: string;
+    /** url() / @import / image-set / image / src */
+    via: string;
+}
+export interface CssCheckResult {
+    errors: string[];
+    /** https の外部 URL（承認の対象） */
+    externals: CssUrl[];
+}
+export type UrlKind = "placeholder" | "data-image" | "data-svg" | "https" | "relative" | "fragment" | "bad";
+/** 置き換えタグの形（#{&p} #{&n} #{&f(fileKey)} #{&q(文字列)}） */
+export declare const PLACEHOLDER_RE: RegExp;
+/**
+ * URL を Chrome の URL パーサーと同じ前処理で整える: 両端の引用符、両端の C0 制御文字と空白を外し、途中のタブ・改行・復帰を捨てる。
+ * 分類（classifyUrl）と承認の照合（policy）の両方でこれを使う。
+ */
+export declare function cleanUrl(raw: string): string;
+/** URL の分類（HTML の属性と共通） */
+export declare function classifyUrl(raw: string): UrlKind;
+/**
+ * srcset の候補から URL だけを取り出す（HTML の仕様の手順を簡略化: 空白と , を読み飛ばし、URL は空白まで、
+ * URL の末尾の , は区切り。記述子は次の , まで（括弧の中の , は除く）。data: URL の中の , で壊れない）
+ */
+export declare function parseSrcsetUrls(value: string): string[];
+/** コメントを除く（文字列の中の /* は壊さない） */
+export declare function stripCssComments(css: string): string;
+export interface CssTokens {
+    /** コメント無し・文字列は \u0001N\u0001 の印・エスケープは復号済み */
+    code: string;
+    /** 印の番号 → 文字列の中身（復号済み） */
+    strings: string[];
+}
+/** CSS の簡易トークナイザー（コメント、文字列、エスケープ） */
+export declare function tokenizeCss(css: string): CssTokens;
+/** CSS のエスケープを復号する（文字列の外の走査用。tokenizeCss と同じ規則） */
+export declare function decodeCssEscapes(text: string): string;
+/** 検査用の本文（デバッグ用。コメント無し・復号済み。文字列は "" に） */
+export declare function prepareCss(css: string): string;
+/** url(...) と URL を持てる関数・@import の中身を取り出す（引用符あり / なし。#{&f(...)} を含むときは )} まで） */
+export declare function extractUrls(css: string): CssUrl[];
+export declare function checkCss(css: string): CssCheckResult;

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

@@ -0,0 +1,30 @@
+/**
+ * 派生値の生成（docs/authoring-plan.md 12.2。段階 0 の work/authoring-spike/spike-normalize.mjs の移植 + 更新項目の行の再構成）。印刷屋のコードは API から使う。
+ * 入力にあった派生値は信用せず上書きする:
+ *   - HTML 設定の各行: id、formula（formulaSet からコメントを除いたもの）、usedFields（実エンジンで crec を評価）
+ *   - 更新項目: 行の並びと state / formulaSet / remark は AI のまま、type / ptcode / row_type / lookup / fieldlabel / required は
+ *     fields + layout の一覧（createFieldsInfo）で上書き（設定画面の buildCalcRows と同じ）。一覧に無い項目はエラー。先頭は $out（無ければ既定の "1" を足す）。
+ *     一覧にあって入力に無い項目は足さない（設定画面の「未使用を除く」の後の形）。入力が [] なら [] のまま（dialog を開いていないボタン）。
+ *     calcInfo.usedFields は有効な行の和、flinkage は false
+ *   - views（viewsCsv から）、id の振り直し（toSavedRows）、ルートの usedFields と pluginUOG（computeUsage）
+ */
+import type { Engine } from "../engine.ts";
+import type { Findings } from "./findings.ts";
+import { type Model } from "./model.ts";
+import type { MenuRow, TagRow } from "../_print-craft/src/config/schema.ts";
+/** 封筒のキー（kit の export-import.ts と同じ） */
+export declare const ENVELOPE_KEYS: readonly ["date", "pluginName", "pluginID", "PluginVersion", "appId", "appName"];
+/** 外枠（kit の shell）が付け足すキー。CONFIG_SCHEMA に無く、インポートで落ちる */
+export declare const SHELL_KEYS: readonly ["pluginProductEnv", "pluginLastUpdate", "pluginUpdater", "startDate", "name", "version", "ldate"];
+export interface EvalResult {
+    formula: string;
+    usedFields: Record<string, unknown>;
+    error?: string;
+}
+/** 設定画面の formulaRule と同じ: 検証用レコードで評価して usedFields を取る */
+export declare function evaluateFormula(engine: Engine, model: Model, formulaSet: string): EvalResult;
+export declare function rowLabel(row: MenuRow, index: number): string;
+export declare function tagRowLabel(tag: TagRow, index: number): string;
+/** 設定本体（封筒と外枠のキーを除いたもの）を取り出す */
+export declare function bodyOf(envelope: Record<string, unknown>): Record<string, unknown>;
+export declare function deriveBody(input: Record<string, unknown>, model: Model, engine: Engine, f: Findings): Record<string, unknown>;

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

@@ -0,0 +1,21 @@
+/** normalize の検査結果（docs/authoring-plan.md 12.3。エラー / 警告 / 情報） */
+export type Level = "error" | "warning" | "info";
+export interface Finding {
+    level: Level;
+    /** 規則の名前（機械可読。例 html.script、field.filecode） */
+    rule: string;
+    /** 場所（例 「見積書 / HTML 設定 3 行目 (本文)」） */
+    where: string;
+    message: string;
+}
+export declare class Findings {
+    readonly items: Finding[];
+    add(level: Level, rule: string, where: string, message: string): void;
+    error(rule: string, where: string, message: string): void;
+    warning(rule: string, where: string, message: string): void;
+    info(rule: string, where: string, message: string): void;
+    count(level: Level): number;
+    get hasErrors(): boolean;
+    /** 画面に出す表（レベル → 場所 → 文言） */
+    format(): string;
+}

package/dist/types/normalize/html-check.d.ts

@@ -0,0 +1,23 @@
+export { parseSrcsetUrls } from "./css-check.ts";
+export interface HtmlExternal {
+    url: string;
+    /** 例 >div>img[src]、iframe[src]、<style> url() */
+    via: string;
+}
+export interface HtmlCheckResult {
+    errors: string[];
+    warnings: string[];
+    externals: HtmlExternal[];
+}
+export declare const ALLOWED_TAGS: Set<string>;
+/** URL として分類する属性 */
+export declare const URL_ATTRS: Set<string>;
+/** 要素が使えないときの文言（使えれば null）。計算式の TAG / VTAG の要素名の検査にも使う */
+export declare function tagError(tag: string, where?: string): string | null;
+/** 属性が使えるか（tag が分からないときは、どの要素でも使える属性か、どれかの要素で使える属性か） */
+export declare function attrAllowed(tag: string | undefined, name: string): boolean;
+export declare function checkHtml(html: string, opt?: {
+    baseUrl?: string;
+}): Promise<HtmlCheckResult>;
+/** HTML の ${式} を列挙する（生の差し込みの警告用） */
+export declare function expressionsOf(html: string): string[];

package/dist/types/normalize/line-diff.d.ts

@@ -0,0 +1,8 @@
+/** 行の差分（LCS。設定の HTML / CSS / 式の比較用。大きすぎるときは全体の置き換えとして返す） */
+export interface DiffLine {
+    kind: " " | "-" | "+";
+    text: string;
+}
+export declare function lineDiff(a: string, b: string): DiffLine[];
+/** 変わった行と前後 context 行だけにする */
+export declare function formatDiff(lines: DiffLine[], context?: number): string;

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

@@ -0,0 +1,36 @@
+/**
+ * fields/<app>.json（fields コマンドの出力）から、設定画面と同じ項目の模型を作る（docs/authoring-plan.md 12.2）。印刷屋のコードは API（engine.api）から使う。
+ *   pp     … properties + $id / $revision / $html → createCheckRecord（テーブルの子を ptcode 付きで平らに足す）。設定画面の load.ts 204〜214 行と同じ作り方
+ *   crec   … 計算式の検証用レコード（空の値）
+ *   ppRun  … 実行用（preview）。デスクトップと同じ expandFields
+ *   calcCandidates … 更新項目にできる項目（createFieldsInfo。テーブルの子を除く）
+ */
+import type { PrintCraftAuthoringApi } from "../_print-craft/src/authoring/api.ts";
+import type { FieldInfo, FieldProp } from "../_print-craft/src/config/load.ts";
+import type { FieldsFile } from "../commands/fields.ts";
+export declare const PSEUDO_FIELDS: Set<string>;
+/** UINFO / OINFO / GINFO を使った印（項目ではない。lib 26 行） */
+export declare const UOG_MARK = "$UGO$";
+export declare const EXEC_CONDITION_LABEL = "\u5B9F\u884C\u6761\u4EF6";
+export interface Model {
+    api: PrintCraftAuthoringApi;
+    file: FieldsFile;
+    /** .env の KINTONE_BASE_URL（検証済み）。無ければ ""（iframe は使えない） */
+    baseUrl: string;
+    /** fields の baseUrl（kintone のドメインなら正規化、違えば ""）。表示と警告だけに使う */
+    fieldsBaseUrl: string;
+    appId: number;
+    pp: Record<string, FieldProp>;
+    crec: Record<string, unknown>;
+    ppRun: Record<string, FieldProp>;
+    calcCandidates: FieldInfo[];
+    calcByCode: Map<string, FieldInfo>;
+}
+/**
+ * @param trustedBaseUrl .env の KINTONE_BASE_URL（検証済み）。iframe の同一オリジンの判定はこれだけを使う（無ければ iframe は使えない）
+ */
+export declare function buildModel(file: FieldsFile, api: PrintCraftAuthoringApi, trustedBaseUrl?: string): Model;
+/** 項目コードが使えるか（usedFields の実在チェック。12.3） */
+export declare function fieldExists(model: Model, code: string): boolean;
+/** 更新項目にできない理由（できれば null） */
+export declare function calcIneligibleReason(model: Model, code: string): string | null;

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

@@ -0,0 +1,29 @@
+export interface AllowRule {
+    origin?: string;
+    url?: string;
+    files?: string[];
+    note?: string;
+}
+export interface Policy {
+    allowExternal: AllowRule[];
+    /** externalRefs: "allow" を許す設定ファイル（正規化した相対パス） */
+    allowExternalRefs?: string[];
+    /** 読んだファイル（無ければ undefined） */
+    file?: string;
+}
+export declare class PolicyError extends Error {
+}
+export declare const POLICY_FILE: string;
+export declare const DEFAULT_ALLOWED_ORIGINS: string[];
+/** 相対パスの正規化（\ → /、./ を外す、連続する / を 1 つに。Windows は小文字に）。.. や絶対パスは使えない */
+export declare function normalizeRel(p: string): string;
+/** policy の JSON を検証して読む（未知のキー、型、件数、URL の形） */
+export declare function parsePolicy(text: string, file: string): Policy;
+/** 設定ファイルが externalRefs: "allow" を使ってよいか（settingsFile は cwd からの相対パス。分からなければ許さない） */
+export declare function isExternalRefsAllowed(policy: Policy, settingsFile?: string): boolean;
+/** リポジトリ（cwd）の policy/authoring-policy.json を読む。無ければ承認なし */
+export declare function loadPolicy(opt: {
+    cwd: string;
+}): Policy;
+/** URL が承認済みか（settingsFile は cwd からの相対パス） */
+export declare function isAllowed(policy: Policy, url: string, settingsFile?: string): boolean;

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

@@ -0,0 +1,16 @@
+/**
+ * 保存値の大きさ（docs/authoring-plan.md 12.3、Codex MAJOR 6）。印刷屋の API 経由で kit の writeConfig（print-craft の保存形式 compressed）を呼び、
+ * kintone の制限（1 値 65,535 文字、合計 256 KB）を設定画面と同じコードで検査する。表示の合計も kit の checkLimits と同じくキー + 値のバイト数。
+ */
+import type { PrintCraftAuthoringApi } from "../_print-craft/src/authoring/api.ts";
+export interface StoredSize {
+    ok: boolean;
+    totalBytes: number;
+    maxTotalBytes: number;
+    splitCount: number;
+    maxValueLength: number;
+    maxValueLimit: number;
+    error?: string;
+}
+export declare function measureStored(data: unknown, api: PrintCraftAuthoringApi): Promise<StoredSize>;
+export declare function formatSize(s: StoredSize): string;

package/dist/types/paths.d.ts

@@ -0,0 +1,7 @@
+/** tools/ */
+export declare const AUTHORING_ROOT: string;
+/** リポジトリ print-craft-authoring のルート（テンプレートの置き場所） */
+export declare const REPO_ROOT: string;
+export declare const VENDOR_DIR: string;
+export declare const MOMENT_URL = "https://js.cybozu.com/momentjs/2.24.0/moment-with-locales.min.js";
+export declare const MOMENT_FILE: string;

package/dist/types/permission.d.ts

@@ -0,0 +1,21 @@
+import { type EnvRole } from "./workspace.ts";
+export declare class PermissionError extends Error {
+}
+export type ChangeOp = "settings" | "snapshot" | "fields" | "record" | "preview";
+/** アプリのフォルダーの中の場所（docs/permission-table.md の P4〜P9） */
+export type TargetClass = "snapshot" | "edit" | "report" | "fields" | "record" | "out" | "other";
+export interface TargetRole {
+    role: EnvRole;
+    /** 環境の名前（分かるとき） */
+    envName?: string;
+    /** 未分類の理由 */
+    why?: string;
+    /** アプリのフォルダーの中の場所（フォルダーが分かるとき） */
+    cls?: TargetClass;
+}
+/** アプリのフォルダーからの相対パスで場所を分ける */
+export declare function classOfAppPath(relInFolder: string): TargetClass;
+/** kintone/ の下のファイルの環境・役割・場所（kintone/ の外なら null）。environments.json はその場で読む */
+export declare function roleOfTarget(root: string, file: string): TargetRole | null;
+/** kintone/ の下をこの操作で変えてよいか。だめなら PermissionError（決まった文） */
+export declare function assertChangeAllowed(root: string, file: string, op: ChangeOp): void;

package/dist/types/plugin-zip.d.ts

@@ -0,0 +1,53 @@
+export declare class PluginZipError extends Error {
+}
+export interface ZipLimits {
+    maxOuterBytes: number;
+    maxEntries: number;
+    maxEntryBytes: number;
+    maxTotalBytes: number;
+}
+/** 印刷屋の zip は 1 MB 程度。余裕を見た上限 */
+export declare const ZIP_LIMITS: ZipLimits;
+/** CRC-32（zip と同じ。Node 20 には zlib.crc32 が無いので自前） */
+export declare function crc32(buf: Uint8Array): number;
+/** zip の全エントリーを { 名前 → 中身 } に展開する（上限と整合性を確かめる） */
+export declare function unzip(buf: Buffer, limits?: ZipLimits): Map<string, Buffer>;
+export interface PluginManifest {
+    manifest_version?: number;
+    version?: number | string;
+    name?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface PluginSources {
+    /** 入力（zip のパス、または開発中の print-craft のフォルダー） */
+    from: string;
+    manifest: PluginManifest;
+    pluginVersion: string;
+    engine: string;
+    bignumber: string;
+    momentTimezone: string;
+    /** 印刷屋の authoring API（Ver.6 以降の zip にある。無ければ undefined） */
+    api?: string;
+    /** プラグイン ID（zip の PUBKEY から。開発中のフォルダーと PUBKEY の無い zip は undefined） */
+    pluginId?: string;
+    sha256: {
+        engine: string;
+        api?: string;
+        bignumber: string;
+        momentTimezone: string;
+        contents?: string;
+    };
+}
+export declare const ENGINE_ENTRY = "desktop_js/KintoneFormulaPCraft.min.js";
+export declare const BIGNUMBER_ENTRY = "desktop_js/bignumber.min.js";
+export declare const MOMENT_TZ_ENTRY = "desktop_js/moment-timezone-with-data.min.js";
+export declare const API_ENTRY = "config_js/print-craft-authoring-api.js";
+export declare const MANIFEST_ENTRY = "manifest.json";
+export declare function sha256Hex(data: string | Buffer): string;
+/**
+ * プラグイン ID（kintone の @kintone/plugin-packer の uuid と同じ: 外側の zip の PUBKEY（公開鍵の DER）の SHA-256 の先頭 32 桁を 0-9a-f → a-p）。
+ * 印刷屋は 5 変種とも同じ鍵で作るので同じ ID（pull がプラグインの設定を取るときの id。2026-10-05）
+ */
+export declare function pluginIdOf(publicKey: Buffer): string;
+/** 印刷屋の zip（2 層）から tools が要るものを取り出す */
+export declare function readPluginZip(file: string): PluginSources;

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

@@ -0,0 +1,82 @@
+/**
+ * 帳票 HTML のプレビュー（docs/authoring-plan.md 12.2 の preview、Codex BLOCKER 1 / MAJOR 4 の反映。1-10 レビュー BLOCKER 4）。印刷屋のコードは API（engine.api）から。
+ *   - CSS は印刷屋と同じ buildReportCss（ページの基本 → 共通 CSS → 行の CSS）。文書に入れる前に `<` を CSS のエスケープ（\3c）にして、CSS から </style> で抜けられないようにする
+ *   - HTML は authoring 専用の行単位レンダラー: ${式} ごと・行の計算式ごとに catch し、失敗した式はエスケープして赤字で埋めて続ける
+ *   - #{&f(…)} / #{&q(…)} はダミー画像、#{&p} / #{&n} はページ番号（印刷屋の replaceTags を happy-dom の DOM で動かす）
+ *   - 描いた DOM から、動きや通信や遷移の元になる要素と属性を外す（script / meta / link / form / iframe / SMIL …、on*、href、srcdoc …）。
+ *     レコードの値が TABLE_HTML などで HTML として入る経路があるため、テンプレートの検査（html-check）とは別にここでも外す
+ *   - 出力は 2 層の HTML: 外側の文書の中に sandbox 属性だけの iframe を置き、帳票の文書を srcdoc で入れる。帳票の文書にも CSP（img は data: だけ）
+ *   - Web フォント（Takashi 2026-10-05「preview で、指定した WEB フォントを利用できるようにすることは可能か？」→ Go）: 配信元が承認済み（Google Fonts は既定、
+ *     他は policy の allowExternal）のときだけ、帳票の文書に <link rel="stylesheet"> を入れ、CSP の style-src / font-src にその配信元を足す
+ *     （Google Fonts は fonts.googleapis.com と fonts.gstatic.com）。preview の外部通信はこれだけで、送るのは設定に書いた固定の URL。未承認なら読まない（OS の書体）
+ */
+import type { PrintCraftAuthoringApi } from "../_print-craft/src/authoring/api.ts";
+import type { MenuRow } from "../_print-craft/src/config/schema.ts";
+import type { Engine, FormulaInstance } from "../engine.ts";
+import type { Model } from "../normalize/model.ts";
+import type { KintoneRecord } from "../commands/record.ts";
+export declare const PREVIEW_CSP = "default-src 'none'; img-src data:; style-src 'unsafe-inline'; font-src data:; connect-src 'none'; frame-src 'none'; object-src 'none'; base-uri 'none'; form-action 'none'";
+export declare const OUTER_CSP = "script-src 'none'; object-src 'none'; base-uri 'none'; form-action 'none'; style-src 'unsafe-inline'; img-src data:; connect-src 'none'";
+/** 帳票の文書に入れる Web フォント（印刷屋の webFontOf と同じ family / cssUrl） */
+export interface PreviewFont {
+    family: string;
+    cssUrl: string;
+}
+/** Web フォントの CSS とフォント本体の配信元（CSP に書く）。Google Fonts は CSS が fonts.googleapis.com、本体が fonts.gstatic.com。https 以外は null */
+export declare function fontOrigins(cssUrl: string): {
+    style: string[];
+    font: string[];
+} | null;
+/** 帳票の文書の CSP。承認済みの Web フォントがあれば、その配信元だけを style-src / font-src に足す */
+export declare function previewCsp(font: PreviewFont | null): string;
+/** プレビューの DOM から外す要素（動き・通信・遷移の元。描画には要らない） */
+export declare const PREVIEW_REMOVE_SELECTOR = "script,meta,link,base,form,input,button,select,textarea,iframe,frame,object,embed,applet,noscript,template,video,audio,source,track,canvas,map,area,animate,animatemotion,animatetransform,animatecolor,set,foreignobject,math";
+export declare function escapeHtml(s: string): string;
+/** <style> の中に入れる CSS: `<` を CSS のエスケープにして、</style> や <!-- で文書を壊せないようにする（文字列の中の < も同じ見た目になる） */
+export declare function escapeCssText(css: string): string;
+export interface RenderedButton {
+    menu: string;
+    fileName: string;
+    pageSize: string;
+    orientation: string;
+    dpi: string;
+    pages: number;
+    errors: string[];
+    /** 帳票の文書に入れた Web フォントの CSS の URL（承認済みのときだけ。無ければ null） */
+    webFont: string | null;
+    inner: string;
+    html: string;
+}
+/** authoring 専用の行単位レンダラー（印刷屋の buildReportHtml と同じ順序・同じ \ → &yen; の置き換え。失敗しても続ける） */
+export declare function renderRows(api: PrintCraftAuthoringApi, row: MenuRow, record: KintoneRecord, kf: FormulaInstance, errors: string[]): string;
+interface DomElement {
+    tagName: string;
+    attributes: ArrayLike<{
+        name: string;
+        value: string;
+    }>;
+    textContent: string | null;
+    innerHTML: string;
+    querySelectorAll(selector: string): ArrayLike<DomElement>;
+    removeAttribute(name: string): void;
+    remove(): void;
+}
+/** 描いた DOM から動き・通信・遷移の元を外す。外した数を返す */
+export declare function sanitizePreviewDom(host: DomElement): {
+    removedElements: number;
+    removedAttributes: number;
+};
+export interface RenderInput {
+    body: Record<string, unknown>;
+    row: MenuRow;
+    model: Model;
+    engine: Engine;
+    record: KintoneRecord;
+    /** 設定の Web フォント（有効なとき）と、配信元が承認済みか（policy。Google Fonts は既定で承認） */
+    webFont?: {
+        font: PreviewFont;
+        approved: boolean;
+    } | null;
+}
+export declare function renderButton(input: RenderInput): RenderedButton;
+export {};

package/dist/types/safe-path.d.ts

@@ -0,0 +1,24 @@
+export declare class PathError extends Error {
+}
+/** 書き込みを許す場所（cwd からの相対）。kintone/ は environments.json があるときのアプリのフォルダー（workspace.ts） */
+export declare const WRITE_ROOTS: {
+    readonly fields: readonly ["fields", "kintone"];
+    readonly records: readonly ["records", "kintone"];
+    readonly settings: readonly ["settings", "temp", "kintone"];
+    readonly out: readonly ["out", "kintone"];
+    readonly kintone: readonly ["kintone"];
+};
+/**
+ * 存在する最も深い親の realpath に残りを足した絶対パス。
+ * 親を探すのは lstat で「本当に無い」（ENOENT / ENOTDIR）ときだけ上がり、リンク切れ・ループ・アクセス不能は止める（fail closed。再レビュー MAJOR 5）
+ */
+export declare function realResolve(target: string, cwd: string): string;
+export declare function isInside(child: string, parent: string): boolean;
+/** 読む入力（設定 JSON、fields、record）: cwd の中。.env と node_modules と .git は読まない */
+export declare function resolveRead(target: string, cwd: string): string;
+/** 書き込み先: cwd の中の roots のどれかの下（root そのものではない）。返すのは絶対パス */
+export declare function resolveWrite(target: string, roots: readonly string[], cwd: string): string;
+/** 書き込み先のフォルダー（preview の --out-dir）: cwd の中の roots のどれか、またはその下 */
+export declare function resolveWriteDir(target: string, roots: readonly string[], cwd: string): string;
+/** ファイル名に使えない文字と Windows の予約名を避ける（preview の out/<ボタン名>.html） */
+export declare function safeFileName(name: string, fallback: string): string;