basmilius

Bas Milius パッケージ

@basmilius npm スコープは、3 層からなる 1 つのスタックです。各層については、references/ のガイドで説明しています。

1. @basmilius/utils - フレームワークに依存しない約 45 個のヘルパー（Luxon による日付処理、色、数値、ダウンロード、DOM、タイミング、地理／天文、シード付き PRNG）。あらゆる TypeScript プロジェクトで使用できます。
2. @basmilius/http-client - 型付きデータレイヤーです。すべてのボディは @dto クラス、すべてのエンドポイントグループは BaseService で、snake_case の生 JSON は静的な @adapter によってマッピングされます。utils を基盤としています。
3. @basmilius/common - Vue 3 アプリのプリミティブです。ref を返す defineStore、useService + guarded、useDataTable / useDataReport、useDtoForm、豊富なコンポーザブルカタログ、薄い vue-router ラッパーを備えています。Pinia と Vue Router を前提とし、上記 2 つのパッケージを基盤としています。

共通の前提：Vue を使用する場合は Vue 3.6 のプレリリース版（正確な範囲は各パッケージの peerDependencies を参照）、日付処理にはピア依存関係の luxon を使用します。@flux-ui/* は独自のスキル（flux-ui）を持つ別ライブラリです。@basmilius/vite-preset は意図的に対象外としています。

ルーティング：コードを書く前にパッケージガイドを読む

パッケージごとの注意点や判断基準は、ここではなく各ガイドに記載されています。まず該当するガイドを読み、必要に応じてシグネチャやパターンのファイルを参照してください。

作業内容	最初に読むもの	必要に応じて読むもの
日付／数値／色／ダウンロード／DOM ヘルパー、または @basmilius/utils からインポートするもの	references/utils.md	references/utils-function-index.md（すべての関数の正確なシグネチャと、ブラウザー用／純粋関数の区分）
DTO、アダプター、サービス、リクエスト、（デ）シリアライズ、Vite プラグイン、tsconfig のデコレーターフラグ	references/http-client.md	references/http-client-reference.md（エクスポート全体）、references/http-client-patterns.md（DTO → アダプター → サービスの実例、エラー処理、変更箇所のみの保存）
ストア、データテーブル／レポート、フォーム、URL の状態、コンポーザブル、ルーターヘルパー、例外	references/common.md	references/common-reference.md（シグネチャ付きコンポーザブルカタログ）、references/common-patterns.md（ストア、useService、useDataTable ビュー、useDtoForm、useUrlState の実例）

タスクが複数のレイヤーにまたがることはよくあります。データテーブルのビューでは、common（useDataTable）、http-client（サービスと DTO）、場合によっては utils（フォーマット処理）に触れます。関係するガイドをそれぞれ読んでください。ガイドは短く、レイヤー間の連携箇所には相互リンクがあります。

関連スキル

• vue-build-feature / code-style - これらのパッケージが組み込まれる、ライブラリに依存しない Vue アーキテクチャと SFC のパターンです。common は、vue-build-feature が委ねる具体的なデータ／状態レイヤーです。
• flux-ui - Flux UI コンポーネントライブラリ（別の @flux-ui スコープ）。