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

package/dist/types/workspace.d.ts

@@ -0,0 +1,84 @@
+export declare const WORKSPACE_FILE = "environments.json";
+export declare const KINTONE_ROOT = "kintone";
+export declare const INBOX = "inbox";
+/** 設定画面のダウンロードのファイル名の接頭辞（kit の exportFileName。print-craft の exportPrefix） */
+export declare const SNAPSHOT_PREFIX = "rex0220-print-craft";
+export declare const SNAPSHOT_RE: RegExp;
+export declare const EDIT_RE: RegExp;
+export declare class WorkspaceError extends Error {
+}
+/**
+ * 環境の役割（段階 0-2 の段 3。print-craft-authoring-mcp の実装案 13.3、permission-table.md）。environments.json に書けるのは
+ * development / production だけ。書いていない環境は内部だけの状態 unclassified（読み取りと診断だけ。kintone/ の下を変えられない）
+ */
+export type EnvRole = "development" | "production" | "unclassified";
+export declare const ENV_ROLES: readonly ["development", "production"];
+export interface EnvironmentDef {
+    name: string;
+    /** 役割（書いていなければ unclassified） */
+    role: EnvRole;
+    /** 正規化した接続先（https://<サブドメイン>.cybozu.com） */
+    baseUrl: string;
+    /** フォルダー名に使うホスト名 */
+    host: string;
+    /** 認証のファイル（作業フォルダーからの相対。.env か env/<名前>.env） */
+    envFile: string;
+}
+export interface AppDef {
+    /** 論理アプリ名（--app に書ける名前） */
+    name: string;
+    /** 環境の名前 → アプリ番号 */
+    ids: Record<string, number>;
+}
+export interface Workspace {
+    defaultEnv: string;
+    environments: Record<string, EnvironmentDef>;
+    apps: AppDef[];
+}
+export declare const isEnvName: (s: string) => boolean;
+/** environments.json を検証して読む（未知のキー、名前の形、接続先、envFile の場所、番号を厳しく見る） */
+export declare function parseWorkspace(text: string, where?: string): Workspace;
+/** 作業フォルダーの environments.json（無ければ null = 今までの形） */
+export declare function loadWorkspace(cwd: string): Workspace | null;
+export declare function pickEnv(ws: Workspace, name?: string): EnvironmentDef;
+/** --app の値（番号か、apps の名前）をその環境のアプリ番号にする */
+export declare function resolveApp(ws: Workspace, env: EnvironmentDef, app: string): {
+    appId: number;
+    name?: string;
+};
+/** アプリのフォルダーの名前（番号-アプリ名。名前が使えなければ番号だけ） */
+export declare function folderNameOf(appId: number, appName: string): string;
+export declare function hostDirOf(cwd: string, env: EnvironmentDef): string;
+/** 今あるアプリのフォルダー（番号で探す。無ければ null。同じ番号が 2 つあれば止まる） */
+export declare function findAppDir(cwd: string, env: EnvironmentDef, appId: number): string | null;
+/** アプリのフォルダー（あればそれ、無ければ 番号-アプリ名 で作る場所。作るのは書くとき） */
+export declare function appDirFor(cwd: string, env: EnvironmentDef, appId: number, appName: string): string;
+/** ファイルが kintone/<ホスト>/<番号>-…/ の中（records/ などの下を含む）なら、そのフォルダーとホストと番号 */
+export declare function appFolderOfFile(cwd: string, file: string): {
+    dir: string;
+    host: string;
+    appId: number;
+} | null;
+/** ダウンロードと同じ名前（kit の exportFileName と同じ。日時はこの PC の時刻） */
+export declare function snapshotNameOf(appId: number, now?: Date): string;
+export declare function editNameOf(snapshotFile: string): string;
+export interface AppFolderList {
+    dir: string;
+    hasFields: boolean;
+    /** ダウンロードと pull（新しい順） */
+    snapshots: string[];
+    /** 直したもの（新しい順） */
+    edits: string[];
+    /** AI が作った帳票など、その他の json */
+    reports: string[];
+    records: string[];
+    outs: number;
+}
+export declare function listAppFolder(dir: string): AppFolderList;
+/** 環境のうち、ホスト名が同じもの（構成 2 では 2 つ以上ある） */
+export declare function envsOfHost(ws: Workspace, host: string): EnvironmentDef[];
+/**
+ * アプリのフォルダー（kintone/<ホスト>/<番号>-…/）がどの環境のものか。ホストが 1 つの環境だけならそれ、
+ * 同じホストの環境が 2 つ以上（構成 2）なら apps でその番号を持つ環境が 1 つだけのときそれ。決まらなければ undefined
+ */
+export declare function envOfAppFolder(ws: Workspace, host: string, appId: number): EnvironmentDef | undefined;

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "@rex0220/print-craft-authoring-tools",
-  "version": "1.2.0",
-  "description": "rex0220 印刷屋プラグイン（kintone）の設定 JSON を AI で作る・確かめるための tools（fields / record / pull / normalize / preview / diff / buttons / version）。計算式エンジンと印刷屋のコードは利用者の印刷屋プラグインの zip から読む",
+  "version": "1.3.0",
+  "description": "rex0220 印刷屋プラグイン（kintone）の設定 JSON を AI で作る・確かめるための tools（fields / record / pull / normalize / preview / diff / buttons / version）。共通の中核（@rex0220/print-craft-authoring-tools/core。print-craft MCP が使う）も含む。計算式エンジンと印刷屋のコードは利用者の印刷屋プラグインの zip から読む",
   "license": "MIT",
   "type": "module",
   "bin": {
     "pcraft-authoring": "dist/cli.mjs"
   },
+  "exports": {
+    "./core": {
+      "types": "./dist/types/core.d.ts",
+      "import": "./dist/core.mjs",
+      "default": "./dist/core.mjs"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist/**",
     "vendor/**",