@aiquants/auth-react-router 0.15.0 → 0.16.0

package/dist/admin.d.ts

@@ -1,33 +1,13 @@
-import * as react_router from 'react-router';
-import { AuthUser, AuthGroup, AuthGroupMember, AuthAllowlistEntry, AuthDirectoryMembershipMode, AuthDirectoryStatus, AuthDirectoryCatalogSnapshot, AuthDirectoryCatalogGroup } from '@aiquants/auth-core';
-import React__default from 'react';
-
-/**
- * Labels and i18n strings for the user administration UI.
- * ユーザー管理 UI で使用するラベルと i18n 文字列の定義。
- *
- * パッケージ既定は **英語** ([defaultUserAdminLabels])。日本語で使う場合はアプリ側が
- * [jaUserAdminLabels] を明示的に注入する (認可管理 `@aiquants/authz-react-router` と同じ規約)。
- * UI 文字列はすべて本モジュールに集約し、コンポーネント側へ直書きしないこと — 直書きすると
- * 日本語以外の利用者がその箇所を差し替えられなくなる。
- */
+import { VirtualScrollLocale } from "@aiquants/virtualscroll";
+import * as react_router from "react-router";
+import { AuthUser, AuthGroup, AuthGroupMember, AuthAllowlistEntry, AuthDirectoryMembershipMode, AuthDirectoryStatus, AuthDirectoryCatalogSnapshot, AuthDirectoryCatalogGroup } from "@aiquants/auth-core";
+import React__default from "react";
+type UserAdminLocale = VirtualScrollLocale;
 type UserAdminLabels = {
     title: string;
-    /**
-     * BCP 47 locale used to format dates. 日付整形に使う BCP 47 ロケール。
-     *
-     * 実行環境任せにするとサーバーとブラウザで別の文字列になり、水和が壊れる。
-     */
-    locale: string;
-    /** IANA time zone used to format dates. 日付整形に使う IANA タイムゾーン。 */
+    locale: UserAdminLocale;
+    formatLocale: string;
     timeZone: string;
-    /**
-     * Strings shared by more than one view. 複数のビューが共有する文言。
-     *
-     * ビューごとに同じ語を持たせると、ある画面の「削除」だけを言い換えることが **できなく
-     * なる** (実装がどのビューのキーを読んでいるかは呼び出し側から見えない)。共有する語は
-     * ここ 1 か所に置く。
-     */
     common: {
         create: string;
         edit: string;
@@ -37,70 +17,30 @@ type UserAdminLabels = {
         actions: string;
         status: string;
         id: string;
-        /** 変更不能な供給元 (環境変数など) 由来の行に出す表示。 */
         readOnly: string;
-        /** 上流所有のグループに出す編集不可の表示。 */
         managedUpstream: string;
-        /** `#{id}` の表示。記号の位置は言語で変わる。 */
         idTemplate: string;
-        /** 値が無いことの表示 (説明欄など)。 */
         none: string;
     };
-    /** アクションが拒否・失敗したときの文言。 */
     errors: {
-        /** 一覧に無い上流キーを指定した。`{key}` に受け取った値。 */
         unknownUpstream: string;
-        /** その上流グループは既に別のローカルグループへ連携している。`{key}` / `{group}`。 */
         alreadyLinked: string;
-        /** ディレクトリ未設定の配備で連携を求められたときの説明。 */
         directoryDisabled: string;
-        /** 必須欄が欠けている、または読めない値だったことの説明。 */
         invalidField: string;
-        /**
-         * Shown for an intent this screen does not perform. この画面が行わない intent への文言。
-         *
-         * ⚠️ 受け取った値を含めない。認可より手前で返るため、認証を通っていない相手にも届く。
-         */
         unknownIntent: string;
-        /**
-         * Operator-facing names for the form fields. 欄の、操作者に見える名前。
-         *
-         * ⚠️ `invalidField` の `{field}` に **通信上のキー** を差し込まない。日本語の文の中に
-         * `membershipMode` のような識別子が現れ、画面のどの欄を指すのか操作者には判らない。
-         * 表に無い欄はキーのまま出す (出さないより、判りにくくても出すほうがよい)。
-         */
         fieldNames: Record<string, string>;
-        /** 許可リストの種別が既定の 2 値でなかったことの説明。 */
         invalidAllowlistType: string;
-        /** 想定外の失敗 (原文はサーバーのログにだけ残す)。 */
         unexpected: string;
-        /**
-         * Shown when the actor lacks permission for the attempted operation.
-         * 操作の権限が無いときに出す文言。
-         *
-         * ガードの例外メッセージをそのまま返してはならない。テナント ID・アプリキー・
-         * 拒否理由といった内部の語彙が、権限を持たない相手にそのまま渡る。
-         */
         forbidden: string;
-        /**
-         * Shown when the request body exceeds the ceiling. 本文が上限を越えたときの文言。
-         *
-         * この画面が送るのは短い文字列だけなので、越えるのは誤操作か攻撃である。どちらにも
-         * 同じ文言を返す (どこで弾かれたかを細かく教えない)。
-         */
         requestTooLarge: string;
     };
-    /** シェル (タブ枠) の見出し。 */
     heading: string;
-    /** シェルが描く自己権限バッジの文言。 */
     permissions: {
         label: string;
         canWrite: string;
         canRead: string;
-        /** 削除だけを持つ主体の表示 (読み書きが無いことを「権限なし」と描かない)。 */
         canDelete: string;
         none: string;
-        /** 未結線・取得失敗・付与ゼロのいずれも「不明」であり、許可ではない。 */
         unknown: string;
     };
     tabs: {
@@ -112,10 +52,8 @@ type UserAdminLabels = {
     };
     usersView: {
         title: string;
-        /** 並べ替えの読み上げ名。`{column}` は列名。 */
         sortBy: string;
         searchPlaceholder: string;
-        /** 検索欄の読み上げ名。プレースホルダは入力すると消えるため名前にならない。 */
         searchLabel: string;
         addUser: string;
         editUser: string;
@@ -125,58 +63,33 @@ type UserAdminLabels = {
         inactive: string;
         activate: string;
         deactivate: string;
-        /** 行ごとの読み上げ名。`{user}` を利用者名へ置換する。 */
         editUserAria: string;
         activateAria: string;
         deactivateAria: string;
-        /** 無効化はサインインを止める。確認を取る。 */
-        /** 検索で 0 件になったときの文言 (「登録が無い」と区別する)。 */
         emptyFiltered: string;
-        /** 一覧の絞り込み結果を読み上げるための文言。 */
         listSummary: string;
-        /** 昇順で並べ替え中の列の読み上げ名。 */
         sortedAscending: string;
-        /** 降順で並べ替え中の列の読み上げ名。 */
         sortedDescending: string;
         confirmDeactivate: string;
         empty: string;
     };
     groupsView: {
-        /** 検索語に一致しないときの説明。空状態と混ぜると「消えた」と誤読される。 */
         emptyFiltered: string;
-        /** 作成方法の切替。ローカルに作るか、上流のグループから作るか。 */
-        /** 作成方法を選ぶ操作群の読み上げ名。 */
         createModeLabel: string;
         createModeLocal: string;
         createModeUpstream: string;
-        /** 上流グループを選ぶ欄。 */
         pickUpstream: string;
         pickUpstreamPlaceholder: string;
-        /** 選択肢 1 件の副題。`{count}` はメンバー数。 */
         upstreamOptionMembers: string;
-        /** すでに連携済みの選択肢に付ける表示。 */
         upstreamAlreadyLinked: string;
-        /** 候補一覧が引けなかったときの説明。`{reason}` に理由。 */
-        /** 候補は引けたが、この配備の連携プロバイダ名が決まっていないことの説明。 */
         providerUnset: string;
-        /** 候補を選ぶまで作成できないことの説明 (押せないボタンの理由)。 */
         pickUpstreamFirst: string;
-        /**
-         * Shown when every upstream group is already linked. 上流のすべてが連携済みのときの文言。
-         *
-         * ⚠️ この場面で「先に選べ」と言ってはならない。従いようのない指示になる。
-         */
         allUpstreamLinked: string;
-        /** 上流を読めたが 1 件も無かったことの説明。 */
         catalogEmpty: string;
         catalogUnavailable: string;
-        /** 上流へ届かないときの案内 (作成対話向け — この対話にアドレス欄は無い)。 */
         catalogUnavailableHere: string;
-        /** 候補一覧をいつ観測したか。 */
         catalogObservedAt: string;
-        /** 観測が配備の許す鮮度を越えている旨。 */
         catalogStale: string;
-        /** 候補一覧を引けなかった理由の文言 (上流の例外文は使わない)。 */
         catalogFailures: {
             denied: string;
             rateLimited: string;
@@ -184,9 +97,7 @@ type UserAdminLabels = {
             neverObserved: string;
             unknown: string;
         };
-        /** 上流から作る場合の説明 (何が起きるかを先に伝える)。 */
         createUpstreamNotice: string;
-        /** グループのメンバー面へ移動する操作。 */
         openMembers: string;
         openMembersAria: string;
         title: string;
@@ -197,12 +108,9 @@ type UserAdminLabels = {
         groupKey: string;
         name: string;
         description: string;
-        /** 所属人数。`{count}` を人数へ置換する。 */
         memberCountTemplate: string;
         confirmDelete: string;
-        /** 連携付きで作る前の確認。`{group}` / `{upstream}`。委譲は元に戻しづらい。 */
         confirmCreateLinked: string;
-        /** 行ごとの読み上げ名。`{group}` をグループ名へ置換する。 */
         editGroupAria: string;
         deleteGroupAria: string;
         noDescription: string;
@@ -212,33 +120,22 @@ type UserAdminLabels = {
     };
     groupMembersView: {
         title: string;
-        /** 利用者の絞り込み。数百人の一覧を目で追わせない。 */
         searchLabel: string;
         searchPlaceholder: string;
-        /** 所属している人だけに絞る切替。`{count}` は該当数。 */
         onlyMembers: string;
-        /** 絞り込み結果が空のときの説明。 */
         emptyFiltered: string;
-        /** 一覧の要約。`{shown}` / `{total}` / `{members}`。 */
         summary: string;
         selectGroup: string;
         selectPrompt: string;
-        /** グループが 1 つも無い配備での説明 (「選べ」は従えない指示になる)。 */
         noGroups: string;
-        /** 所属だけに絞った結果 0 件になったときの説明。 */
         emptyNoMembers: string;
-        /** 利用者が 1 人も登録されていない配備での説明。 */
         noUsers: string;
-        /** 深いリンクが指すグループが見つからず、代替を出していることの説明。 */
         deepLinkMissed: string;
         actionAdd: string;
         actionRemove: string;
-        /** 行ごとの読み上げ名。`{user}` を利用者名へ置換する。 */
         actionAddAria: string;
         actionRemoveAria: string;
-        /** 上流所有グループで編集を出さない理由。押せない理由を書かないと故障に見える。 */
         upstreamNotice: string;
-        /** 見出し。`{group}` をグループ名へ置換する。語順が言語で変わるため位置指定にする。 */
         membersOfTemplate: string;
         groupKeyLabel: string;
     };
@@ -249,19 +146,13 @@ type UserAdminLabels = {
         type: string;
         emailType: string;
         domainType: string;
-        /** 一覧のバッジ表示 (短縮形)。 */
         emailTypeShort: string;
         domainTypeShort: string;
-        /** グループ単位の許可。上流ディレクトリの所属で判定される。 */
         groupTypeShort: string;
-        /** 対象列の見出し。パターンとグループが混在するため「パターン」ではない。 */
         target: string;
         description: string;
-        /** 配備全体が所有する行 (環境変数由来) の所有者表示。 */
         deploymentOwner: string;
-        /** 許可の取り消しはサインインを止める。確認を取る。 */
         confirmDelete: string;
-        /** 行ごとの読み上げ名。`{target}` を対象へ置換する。 */
         deleteAria: string;
         empty: string;
     };
@@ -272,38 +163,24 @@ type UserAdminLabels = {
         transitiveMode: string;
         lastSynced: string;
         neverSynced: string;
-        /** 上流に居るがローカルユーザーへ解決できていない人数。`{count}` を人数へ置換する。 */
         unresolvedTemplate: string;
         syncPaused: string;
         syncEnabled: string;
         syncNow: string;
         syncQueued: string;
-        /** 同じ範囲の要求が既に待っていて、積まれなかったことの説明。 */
         syncAlreadyPending: string;
-        /** 連携は作れたが、その直後の同期要求を積めなかったときの告知。 */
         linkSyncNotQueued: string;
-        /** 同期が滞っていることの警告。停止はセキュリティ事象である。 */
         staleWarning: string;
         disabledWarning: string;
-        /** 停止件数。`{paused}` / `{total}` を件数へ置換する。 */
         pausedTemplate: string;
-        /** 失敗したグループの列挙。`{groups}` を名前の並びへ置換する。 */
         erroredTemplate: string;
-        /** 失敗理由付きの 1 件。`{group}` / `{reason}`。 */
         erroredItemTemplate: string;
-        /** 列挙の区切り。言語で変わる。 */
         listSeparator: string;
-        /** 滞留警告に添える最終成功時刻。`{at}`。 */
         oldestSyncedTemplate: string;
-        /** 未処理の同期要求。`{count}`。 */
         pendingTemplate: string;
-        /** 連携先が 1 つも残っていないときの説明。 */
         nothingToLink: string;
-        /** グループが 1 つも無い配備での説明 (「全部が連携済み」と区別する)。 */
         noGroupsToLink: string;
-        /** 未結線の配備で操作を出さない理由。 */
         notWiredNotice: string;
-        /** 行ごとの読み上げ名。`{group}` をグループ名へ置換する。 */
         syncNowAria: string;
         syncQueuedAria: string;
         pauseAria: string;
@@ -311,54 +188,34 @@ type UserAdminLabels = {
         allowGroupAria: string;
         disallowGroupAria: string;
         unlinkAria: string;
-        /** グループ単位のサインイン許可を外す確認。 */
         confirmDisallow: string;
         link: string;
         unlink: string;
         externalKey: string;
         empty: string;
-        /** 連携するグループを選ぶ欄。 */
         selectGroup: string;
-        /** 選択欄が自前で持つ文言。渡さないと英語のまま出る。 */
-        /** 選択欄の入力の手引き。 */
         pickUpstreamPlaceholder: string;
         pickerNoOptions: string;
         pickerClear: string;
         pickerToggle: string;
-        /** 選択中の値の読み上げ。`{value}`。 */
         pickerSelected: string;
-        /** 候補件数の読み上げ。`{count}`。 */
         pickerAvailable: string;
-        /** 上流グループのアドレス入力。 */
         externalKeyPlaceholder: string;
-        /** 連携解除の確認。台帳と許可設定が消える。 */
-        /** 連携を作る前の確認 (元へ戻すには連携解除という別の操作が要る)。 */
         confirmLink: string;
         confirmUnlink: string;
-        /** 同期の一時停止・再開。 */
         pause: string;
         resume: string;
-        /** 許可グループに加える / 外す。 */
         allowGroup: string;
         disallowGroup: string;
-        /** グループ名と鍵の併記。`{name}` / `{key}`。 */
         groupOptionTemplate: string;
     };
 };
-/**
- * Package default labels (English).
- * パッケージ既定ラベル (英語)。
- */
 declare const defaultUserAdminLabels: UserAdminLabels;
-/**
- * Standard Japanese labels for user administration (opt-in).
- * ユーザー管理の標準日本語ラベル (アプリ側で明示注入して使う)。
- */
 declare const jaUserAdminLabels: UserAdminLabels;
-/** セクション単位の部分上書き。 */
 type PartialUserAdminLabels = {
     title?: string;
-    locale?: string;
+    locale?: UserAdminLocale;
+    formatLocale?: string;
     timeZone?: string;
     common?: Partial<UserAdminLabels["common"]>;
     errors?: Partial<UserAdminLabels["errors"]>;
@@ -371,16 +228,7 @@ type PartialUserAdminLabels = {
     allowlistView?: Partial<UserAdminLabels["allowlistView"]>;
     directoryView?: Partial<UserAdminLabels["directoryView"]>;
 };
-/**
- * Shallow per-section merge over the English defaults.
- * 英語既定に対してセクション単位で浅くマージする処理。
- */
 declare function resolveUserAdminLabels(over?: PartialUserAdminLabels): UserAdminLabels;
-
-/**
- * Server store interface for managing users, groups, memberships, and allowlists.
- * ユーザー・グループ・所属・アロワリストを管理するサーバー層ストアのインターフェース。
- */
 type UserAdminStore = {
     listUsers: () => Promise<AuthUser[]>;
     createUser: (data: {
@@ -413,35 +261,14 @@ type UserAdminStore = {
         description?: string;
     }) => Promise<AuthAllowlistEntry>;
     removeAllowlistEntry: (id: number) => Promise<void>;
-    /**
-     * Allows every member of an externally-sourced group to sign in.
-     * 外部供給グループのメンバー全員にサインインを許可する処理。
-     *
-     * 判定は上流メンバー台帳を読むため、ローカル管理のグループを渡しても誰にも何も与えない。
-     * ストアはそれを拒否すること (無言の no-op を作らない)。
-     */
     addAllowlistGroup: (groupId: number, description?: string) => Promise<void>;
     removeAllowlistGroup: (id: number) => Promise<void>;
-    /**
-     * Links a local group to a group in the upstream directory.
-     * ローカルグループを上流ディレクトリのグループへ結び付ける処理。
-     *
-     * リンク後、そのグループの名称と所属は上流が所有する。ロール割当はローカルのままである。
-     */
     linkDirectoryGroup: (groupId: number, data: {
         provider: string;
         externalId: string;
         externalKey: string;
         membershipMode: AuthDirectoryMembershipMode;
     }) => Promise<void>;
-    /**
-     * Creates a local group and links it to an upstream group as one indivisible step.
-     * ローカルグループの作成と上流への連携を、分割不可能な 1 手として行う処理。
-     *
-     * ⚠️ **途中で失敗したら何も残してはならない。** 作成だけが成功すると、運用者には「連携に
-     * 失敗した」ではなく「知らないグループが増えた」と見える。実装は 1 つのトランザクションで
-     * 行うこと (作成 → 連携の順に別々の書込を並べると、この不可分性は成立しない)。
-     */
     createLinkedGroup: (data: {
         groupKey: string;
         name: string;
@@ -451,161 +278,45 @@ type UserAdminStore = {
         externalKey: string;
         membershipMode: AuthDirectoryMembershipMode;
     }) => Promise<AuthGroup>;
-    /** Stops following the upstream, keeping the memberships already projected. 連携の解除。 */
     unlinkDirectoryGroup: (groupId: number) => Promise<void>;
-    /** Pauses or resumes synchronization for one group. 1 グループの同期を停止・再開する処理。 */
     setDirectorySyncEnabled: (groupId: number, isSyncEnabled: boolean) => Promise<void>;
-    /**
-     * Queues a "sync now" request. 「今すぐ同期」の要求を積む処理。
-     *
-     * ⚠️ 戻り値を `void` にしてはならない。同じ範囲の要求が既に待っているとき、積み増さないのは
-     * 正しい (押した数だけ上流への全件走査が並ぶ) が、それを成功と区別せずに返すと、押しても
-     * 反応しない画面ができる — しかも詰まった 1 行が以後の押下すべてを飲み込む。
-     *
-     * @param groupId Target group, or `null` for the whole tenant. 対象グループ (`null` でテナント全件)。
-     * @param actor Who asked, for the audit record. 要求した主体 (監査記録用)。
-     * @returns Whether it was queued or already waiting. 積んだか、既に待っていたか。
-     */
     requestDirectorySync: (groupId: number | null, actor: string) => Promise<UserAdminSyncRequestOutcome>;
-    /** Health of the synchronization, for the header warning. 同期の健全性 (警告表示用)。 */
     getDirectoryStatus: () => Promise<AuthDirectoryStatus>;
 };
-/**
- * Creates an in-memory UserAdminStore initialized with optional seed data.
- * シードデータで初期化されるメモリ上の UserAdminStore を作成する。
- */
 declare function createInMemoryUserAdminStore(initial?: {
     users?: AuthUser[];
     groups?: AuthGroup[];
     groupMembers?: AuthGroupMember[];
     allowlist?: AuthAllowlistEntry[];
 }): UserAdminStore;
-/**
- * Normalizes an upstream key for comparison. 上流キーを比較用に正規化する処理。
- *
- * 前後の空白と大文字小文字を同一視する。**画面と実装で正規化がずれると**、選択欄は「未連携」と
- * 見なすキーをサーバーが「連携済み」と見なす、といった食い違いが生まれる。1 か所に置く。
- *
- * @param key Raw upstream key. 生の上流キー。
- * @returns The comparable form. 比較可能な形。
- */
 declare function normalizeUpstreamKey(key: string): string;
-/**
- * An error whose own text is meant for the operator to read.
- * 文面を **運用者に読ませるつもりで** 投げるエラー。
- *
- * ⚠️ ストアの例外文をそのまま画面へ返してはならない。ドライバの例外はスキーマ名・表名・制約名・
- * 衝突した値・接続先をそのまま含み、それが閲覧権限しか持たない主体の画面に出る。一方で
- * 「最後の管理者は外せません」のような業務上の拒否理由は、読めなければ操作そのものが行き詰まる。
- * 両者は文面からは区別できないので、**投げる側が宣言する**。宣言の無い例外は一般的な文言になる。
- *
- * ホストのストアは、この class を継承しても `operatorFacing: true` を持たせてもよい
- * (別パッケージのエラー型を継承できない事情に配慮した二経路である)。
- */
 declare class UserAdminOperatorError extends Error {
-    /** 運用者向けであることの印。継承できない場合はこの属性だけでもよい。 */
     readonly operatorFacing = true;
     constructor(message: string);
 }
-/**
- * An input problem the operator can fix, carrying a label key instead of a sentence.
- * 運用者が直せる入力の問題。文ではなく **ラベルのキー** を運ぶ。
- *
- * ⚠️ メッセージを実装側で組むと、既定 (英語) の配備に日本語が出る。文言はラベルに集約し、
- * ここでは「どの文言か」と差し替え値だけを運ぶ。
- */
 declare class UserAdminInputError extends Error {
     readonly labelKey: keyof UserAdminLabels["errors"];
     readonly values: Record<string, string | number>;
     constructor(labelKey: keyof UserAdminLabels["errors"], values?: Record<string, string | number>);
 }
-/**
- * The only route-args field this module reads. React Router's full `LoaderFunctionArgs` satisfies it, so
- * route wiring is unchanged — but declaring the minimum keeps callers (and tests) from fabricating fields
- * that are never looked at.
- * このモジュールが実際に読むルート引数の全て。React Router の完全な引数はこれを満たすため結線は不変。
- */
 type RouteArgs = {
     request: Request;
 };
-/**
- * The CRUD verb an operation performs. Deliberately a plain string union so this package stays
- * independent of any particular authorization library.
- * 操作が行う CRUD 種別。特定の認可ライブラリに依存しないよう素の文字列 union で表現する。
- */
 type UserAdminAccess = "read" | "create" | "update" | "delete";
-/**
- * Access guard the user-admin surface is mounted behind. Deny by throwing
- * (a `Response`/`redirect` or an `Error`); returning normally means "allow".
- *
- * ユーザー管理面をマウントする際の必須アクセスガード。拒否は throw で表現する
- * (`Response` / `redirect` / `Error`)。正常 return は「許可」を意味する。
- *
- * 操作ごとの CRUD 種別を受け取るため、呼び出し側は「削除だけ別権限」といった細分化ができる。
- * `intent` は監査ログ用の補助情報(認可判断は `action` で行うこと)。
- */
 type UserAdminGuards = {
-    /**
-     * 許可は「正常 return」、拒否は「throw」で表す。返り値は判定に使わない (`void` 契約)。
-     * 述語のつもりで `false` を返す実装を書くと素通りするため、返り値型で明示的に禁じる。
-     */
     requireAccess: (request: Request, context: {
         action: UserAdminAccess;
         intent: string;
     }) => Promise<void> | void;
-    /**
-     * Observes a denial that was converted into an in-page error. 画面内エラーへ変換した拒否の観測点。
-     *
-     * 拒否を画面内に返すと、既定のエラー経路が拾っていたログが消える。管理面への総当たりが
-     * 200 番台の列に紛れて見えなくなるため、宿主が記録できる口を開けておく。
-     */
     onDenied?: (context: {
         intent: string;
         actions: readonly UserAdminAccess[];
         error: unknown;
     }) => void;
 };
-/**
- * Every intent the permission table knows. 権限表が知っている intent すべて。
- *
- * ⚠️ 消費側の網羅性検査のために公開する。検査側が intent を手書きで並べる形しか無いと、
- * 実装に intent が増えても表は勝手には伸びず、**最も権限の重い新しい intent** だけが
- * 無検査で通る状態が静かに生まれる。突き合わせる相手を実装側から提供する。
- *
- * @returns Intent names, in declaration order. 宣言順の intent 名。
- */
 declare function userAdminIntents(): string[];
-/**
- * The CRUD verbs one intent requires. 1 つの intent が要求する CRUD 種別。
- *
- * ⚠️ 消費側が権限表を検査できるようにするために公開する。表そのものは公開しない — 書き換え
- * 可能な参照を渡すと、検査の対象が実行時に差し替えられる形になる。
- *
- * @param intent - Intent name. intent 名。
- * @returns The required verbs, or an empty list for an unknown intent. 要求する種別 (未知なら空)。
- */
 declare function userAdminAccessFor(intent: string): readonly UserAdminAccess[];
-/**
- * One upstream group as the picker shows it. 選択欄に出す上流グループ 1 件。
- *
- * ⚠️ **別名ではなく `@aiquants/auth-core` の型そのものである。** この形は上流アダプタ・永続化層・
- * 管理 UI の 3 層を通る。層ごとに「同じ意味の別の型」を宣言すると、構造的部分型のせいでどの境界も
- * 通ってしまい、上流へ足した欄が途中で黙って捨てられる (実測: 別々に宣言していた間は、必須欄を
- * 足しても読み手側の境界で `tsc --strict` が 0 を返した)。欄の集合は `auth-core` の型テストが固定
- * しているので、足すときは 3 層すべての受け渡しを見直すことになる。
- *
- * 特定のディレクトリ実装 (Google 等) の型は依然として import しない — `auth-core` は上流に依存
- * しない語彙のパッケージであり、`AuthDirectoryStatus` などを既にここから受け取っている。
- */
 type UserAdminCatalogGroup = AuthDirectoryCatalogGroup;
-/**
- * The upstream catalog as the loader hands it to the views. loader がビューへ渡す上流の候補一覧。
- *
- * ⚠️ **これは利便性のための読み取りである。** 上流へ届かなくても画面は開かなければならない
- * (グループ一覧や許可リストの閲覧は、選択欄の可否とは無関係である)。したがって失敗は
- * `reason` として **描画可能な状態** に変換し、例外にしない。認可やサインイン判定のように
- * 「判らないなら拒否」であるべき経路とは、意図的に扱いを変えている。
- */
 type UserAdminCatalog = {
     kind: "ready";
     groups: UserAdminCatalogGroup[];
@@ -617,48 +328,10 @@ type UserAdminCatalog = {
 } | {
     kind: "not-wired";
 };
-/**
- * What the catalog port answers: the groups, and when the upstream was actually observed.
- * 候補一覧ポートの答え。グループと、上流を実際に観測した時刻。
- *
- * ⚠️ `observedAt` は省略できない。この一覧は上流を直に叩いた結果とは限らず、資格情報を持つ別の
- * プロセスが書いた写しであることが多い。時刻を伴わない一覧は「上流の現在」と区別できず、運用者は
- * 既に消えたグループを選ぶ。`null` は **一度も観測していない** ことを意味する (空の答えではない)。
- */
 type UserAdminCatalogSnapshot = AuthDirectoryCatalogSnapshot;
-/**
- * What a "sync now" request did. 「今すぐ同期」の要求が行ったこと。
- *
- * `already-pending` は失敗ではない — 同じ範囲の要求が既に待っている。ただし **成功でもない**:
- * 何も積まれていないので、待っている行が誰にも拾われなければ何も起きない。
- */
 type UserAdminSyncRequestOutcome = "queued" | "already-pending";
-/**
- * What the sync request made right after a link was created did.
- * 連携の直後に積む同期要求が行ったこと。
- *
- * `not-queued` は **連携は成功したが要求は積めなかった** ことを表す。要求の失敗を連携の失敗として
- * 投げると、運用者には「連携に失敗した」と伝わる一方で上流所有のグループは既に増えている。
- * 連携の結果と要求の結果は別の事実なので、別の値で運ぶ。
- */
 type UserAdminLinkSyncOutcome = UserAdminSyncRequestOutcome | "not-queued";
-/**
- * Why the upstream catalog could not be listed, classified for display.
- * 上流の候補一覧を引けなかった理由を、表示のために分類したもの。
- *
- * ⚠️ **上流の例外文をそのまま画面へ出してはならない。** サービスアカウントのアドレス、借用先、
- * 内部 URL、資格情報の断片が混じり得る。管理面を開けるだけの主体に、それらを読ませる理由は無い。
- * 原文は `console.error` へ出し、画面にはこの分類に対応する自前の文言を出す。
- */
 type UserAdminCatalogFailure = "denied" | "rateLimited" | "upstreamError" | "neverObserved" | "unknown";
-/**
- * Neutral per-resource permission summary the admin shell renders in its header badge.
- * 管理シェルのヘッダーバッジが描画する、リソース単位の中立な権限サマリ。
- *
- * この形はこのパッケージ自身の契約であり、特定の認可ライブラリの型を import しない
- * (`AGENTS.md` のクロスパッケージ・ハードコード禁止)。`canRead` / `canWrite` / `canDelete` を持つ
- * ビューであれば構造的にそのまま渡せる。
- */
 type UserAdminPermission = {
     canRead: boolean;
     canWrite: boolean;
@@ -666,55 +339,15 @@ type UserAdminPermission = {
 };
 type UserAdminAppConfig = {
     store: UserAdminStore;
-    /** セクション単位の部分上書き。既定は英語 (`defaultUserAdminLabels`)。 */
     labels?: PartialUserAdminLabels;
-    /**
-     * Required — omitting a guard would expose the whole user directory and its write actions.
-     * 必須。省略を許すとユーザー名簿と全更新操作が無防備に露出するため、型で強制する。
-     */
     guards: UserAdminGuards;
-    /**
-     * Names who is acting, for audit columns. 監査列に残す「誰が」を解決する処理。
-     *
-     * ⚠️ 省略すると、要求を積んだ主体が記録されない。同期要求の表は「誰がいつ何を要求し、結果が
-     * どうだったか」を残すために在り、その `requested_by` が定数だと、乱発を疑ったときに誰の
-     * ものか判らない — 乱発こそがこの intent に `update` を要求した理由である。
-     */
     resolveActor?: (request: Request) => Promise<string> | string;
-    /**
-     * Lists the upstream groups the operator may link to. 連携先の候補を列挙するポート。
-     *
-     * 任意である。注入しない配備では選択欄を出さず、上流キーの手入力に留まる — 上流へ問い合わせる
-     * 資格情報を web 側へ置かない構成を選べるようにするためである (同期ジョブだけが鍵を持つ形)。
-     *
-     * ⚠️ **失敗しても画面を落としてはならない。** 例外は loader が捕まえて
-     * `{ kind: "unavailable" }` へ写す。ここが落ちると、グループ一覧すら開けなくなる。
-     */
     directoryCatalog?: {
         listGroups: (request: Request) => Promise<UserAdminCatalogSnapshot>;
     };
-    /**
-     * Per-request self-permission lookup for the header annotation. Resolving to a map of
-     * {@link UserAdminPermission} shows the badge; rejecting shows an explicit "unknown" badge — never a
-     * permissive one. Any authz library whose view carries `canRead` / `canWrite` / `canDelete` satisfies it.
-     * ヘッダー注釈に自分の実効権限を表示するためのリクエスト別権限取得関数。失敗時は「権限不明」表示。
-     */
     getMyPermissions?: (request: Request) => Promise<Record<string, UserAdminPermission | undefined>>;
-    /**
-     * Display names for the resource keys the badge shows, e.g. `{ authz_admin: "ユーザー管理 UI" }`.
-     * バッジに出すリソースキーの表示名。未指定のキーはキー文字列をそのまま表示。
-     *
-     * 表示名をこのパッケージ側に埋め込むと、別パッケージのリソースキーを名指しすることになる
-     * (`AGENTS.md` のクロスパッケージ・ハードコード禁止)。中立な差し込み口として受け取る。
-     */
     resourceLabels?: Record<string, string>;
 };
-/**
- * Creates React Router loader & action handler for user administration.
- * ユーザー管理用 React Router の loader および action ハンドラーを作成する。
- *
- * `config.guards` は必須。loader / action の双方が、処理を始める前にガードを通過させる。
- */
 declare function createUserAdminApp(config: UserAdminAppConfig): {
     loader: ({ request }: RouteArgs) => Promise<{
         resourceLabels: Record<string, string> | undefined;
@@ -742,26 +375,10 @@ declare function createUserAdminApp(config: UserAdminAppConfig): {
         error: string;
     }>;
 };
-
-/**
- * How the console keeps itself current while "sync now" requests are waiting for the job.
- * 「今すぐ同期」の要求がジョブを待っている間、画面が自分を最新に保つ間隔と上限。
- *
- * The loader only re-runs after the console's own submissions, so a request the job finishes a few
- * seconds later would stay invisible until a reload. While at least one request is pending the
- * console re-validates every `intervalMs`, and gives up after `maxMs` so a deployment with no job
- * consuming the queue does not poll forever from every open tab.
- * ローダーは自分の送信のあとにしか再実行されないため、ジョブが数秒後に終えた要求はリロードまで
- * 見えない。未処理の要求が 1 件でもある間は `intervalMs` ごとに再検証し、`maxMs` で諦める
- * (キューを消化するジョブが居ない配備で、開いている全タブが永久に叩き続けないため)。
- */
 type PendingSyncPolling = {
-    /** Milliseconds between re-validations. 再検証の間隔 (ミリ秒)。 */
     intervalMs: number;
-    /** Milliseconds after which polling stops for an unchanged pending count. 件数が変わらないまま諦めるまでの時間 (ミリ秒)。 */
     maxMs: number;
 };
-/** Defaults: every 3 seconds, for up to 5 minutes. 既定値 (3 秒ごと、最長 5 分)。 */
 declare const DEFAULT_PENDING_SYNC_POLLING: PendingSyncPolling;
 type UserAdminShellProps = {
     children?: React__default.ReactNode;
@@ -769,24 +386,10 @@ type UserAdminShellProps = {
         title: string;
         annotation: React__default.ReactNode;
     }) => React__default.ReactNode;
-    /** Polling while sync requests are pending; defaults to {@link DEFAULT_PENDING_SYNC_POLLING}. 未処理中のポーリング設定。 */
+    basePath: string;
     pendingSyncPolling?: PendingSyncPolling;
 };
-/**
- * Shell layout for user administration pages with header annotation delegation.
- * ヘッダー注釈委譲を備えたユーザー管理ページのシェルレイアウト。
- */
-declare function UserAdminShell({ children, renderHeader, pendingSyncPolling }: UserAdminShellProps): React__default.JSX.Element;
-
-/**
- * @module admin/views
- * @description The five tab views of the user administration screen.
- * ユーザー管理画面を構成する 5 つのタブビュー。
- *
- * 一覧・検索・所属・許可リスト・ディレクトリ連携を描く。データはすべて loader から渡され、
- * 書き込みはビュー唯一の fetcher (`useSubmitThen`) を通す。
- */
-
+declare function UserAdminShell({ children, renderHeader, pendingSyncPolling, basePath }: UserAdminShellProps): React__default.JSX.Element;
 type UserAdminLoaderData = {
     segment: string;
     users: AuthUser[];
@@ -794,40 +397,14 @@ type UserAdminLoaderData = {
     groupMembers: AuthGroupMember[];
     allowlist: AuthAllowlistEntry[];
     directoryStatus: AuthDirectoryStatus;
-    /** 上流の候補一覧。選択欄を出す面でのみ `ready` になる。 */
     catalog: UserAdminCatalog;
     labels?: UserAdminLabels;
 };
 declare function UsersView(): React__default.JSX.Element;
-/**
- * View for managing user groups (create, edit, delete).
- * ユーザーグループ管理ビュー (作成・編集・削除)。
- */
 declare function GroupsView(): React__default.JSX.Element;
-/**
- * View for managing group member assignments.
- * グループメンバー割り当て管理ビュー。
- */
 declare function GroupMembersView(): React__default.JSX.Element;
-/**
- * View for managing authentication allowlist entries.
- * アクセス許可リスト (Allowlist) 管理ビュー。
- */
 declare function AllowlistView(): React__default.JSX.Element;
-/**
- * View for the upstream directory: what is linked, how fresh it is, and the controls that change it.
- * 上流ディレクトリのビュー。何が連携され、どれだけ新しく、それを変える操作を提供する。
- *
- * このタブが無いと、連携の作成・解除・一時停止・即時同期・グループ単位のサインイン許可という
- * 5 つの操作にどこからも到達できない。実装されているのに押せる場所が無い状態は、実装が無いのと
- * 変わらないうえ、「許可を消せるが作れない」という片肺の運用を強いる。
- */
 declare function DirectoryView(): React__default.JSX.Element;
 type AuthUserAdminAppViewProps = UserAdminShellProps;
-/**
- * Top-level application view component for the user administration UI (`/users/*`).
- * ユーザー管理 UI 全体を描画するトップレベルコンポーネント。
- */
-declare function AuthUserAdminAppView({ renderHeader, pendingSyncPolling }?: AuthUserAdminAppViewProps): React__default.JSX.Element;
-
-export { AllowlistView, AuthUserAdminAppView, type AuthUserAdminAppViewProps, DEFAULT_PENDING_SYNC_POLLING, DirectoryView, GroupMembersView, GroupsView, type PartialUserAdminLabels, type PendingSyncPolling, type UserAdminAccess, type UserAdminAppConfig, type UserAdminCatalog, type UserAdminCatalogFailure, type UserAdminCatalogGroup, type UserAdminCatalogSnapshot, type UserAdminGuards, UserAdminInputError, type UserAdminLabels, type UserAdminLinkSyncOutcome, type UserAdminLoaderData, UserAdminOperatorError, type UserAdminPermission, UserAdminShell, type UserAdminShellProps, type UserAdminStore, type UserAdminSyncRequestOutcome, UsersView, createInMemoryUserAdminStore, createUserAdminApp, defaultUserAdminLabels, jaUserAdminLabels, normalizeUpstreamKey, resolveUserAdminLabels, userAdminAccessFor, userAdminIntents };
+declare function AuthUserAdminAppView({ renderHeader, pendingSyncPolling, basePath }: AuthUserAdminAppViewProps): React__default.JSX.Element;
+export { AllowlistView, AuthUserAdminAppView, type AuthUserAdminAppViewProps, DEFAULT_PENDING_SYNC_POLLING, DirectoryView, GroupMembersView, GroupsView, type PartialUserAdminLabels, type PendingSyncPolling, type UserAdminAccess, type UserAdminAppConfig, type UserAdminCatalog, type UserAdminCatalogFailure, type UserAdminCatalogGroup, type UserAdminCatalogSnapshot, type UserAdminGuards, UserAdminInputError, type UserAdminLabels, type UserAdminLinkSyncOutcome, type UserAdminLoaderData, type UserAdminLocale, UserAdminOperatorError, type UserAdminPermission, UserAdminShell, type UserAdminShellProps, type UserAdminStore, type UserAdminSyncRequestOutcome, UsersView, createInMemoryUserAdminStore, createUserAdminApp, defaultUserAdminLabels, jaUserAdminLabels, normalizeUpstreamKey, resolveUserAdminLabels, userAdminAccessFor, userAdminIntents };