@first-ch/tools-mcp 0.42.0 → 0.42.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/fit-to-box.mjs +398 -0
  2. package/package.json +2 -1
package/fit-to-box.mjs ADDED
@@ -0,0 +1,398 @@
1
+ /* 記入欄に収める字の大きさと改行位置(fit_to_box)
2
+ * 割り付けのコア(fitAddress / fitText / fitToBox / daiji ほか)は
3
+ * FirstCHTools の site/nakabukuro-ran/app.js と同一
4
+ * (2箇所ルール: site側が正本・片方を直したらもう片方も同じ内容で反映する)。
5
+ * 両ファイルからコアの開始/終了コメントに挟まれた範囲を sed で切り出し
6
+ * (site側は字下げ2文字を落とす・こちらは行頭の export を落とす)、
7
+ * diff が空になることで同期を機械的に確認できる。
8
+ *
9
+ * 市販の中袋(ご祝儀袋・香典袋)など、欄が印刷済みの用紙に手で書くときに、欄の幅・高さ(mm)と向きから
10
+ * 収まる1字の大きさ・行数・改行位置を返す。住所は「〜番地」と「建物名・部屋番号」の境目を優先して改行し、
11
+ * 縦書きでは番地を漢数字に、金額は大字にする。完全ローカル処理・ネットワーク送信なし。 */
12
+
13
+ // ==== ここからコア(DOM に触らない。tests/nakabukuro-ran.test.mjs が確かめる。MCP の fit-to-box.mjs と同じ)====
14
+ export var PAD = 1.5; // 欄の線の内側に空ける余白(mm・四辺)
15
+ export var GAP = 0.3; // 行と行の間(1字の大きさに対する比)
16
+ export var MIN_OK = 4; // 1字がこれを下回ると、代わりの割り付けを並べる(mm)
17
+ export var MAX_LINES = 4; // 住所の行数の上限(郵便番号の行を除く)
18
+ export var CAP = { address: 9, name: 14, amount: 14, plain: 12 }; // 欄が大きくても、手書きでこれより大きくはしない(mm)
19
+ export var NAIVE = 5; // 「そのまま書く」ときの1字の大きさ(mm)
20
+ export var KAN = '〇一二三四五六七八九';
21
+ export var DAIJI = ['', '壱', '弐', '参', '四', '伍', '六', '七', '八', '九'];
22
+ export var NUM_K = '〇一二三四五六七八九十百千';
23
+ export var NO_HEAD = 'ぁぃぅぇぉっゃゅょゎァィゥェォッャュョヮヵヶー・、。,.)」』】〕〉》!?!?)]}室階-'; // 行頭に来させない字
24
+ export var ROTATE_V = 'ー--‐―—〜~…‥()()「」『』【】〔〕〈〉《》[]{}=='; // 縦書きで90度回す字
25
+ export var SMALL_V = 'ぁぃぅぇぉっゃゅょゎァィゥェォッャュョヮヵヶ';
26
+ export var PUNCT_V = '、。,.';
27
+
28
+ // 全角英数を半角に、全角空白を半角に、連続する空白を1つに(改行は残す)
29
+ export function toHalf(s) {
30
+ return String(s == null ? '' : s)
31
+ .replace(/[!-~]/g, function (c) { return String.fromCharCode(c.charCodeAt(0) - 0xFEE0); })
32
+ .replace(/\r\n?/g, '\n').replace(/[ \t]/g, ' ').replace(/ +/g, ' ')
33
+ .split('\n').map(function (l) { return l.trim(); }).join('\n').replace(/\n{2,}/g, '\n').trim();
34
+ }
35
+ // 住所の正規化: 数字の間のハイフン類をすべて「-」にそろえる
36
+ export function normAddress(s) {
37
+ return toHalf(s).replace(/([0-9])\s*[‐‑‒–—―−ーー--]\s*(?=[0-9])/g, '$1-');
38
+ }
39
+ export function normPostal(s) {
40
+ var d = toHalf(s).replace(/[^0-9]/g, '');
41
+ if (!d) return '';
42
+ return d.length === 7 ? d.slice(0, 3) + '-' + d.slice(3) : d;
43
+ }
44
+ // 算用数字の列を漢数字に。style='digits' は「一〇」型(1字ずつ)、'tens' は「十」型(位取り・4桁まで)
45
+ export function kanjiNum(digits, style) {
46
+ var n = parseInt(digits, 10);
47
+ if (style !== 'tens' || /^0/.test(digits) || n === 0 || digits.length > 4) {
48
+ return digits.replace(/[0-9]/g, function (d) { return KAN[+d]; });
49
+ }
50
+ var out = '', units = ['', '十', '百', '千'];
51
+ for (var i = digits.length - 1, p = 0; i >= 0; i--, p++) {
52
+ var d = +digits[i];
53
+ if (!d) continue;
54
+ out = ((d === 1 && p > 0) ? '' : KAN[d]) + units[p] + out;
55
+ }
56
+ return out;
57
+ }
58
+ // 横書きの文字列を縦書き用に: 数字は漢数字、ハイフンは「ー」、英字・記号は全角(縦書きで立てて書く)
59
+ export function verticalize(s, style) {
60
+ return String(s).replace(/[0-9]+/g, function (d) { return kanjiNum(d, style); })
61
+ .replace(/-/g, 'ー')
62
+ .replace(/[!-~]/g, function (c) { return String.fromCharCode(c.charCodeAt(0) + 0xFEE0); });
63
+ }
64
+ // 金額を大字に(1〜99,999,999円)。opts: sen('阡'|'千'|'仟')・en('円'|'圓')・nari(也を付ける)・printed(「金」「円」が欄に印刷済み)
65
+ export function parseAmount(s) {
66
+ var t = toHalf(s).replace(/[,,、\s円圓]/g, '');
67
+ if (!t) return null;
68
+ var m = /^([0-9]+)(?:万([0-9]*))?$/.exec(t);
69
+ if (!m) return NaN;
70
+ var n = m[2] !== undefined ? (+m[1]) * 10000 + (m[2] ? +m[2] : 0) : +m[1];
71
+ return n;
72
+ }
73
+ export function daiji(n, opts) {
74
+ opts = opts || {};
75
+ if (!(n >= 1 && n <= 99999999 && Math.floor(n) === n)) return null;
76
+ var sen = opts.sen || '阡', units = ['', '拾', '百', sen];
77
+ function group(g) {
78
+ var out = '';
79
+ for (var p = 3; p >= 0; p--) {
80
+ var d = Math.floor(g / Math.pow(10, p)) % 10;
81
+ if (d) out += DAIJI[d] + units[p];
82
+ }
83
+ return out;
84
+ }
85
+ var hi = Math.floor(n / 10000), lo = n % 10000;
86
+ var body = (hi ? group(hi) + '萬' : '') + group(lo);
87
+ if (opts.printed) return body;
88
+ return '金' + body + (opts.en || '円') + (opts.nari ? '也' : '');
89
+ }
90
+
91
+ // 1字の幅(1字の大きさに対する比)。横書きの半角英数・記号は 0.6、空白は 0.5、ほかは1
92
+ export function unitOf(ch, orient) {
93
+ if (ch === ' ') return 0.5;
94
+ if (orient !== 'v' && /[!-~]/.test(ch)) return 0.6;
95
+ return 1;
96
+ }
97
+ export function unitsOf(str, orient) {
98
+ var u = 0;
99
+ for (var i = 0; i < str.length; i++) u += unitOf(str[i], orient);
100
+ return u;
101
+ }
102
+ // 欄の中に入る大きさ。lines は行ごとの幅(字数相当)
103
+ export function sizeFor(lineUnits, w, h, orient, cap) {
104
+ var L = (orient === 'v' ? h : w) - 2 * PAD, C = (orient === 'v' ? w : h) - 2 * PAD;
105
+ if (L <= 0 || C <= 0 || !lineUnits.length) return 0;
106
+ var n = lineUnits.length, maxU = Math.max.apply(null, lineUnits.concat([0.5]));
107
+ return Math.max(0, Math.min(L / maxU, C / (n + (n - 1) * GAP), cap));
108
+ }
109
+ export function floor1(x) { return Math.floor(x * 10 + 1e-9) / 10; }
110
+
111
+ // 住所を「都道府県」「〜番地」「建物名・部屋番号」に分ける(横書きの正規化済みの文字列で)
112
+ export var PREF_RE = /^(東京都|北海道|(?:京都|大阪)府|[^\s0-9]{2,3}?県)/;
113
+ export var CHAIN_RE = /[0-9]+(?:(?:丁目|番地|番|号|の|-)+[0-9]+)*(?:丁目|番地|番|号)?/g;
114
+ export var KCHAIN_RE = /[〇一二三四五六七八九十百千]+(?:丁目|番地|番|号)(?:(?:の|-|ー)?[〇一二三四五六七八九十百千]+(?:番地|番|号)?)*/g;
115
+ export function splitAddress(addr) {
116
+ var s = normAddress(addr), main = s, building = '', explicit = false;
117
+ var nl = s.indexOf('\n');
118
+ if (nl >= 0) { main = s.slice(0, nl); building = s.slice(nl + 1).replace(/\n/g, ' '); explicit = true; }
119
+ else {
120
+ var end = -1, m;
121
+ CHAIN_RE.lastIndex = 0;
122
+ while ((m = CHAIN_RE.exec(s))) {
123
+ var next = s.charAt(m.index + m[0].length);
124
+ if (/[条線丁地]/.test(next)) continue; // 「北4条西」の 4 のように町名の一部の数字
125
+ end = m.index + m[0].length; break;
126
+ }
127
+ if (end < 0) {
128
+ KCHAIN_RE.lastIndex = 0;
129
+ if ((m = KCHAIN_RE.exec(s))) end = m.index + m[0].length;
130
+ }
131
+ if (end > 0) { main = s.slice(0, end).trim(); building = s.slice(end).trim(); }
132
+ }
133
+ var pm = PREF_RE.exec(main);
134
+ return { pref: pm ? pm[1] : '', main: main, building: building, explicit: explicit };
135
+ }
136
+
137
+ // 文字列を「区切れる単位(atom)」に分け、各単位の前で改行してよいかを重みで持つ(0 = 改行しない)
138
+ // 数字の並び(「2丁目10番地の18」「1203号」)は1つの単位にして途中で切らない
139
+ export function atomize(text, startWeight) {
140
+ var atoms = [], i = 0, s = String(text), m, spaceBefore = false;
141
+ CHAIN_RE.lastIndex = 0;
142
+ var chains = [];
143
+ while ((m = CHAIN_RE.exec(s))) chains.push([m.index, m.index + m[0].length]);
144
+ var ci = 0;
145
+ while (i < s.length) {
146
+ if (s[i] === ' ') { spaceBefore = true; i++; continue; }
147
+ var t;
148
+ if (ci < chains.length && chains[ci][0] === i) { t = s.slice(i, chains[ci][1]); ci++; }
149
+ else t = s[i];
150
+ while (ci < chains.length && chains[ci][0] < i + t.length) ci++;
151
+ // 区切りの無い字の間で切るのは、ほかに手が無いときだけ(「烏丸通七/条」のように語の途中で切れる)
152
+ var w = atoms.length ? (spaceBefore ? 0.9 : (NO_HEAD.indexOf(t[0]) >= 0 ? 0 : 0.6)) : 0;
153
+ atoms.push({ t: t, w: w, sp: spaceBefore && atoms.length > 0 });
154
+ spaceBefore = false;
155
+ i += t.length;
156
+ }
157
+ return atoms;
158
+ }
159
+ // 位置 at(main の先頭からの文字数)の単位の前の重みを w 以上にする
160
+ export function markAt(atoms, at, w) {
161
+ var pos = 0;
162
+ for (var k = 0; k < atoms.length; k++) {
163
+ if (pos === at && k > 0) { atoms[k].w = Math.max(atoms[k].w, w); return; }
164
+ pos += atoms[k].t.length;
165
+ }
166
+ }
167
+ // 住所1件ぶんの単位の列(郵便番号を除く)。primary は「〜番地」と「建物名」の境目の単位の番号(無ければ -1)
168
+ export function addressAtoms(parts, omitPref) {
169
+ var main = parts.main;
170
+ if (omitPref && parts.pref && main.indexOf(parts.pref) === 0) main = main.slice(parts.pref.length);
171
+ var a = atomize(main);
172
+ var prefLen = (!omitPref && parts.pref && parts.main.indexOf(parts.pref) === 0) ? parts.pref.length : 0;
173
+ if (prefLen) markAt(a, prefLen, 0.95);
174
+ // 市区町村の後(数字の前を含む)
175
+ var pos = 0;
176
+ for (var k = 0; k < a.length; k++) {
177
+ var t = a[k].t;
178
+ if (k > 0 && pos >= prefLen) {
179
+ var prev = a[k - 1].t;
180
+ if (/[市区郡町村]$/.test(prev) && !/^[0-9〇一二三四五六七八九十]/.test(t)) a[k].w = Math.max(a[k].w, 0.95);
181
+ if (/^[0-9]/.test(t) || /^[〇一二三四五六七八九十百千]+(?:丁目|番地|番|号)/.test(t)) a[k].w = Math.max(a[k].w, 0.93);
182
+ }
183
+ pos += t.length;
184
+ }
185
+ var primary = -1, room = -1;
186
+ if (parts.building) {
187
+ var b = atomize(parts.building);
188
+ // 部屋番号の前(末尾の「1203号室」「101」「2F」など)
189
+ var rm = /^(.*\S)\s*([0-9A-Za-z]+(?:-[0-9]+)?\s*(?:号室|号|F|階)?|[〇一二三四五六七八九]+号室)$/.exec(parts.building);
190
+ if (rm && rm[1].length) { markAt(b, parts.building.length - rm[2].length, 0.95); room = a.length + indexAt(b, parts.building.length - rm[2].length); }
191
+ b.forEach(function (x, k) { if (k > 0 && /[棟館]$/.test(b[k - 1].t)) x.w = Math.max(x.w, 0.9); });
192
+ b[0].w = 1; b[0].sp = true;
193
+ primary = a.length;
194
+ a = a.concat(b);
195
+ }
196
+ return { atoms: a, primary: primary, room: room };
197
+ }
198
+ export function indexAt(atoms, at) {
199
+ var pos = 0;
200
+ for (var k = 0; k < atoms.length; k++) { if (pos === at) return k; pos += atoms[k].t.length; }
201
+ return -1;
202
+ }
203
+ // 単位の列を、改行の組み合わせ(最大 maxBreaks 個)から、字がいちばん大きく、区切りの良い割り付けを選ぶ
204
+ // fixed: 先頭に必ず置く行(郵便番号)、must: 必ず改行する単位の番号、primary: 優先する区切り
205
+ export function bestLayout(atoms, conv, opt) {
206
+ var orient = opt.orient, n = atoms.length, cap = opt.cap;
207
+ var disp = atoms.map(function (x) { return conv(x.t); });
208
+ var units = disp.map(function (t) { return unitsOf(t, orient); });
209
+ var cand = [];
210
+ for (var k = 1; k < n; k++) if (atoms[k].w > 0) cand.push(k);
211
+ var must = (opt.must || []).filter(function (k) { return k > 0 && k < n; });
212
+ var fixedU = (opt.fixed || []).map(function (t) { return unitsOf(t, orient); });
213
+ // 「〜番地」と「建物名」の境目で改行する割り付け(pri)と、すべての割り付け(any)の最良をそれぞれ持つ
214
+ var pri = null, any = null, hasPri = opt.primary > 0;
215
+ function lineUnits(breaks) {
216
+ var out = [], start = 0;
217
+ breaks.concat([n]).forEach(function (b) {
218
+ var u = 0;
219
+ for (var k = start; k < b; k++) u += units[k] + (k > start && atoms[k].sp ? 0.5 : 0);
220
+ out.push(u); start = b;
221
+ });
222
+ return out;
223
+ }
224
+ function consider(breaks) {
225
+ for (var i = 0; i < must.length; i++) if (breaks.indexOf(must[i]) < 0) return;
226
+ var lu = lineUnits(breaks);
227
+ var s = sizeFor(fixedU.concat(lu), opt.w, opt.h, orient, cap);
228
+ var score = s;
229
+ if (!opt.maxSize) { // 代わりの割り付けは、区切りの良さより字の大きさを取る
230
+ breaks.forEach(function (b) { score *= atoms[b].w; });
231
+ score *= 1 - 0.03 * breaks.length;
232
+ }
233
+ score -= 1e-5 * lu.reduce(function (a, u) { return a + u * u; }, 0); // 同じ大きさなら、行の長さがそろう方
234
+ var cand1 = { score: score, size: s, breaks: breaks.slice() };
235
+ if (!any || score > any.score + 1e-9) any = cand1;
236
+ if (hasPri && breaks.indexOf(opt.primary) >= 0 && (!pri || score > pri.score + 1e-9)) pri = cand1;
237
+ }
238
+ var maxB = Math.min(opt.maxBreaks == null ? MAX_LINES - 1 : opt.maxBreaks, cand.length);
239
+ consider([]);
240
+ for (var a = 0; a < cand.length && maxB >= 1; a++) {
241
+ consider([cand[a]]);
242
+ for (var b = a + 1; b < cand.length && maxB >= 2; b++) {
243
+ consider([cand[a], cand[b]]);
244
+ for (var c = b + 1; c < cand.length && maxB >= 3; c++) consider([cand[a], cand[b], cand[c]]);
245
+ }
246
+ }
247
+ // 境目で改行して 4mm 以上になるならそれを使う。届かないときだけ、字が大きくなるほかの区切りを使う
248
+ var best = pri && (pri.size >= MIN_OK || !(any.size > pri.size + 0.05)) ? pri : any;
249
+ if (!best) return null;
250
+ var lines = [], start = 0;
251
+ best.breaks.concat([n]).forEach(function (b) {
252
+ var t = '';
253
+ for (var k = start; k < b; k++) t += (k > start && atoms[k].sp ? ' ' : '') + disp[k];
254
+ lines.push(t); start = b;
255
+ });
256
+ return { size: best.size, lines: (opt.fixed || []).concat(lines), breaks: best.breaks };
257
+ }
258
+ export function result(lay, w, h, orient, kind) {
259
+ var size = floor1(lay.size);
260
+ return { size: size, lines: lay.lines, lineCount: lay.lines.length, orientation: orient === 'v' ? 'vertical' : 'horizontal', width: w, height: h,
261
+ ok: size >= MIN_OK, kind: kind };
262
+ }
263
+ export function postalLine(postal, orient, style) {
264
+ var p = normPostal(postal);
265
+ if (!p) return '';
266
+ return orient === 'v' ? '〒' + verticalize(p, 'digits') : '〒' + p;
267
+ }
268
+ // 住所欄。返り値: main(優先の割り付け)・noPref(都道府県を省いた場合)・bld2(建物名を2行にした場合)・naive(そのまま1行で書いた場合)
269
+ export function fitAddress(o) {
270
+ var orient = o.orientation === 'vertical' || o.orientation === 'v' ? 'v' : 'h';
271
+ var w = +o.width, h = +o.height, style = o.numerals === 'tens' ? 'tens' : 'digits';
272
+ var conv = orient === 'v' ? function (t) { return verticalize(t, style); } : function (t) { return t; };
273
+ var parts = splitAddress(o.address || '');
274
+ if (!parts.main) return { error: 'EMPTY' };
275
+ if (!(w > 2 * PAD) || !(h > 2 * PAD)) return { error: 'TOO_SMALL' };
276
+ var fixed = o.postal ? [postalLine(o.postal, orient, style)].filter(Boolean) : [];
277
+ var base = addressAtoms(parts, false);
278
+ var opt = { orient: orient, w: w, h: h, cap: CAP.address, fixed: fixed, primary: base.primary };
279
+ var main = result(bestLayout(base.atoms, conv, opt), w, h, orient, 'address');
280
+ var out = { main: main, parts: { prefecture: parts.pref, main: conv(parts.main), building: conv(parts.building) } };
281
+ // そのまま1行で書いた場合(共有の画像の「はみ出す例」)
282
+ var whole = fixed.concat([conv(parts.main + (parts.building ? ' ' + parts.building : ''))]);
283
+ var C = (orient === 'v' ? w : h) - 2 * PAD, L = (orient === 'v' ? h : w) - 2 * PAD;
284
+ var ns = Math.min(NAIVE, C / (whole.length + (whole.length - 1) * GAP));
285
+ var nu = unitsOf(whole[whole.length - 1], orient);
286
+ out.naive = { size: floor1(ns), lines: whole, need: Math.round(ns * nu * 10) / 10, room: Math.round(L * 10) / 10,
287
+ overflowChars: Math.max(0, Math.ceil((ns * nu - L) / ns)) };
288
+ if (parts.pref) {
289
+ var np = addressAtoms(parts, true);
290
+ out.noPref = result(bestLayout(np.atoms, conv, { orient: orient, w: w, h: h, cap: CAP.address, fixed: fixed, primary: np.primary, maxSize: true }), w, h, orient, 'address');
291
+ }
292
+ if (parts.building && base.primary > 0) {
293
+ var must = [base.primary];
294
+ var inner = [];
295
+ for (var k = base.primary + 1; k < base.atoms.length; k++) if (base.atoms[k].w > 0) inner.push(k);
296
+ if (inner.length) {
297
+ // 建物名の中の区切り(部屋番号の前など)のうち、いちばん重いものを必ず使う
298
+ var bestK = inner.reduce(function (p, k) { return base.atoms[k].w > base.atoms[p].w ? k : p; }, inner[0]);
299
+ if (base.room > 0 && inner.indexOf(base.room) >= 0) bestK = base.room;
300
+ var lay = bestLayout(base.atoms, conv, { orient: orient, w: w, h: h, cap: CAP.address, fixed: fixed, primary: base.primary, must: must.concat([bestK]), maxSize: true });
301
+ if (lay) out.bld2 = result(lay, w, h, orient, 'address');
302
+ }
303
+ }
304
+ return out;
305
+ }
306
+ // 氏名・金額・任意の文字列。kind: 'name' | 'amount' | 'plain'。改行を入れた所は必ず改行する
307
+ export function fitText(o) {
308
+ var orient = o.orientation === 'vertical' || o.orientation === 'v' ? 'v' : 'h';
309
+ var w = +o.width, h = +o.height, kind = o.kind || 'plain', style = o.numerals === 'tens' ? 'tens' : 'digits';
310
+ if (!(w > 2 * PAD) || !(h > 2 * PAD)) return { error: 'TOO_SMALL' };
311
+ var text = toHalf(o.text);
312
+ if (!text) return { error: 'EMPTY' };
313
+ var conv = orient === 'v' ? function (t) { return verticalize(t, style); } : function (t) { return t; };
314
+ var atoms = [], must = [];
315
+ text.split('\n').forEach(function (line, li) {
316
+ var a = atomize(line);
317
+ if (kind !== 'plain') a.forEach(function (x) { x.w = x.sp ? x.w : 0; }); // 氏名・金額は空白でだけ改行してよい
318
+ if (li > 0 && a.length) { a[0].w = 1; must.push(atoms.length); }
319
+ atoms = atoms.concat(a);
320
+ });
321
+ var lay = bestLayout(atoms, conv, { orient: orient, w: w, h: h, cap: CAP[kind] || CAP.plain, must: must, maxBreaks: kind === 'plain' ? 3 : Math.max(1, must.length) });
322
+ return result(lay, w, h, orient, kind);
323
+ }
324
+ // MCP の fit_to_box と同じ入口
325
+ export function fitToBox(o) {
326
+ if ((o.kind || 'address') === 'address') return fitAddress({ address: o.text, postal: o.postalCode, width: o.width, height: o.height, orientation: o.orientation, numerals: o.numerals });
327
+ if (o.kind === 'amount') {
328
+ var n = parseAmount(o.text);
329
+ var d = daiji(n, o.amount || {});
330
+ if (!d) return { error: 'BAD_AMOUNT' };
331
+ var r = fitText({ text: d, width: o.width, height: o.height, orientation: o.orientation, kind: 'amount' });
332
+ r.daiji = d;
333
+ return r;
334
+ }
335
+ return fitText({ text: o.text, width: o.width, height: o.height, orientation: o.orientation, kind: o.kind, numerals: o.numerals });
336
+ }
337
+ // ==== ここまでコア ====
338
+
339
+ export class FitToBoxError extends Error {}
340
+
341
+ const KINDS = ['address', 'name', 'amount', 'plain'];
342
+ const MSG = {
343
+ ja: {
344
+ EMPTY: '文字列が空です',
345
+ TOO_SMALL: '欄が小さすぎます(四辺に1.5mmずつの余白を取ると字が入りません)',
346
+ BAD_AMOUNT: '金額は 1〜99,999,999 の整数で渡してください(「3万」「30,000円」も可)',
347
+ small: '1字が4mmを下回ります。都道府県を省いた場合(omitPrefecture)と建物名を2行にした場合(buildingTwoLines)の大きさも返します。省いてよいかは使う人が決めてください',
348
+ },
349
+ en: {
350
+ EMPTY: 'The text is empty',
351
+ TOO_SMALL: 'The box is too small (no room after a 1.5 mm margin on each side)',
352
+ BAD_AMOUNT: 'Pass an amount from 1 to 99,999,999 (e.g. 30000, 3万 or 30,000円)',
353
+ small: 'Characters are under 4 mm; sizes with the prefecture dropped (omitPrefecture) and with the building on two lines (buildingTwoLines) are included. Whether to drop anything is the user\'s call',
354
+ },
355
+ };
356
+
357
+ function layoutOut(r) {
358
+ return { charSizeMm: r.size, lineCount: r.lineCount, lines: r.lines, fits4mm: r.ok };
359
+ }
360
+
361
+ /**
362
+ * MCP の入口。text・width・height(mm)・orientation('vertical' | 'horizontal')を受け、
363
+ * 欄に収まる1字の大きさ(mm・0.1mm 単位で切り捨て)と、改行した後の各行を返す。
364
+ * kind: 'address'(既定)| 'name' | 'amount' | 'plain'
365
+ */
366
+ export function fitToBoxTool(opts = {}) {
367
+ const lang = opts.lang === 'en' ? 'en' : 'ja';
368
+ const kind = opts.kind === undefined ? 'address' : opts.kind;
369
+ if (!KINDS.includes(kind)) throw new FitToBoxError(`kind は ${KINDS.join(' / ')} のどれかです`);
370
+ const orientation = opts.orientation === undefined ? 'vertical' : opts.orientation;
371
+ if (!['vertical', 'horizontal'].includes(orientation)) throw new FitToBoxError("orientation は 'vertical' か 'horizontal' です");
372
+ const width = Number(opts.width), height = Number(opts.height);
373
+ if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0 || width > 1000 || height > 1000) {
374
+ throw new FitToBoxError('width と height は 0 より大きく 1000 以下の mm で渡してください');
375
+ }
376
+ if (typeof opts.text !== 'string') throw new FitToBoxError('text(文字列)が必要です');
377
+ if (opts.text.length > 2000) throw new FitToBoxError('text は2000字までです');
378
+ const r = fitToBox({
379
+ kind, text: opts.text, width, height, orientation, postalCode: opts.postalCode, numerals: opts.numerals,
380
+ amount: { sen: opts.thousandChar, en: opts.yenChar, nari: !!opts.nari, printed: !!opts.kinEnPrinted },
381
+ });
382
+ const base = { kind, orientation, width, height, marginMm: PAD, lineGapRatio: GAP };
383
+ if (r.error) return { ok: false, ...base, error: { code: r.error, message: MSG[lang][r.error] } };
384
+ if (kind !== 'address') {
385
+ const out = { ok: true, ...base, ...layoutOut(r) };
386
+ if (r.daiji) out.daiji = r.daiji;
387
+ return out;
388
+ }
389
+ const out = { ok: true, ...base, ...layoutOut(r.main), parts: r.parts,
390
+ asIs: { charSizeMm: r.naive.size, lines: r.naive.lines, neededMm: r.naive.need, availableMm: r.naive.room, overflowChars: r.naive.overflowChars } };
391
+ if (!r.main.ok) {
392
+ out.alternatives = {};
393
+ if (r.noPref) out.alternatives.omitPrefecture = layoutOut(r.noPref);
394
+ if (r.bld2) out.alternatives.buildingTwoLines = layoutOut(r.bld2);
395
+ out.notes = [MSG[lang].small];
396
+ }
397
+ return out;
398
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@first-ch/tools-mcp",
3
- "version": "0.42.0",
3
+ "version": "0.42.1",
4
4
  "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表)・日本語タイトルからのURLスラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ36本(GEO・メタタグ・セキュリティヘッダー・SSL・DNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・ビジネス文面チェック等)の JSON API を呼ぶ app_* ツールも提供する(こちらは入力を apps.first-ch.com へ送るため既定では無効・FIRSTCH_ENABLE_APPS=1 で有効)",
5
5
  "type": "module",
6
6
  "bin": {
@@ -279,6 +279,7 @@
279
279
  "apps.mjs",
280
280
  "lib.mjs",
281
281
  "fs-safe.mjs",
282
+ "fit-to-box.mjs",
282
283
  "webp.mjs",
283
284
  "marp.mjs",
284
285
  "marp-theme.css",