business-jp

@alneas/business-jp

English | 日本語

日本向けの帳票・印影・法務文書・JP PINTチェック・祝日・書式や計算の初期値を 1つにまとめたMITパッケージです。Publicモノレポのこのパッケージが正本です。 汎用engineからの逆依存はありません。

npm install @alneas/business-jp

import { resolveSealLabel, parseLegalDocument, japaneseHolidayCalendar } from '@alneas/business-jp';
const label = resolveSealLabel('山田 太郎'); // 山田
const document = parseLegalDocument('第1条（目的）\n本文');
const holiday = japaneseHolidayCalendar({ year: 2024, month: 0, day: 1 }); // true。monthは0始まり

単独導入の通常依存はholiday-jpとYAML parserだけです。data-engine・AJV・Zod・AI・ グラフ・DB・storageは入りません。ルートの実行・型解決にもengineは不要です。 Nodeの最低対応は24.0.0で、品質CIは24/26、ESM/CJSと厳密なNodeNext型を検証します。

入口	data-engineの導入
ルート、/pdf/stamp、/holidays、/legal-documentとparser/types/constants	不要
/pdf/legal-document-pdfmake、/notifications	不要
/integrations/data-engine（従来のルート集約）	必要
/date-utils、/finance、/csv、/pdf、/excel、/ediと連携サブパス	型解決にも必要

npm install @alneas/business-jp @alneas/data-engine

import { calculateInvoiceAmounts, pdf } from '@alneas/business-jp/integrations/data-engine';
// 必要な機能だけなら従来の@alneas/business-jp/financeも使えます。
const amounts = calculateInvoiceAmounts({ subtotal: 1000 }); // 従来の10% / Math.roundで1100
const template = pdf.japaneseDocumentPresets.invoice;

engineは任意peerと検証用の開発依存です。汎用の日付演算・金額計算・CSV・文書データ型・ EDI/UBL・Excelとの組み立てにはengineを使います。サブパスを選ぶだけではnpmの通常依存を 減らせないため、依存宣言と単独機能の実行・型定義の両方から切り離しています。 これらの日本向け連携には、engineのAI・グラフ・DB・storageのpeerは不要です。

初回公開前の変更として、ルートの日付・金額関数とpdf/edi/excel/csv名前空間を /integrations/data-engineへ移しました。既存の機能別サブパスの振る舞いは維持します。 private app-core/react-toolsの既存入口と初期値も維持します。請求書・印影・法務ごとの 別パッケージは増やさず、汎用engineの実装も複製しません。

日本語の支払・在庫通知と円表示は、ルートまたは/notificationsの japaneseNotificationMessagesから利用できます。

import { japaneseNotificationMessages } from '@alneas/business-jp/notifications';
import { SlackNotificationAdapter, SlackClient } from '@alneas/data-engine/notifications/slack';
const adapter = new SlackNotificationAdapter(new SlackClient({ botToken: 'host-supplied-token' }), japaneseNotificationMessages);

仕様・利用条件・制約も確認してください。印影は電子署名ではなく、 EDIの限定チェックは完全なJP PINT検証・認証ではありません。フォント本体・PDF描画・ Excel数式評価・法務税務判断は提供しません。実際のプロファイル・timezone・税率・丸めは 利用側で選択します。APIの引数・戻り値はJSDocが正本です。

開発はCONTRIBUTING.md、公開はRELEASING.md、 ALNEAS Docsを参照してください。

AI利用ガイドは配布物の dist/ai/SKILL.md と package-context.json に同梱します。次のコマンドはプロジェクトの指示ファイルへの追記をプレビューします。確認後に --write を付けると既存の指示を保持して反映します。

node node_modules/@alneas/business-jp/dist/ai/setup.mjs --project .