@aiquants/authz-react-router 0.8.1 → 0.8.3

package/dist/index.d.mts

@@ -1,184 +1,53 @@
-import * as react_router from 'react-router';
-import * as react from 'react';
-import { ReactNode, CSSProperties } from 'react';
-import * as _aiquants_authz_core from '@aiquants/authz-core';
-import { EffectivePermission, DenyInfo, AuthzAction, MergedScope, AuthzGrant, AuthzRole, AuthzResource, AuthzUser, AuthzAssignment, AuthzGroupRoleAssignment, AuthzGroupSummary, AuthzAdminStore } from '@aiquants/authz-core';
-
-/**
- * React Router (v7) adapter: binds `appKey` + the DI ports and exposes the loader/action authorization API.
- * React Router (v7) 向けアダプタ。`appKey` と DI ポートを束ね、loader/action 用の認可 API を公開するモジュール。
- *
- * 設計上の中心的な不変条件は **判定は 1 回だけ** ということ。ガード (`requirePermission`) と
- * UI 表示用の権限ビューは同一の実効権限から導出されるため、「画面は開けるのに一覧では false」
- * という乖離が構造的に起こり得ない。
- */
-
+import * as react_router from "react-router";
+import * as react from "react";
+import { ReactNode, CSSProperties } from "react";
+import * as _aiquants_authz_core from "@aiquants/authz-core";
+import { EffectivePermission, DenyInfo, AuthzAction, MergedScope, AuthzGrant, AuthzRole, AuthzResource, AuthzUser, AuthzAssignment, AuthzGroupRoleAssignment, AuthzGroupSummary, AuthzAdminStore } from "@aiquants/authz-core";
 type Awaitable<T> = T | Promise<T>;
 type AuthzUserId = string | number;
-/**
- * Thrown when the API itself is called incorrectly (bad arguments, missing port) — a programmer error,
- * never an authorization decision. It is deliberately NOT an `AuthzDeniedError`: a misuse must surface as a
- * loud 500, not as a silent 403 that looks like a permission problem.
- * API の使い方が誤っている場合に送出される例外。認可拒否 (403) とは明確に区別されるプログラマ向けエラー。
- */
 declare class AuthzUsageError extends Error {
     constructor(message: string);
 }
-/**
- * Arguments handed to the {@link AuthzConfig.getEffectivePermissions} port.
- * 実効権限ポートへ渡す引数。
- *
- * `tenantId` is a **required, non-empty string**. It is never absent and never `null`: a port that
- * receives no tenant would have to guess, and the only guess an SQL adapter can make — omit the
- * predicate — returns every tenant's grants. That inversion is the failure this contract removes.
- * `tenantId` は必須かつ非空 (欠落を「全テナント」に読み替える経路を型ごと塞ぐ形)。
- */
 type EffectivePermissionsQuery = {
     userId: AuthzUserId | null;
     tenantId: string;
     groupIds?: (string | number)[];
     appKey: string;
-    /** Always a de-duplicated, non-empty list — the port may load them all in one round-trip. Read-only: the adapter reports on exactly these keys. */
     resourceKeys: readonly string[];
 };
 type AuthzConfig = {
-    /** Stable app identifier (e.g. "quants"). Bound into every permission query. */
     appKey: string;
-    /** Resolve the acting user id from the request (cookie/session/openid → the consumer's user id). */
     resolveUserId: (request: Request) => Awaitable<AuthzUserId | null | undefined>;
-    /**
-     * Resolve the acting tenant id from the request (header / cookie / subdomain → tenant id).
-     * **Required**: every permission question is asked within exactly one tenant, so a host that
-     * cannot name it must not be able to ask at all. Returning a blank string raises
-     * `AuthzTenantError` — it is never read as "no filter" / "every tenant".
-     * リクエストからテナント ID を解決するポート (必須)。空文字は「全テナント」ではなく例外。
-     */
     resolveTenantId: (request: Request) => Awaitable<string>;
-    /**
-     * Prove the acting identity may act **as** the resolved tenant. **Required**, with no permissive
-     * default: `resolveTenantId` only says *which* tenant was named, and that name comes from a
-     * client-influenced channel (header / sub-domain / cookie). Without this seam a user of tenant A
-     * is authorized inside tenant B by naming tenant B — B's `@authenticated` grants apply and every
-     * downstream tenant check still passes, because the permission genuinely belongs to B.
-     * リクエストが名乗ったテナントへの帰属証明 (必須・既定値なし)。テナント名は利用者が影響できる経路から
-     * 来るため、これが無いと「別テナントを名乗るだけで越境認可」になる。
-     *
-     * Called once per check, **before** any permission is loaded. `userId` is `null` for an anonymous
-     * caller; the host decides whether that tenant's `@anonymous` grants may be used (they are public
-     * by construction, so `true` is the usual answer).
-     * 権限読込より前に 1 回だけ呼ばれる。匿名呼び出しの扱いはホストが決める。
-     */
     assertTenantMembership: (request: Request, tenantId: string, userId: AuthzUserId | null) => Awaitable<boolean>;
-    /**
-     * Optionally resolve acting user's group IDs, for the tenant the request was scoped to.
-     * リクエストのスコープとなったテナントに対して、実行ユーザーのグループ ID を解決する任意ポート。
-     *
-     * `tenantId` is the value `resolveTenantId` already produced and validated, so a host never has to
-     * derive the tenant a second time — a second derivation is a second thing that can disagree.
-     * `tenantId` は解決・検証済みの値 (ホスト側での二重解決を不要にし、乖離の余地を作らないため)。
-     */
     resolveGroupIds?: (request: Request, tenantId: string) => Awaitable<(string | number)[] | null | undefined>;
-    /**
-     * Load effective permissions for (user, app, resources) — **one call, many resources** (typically
-     * `getEffectivePermissionsMany` from `@aiquants/authz-drizzle`). A key with no grants may be omitted or
-     * mapped to `null`; both mean "no permission" (fail-close).
-     */
     getEffectivePermissions: (args: EffectivePermissionsQuery) => Awaitable<Record<string, EffectivePermission | null | undefined> | null | undefined>;
-    /**
-     * Optional: every resource key registered for this app **within `tenantId`** (typically
-     * `listResourceKeys` from `@aiquants/authz-drizzle`, whose 4th argument is that same tenant).
-     * Configuring it is what makes `getMyPermissions(request)` — with no resource list — legal;
-     * without it that call throws {@link AuthzUsageError} instead of guessing.
-     * 指定テナントに登録済みの全リソースキーを返す任意ポート。
-     *
-     * The tenant is handed in already resolved and validated: making the host re-derive it from the
-     * raw `Request` would create a second, divergable tenant source, and a host that derived it
-     * differently (or could not) would report on another tenant's resource keys.
-     * テナントは解決・検証済みの値として渡す (ホスト側での再導出は第 2 のテナント源となり乖離するため)。
-     *
-     * Called only after `assertTenantMembership` has proven the caller may act as `tenantId`: the set of
-     * registered keys is itself that tenant's information, so a non-member must not be able to provoke
-     * this query at all.
-     * 帰属証明を通った後にのみ呼ばれる (登録済みキーの集合自体がテナントの情報であるため)。
-     */
     listResourceKeys?: (request: Request, tenantId: string) => Awaitable<readonly string[] | null | undefined>;
-    /** Default deny handler. If omitted, denies throw AuthzDeniedError (403). */
     onDeny?: (info: DenyInfo) => void;
 };
 type RequirePermissionOptions = {
-    /** When set, denials `throw redirect(failureRedirect)` instead of throwing 403. */
     failureRedirect?: string;
 };
-/**
- * Serializable per-resource permission summary for UI (loader → component).
- * UI 向けの直列化可能なリソース単位権限サマリ (loader からコンポーネントへ受け渡す形)。
- *
- * 真偽値は `can` 接頭辞で統一されている。`delete` のような素の動詞名は分割代入できず
- * (`const { delete } = view` は構文エラー)、フックの戻り値との二重語彙も生むため採用しない。
- */
 type PermissionView<K extends string = string> = {
     resourceKey: K;
     canRead: boolean;
     canCreate: boolean;
     canUpdate: boolean;
     canDelete: boolean;
-    /** create ∪ update */
     canWrite: boolean;
-    /** read granted but row and/or column restricted (→ △ partial). */
     readPartial: boolean;
     actions: AuthzAction[];
 };
-/** Result of a successful {@link createAuthz} guard. ガード成功時の戻り値。 */
 type RequirePermissionResult<K extends string = string> = {
     userId: AuthzUserId | null;
-    /** The tenant the decision was made within (always present, never blank). 判定を行ったテナント。 */
     tenantId: string;
-    /** Effective row/column scope for the guarded action — apply as WHERE / column mask. */
     scope: MergedScope;
-    /** UI view derived from the **same** evaluation as the guard decision (no second lookup). */
     permission: PermissionView<K>;
 };
-/**
- * Permission views keyed by the exact resource keys that were requested.
- * 要求したキーで型付けした権限ビュー群。
- *
- * リテラルのキーを渡した場合だけ「そのキーは必ず存在する」形になる。`string[]` のようにキーが実行時に
- * しか分からない場合は `| undefined` を含む索引型へ落ち、存在チェックを強制する (総和型の索引を
- * 名乗ると、要求していないキーが型の上では必ず存在することになり、元の不具合と同じ罠に戻る)。
- *
- * ⚠️ キーは配列の **要素型** から導かれる。`flag ? ["a"] : ["b"]` のように要素型が合併になる式では、
- * 実行時に片方しか無くても型の上では両方が存在する扱いになる。リテラル配列を直接渡すか
- * `resourceKeysOf(registry)` を使うこと。
- * ⚠️ 戻り値を `Record<string, …>` 型の変数へ代入すると、その文脈から `K` が `string` へ広がり
- * 索引型 (値は `| undefined`) に落ちる。リテラルキーの保証が要る箇所では代入先を広げないこと。
- * ⚠️ 戻り値は素のオブジェクト。要求していない `toString` などのキーを読むと `Object.prototype` の
- * メンバが返る (索引型の `| undefined` とは一致しない)。要求したキーだけを読むこと。
- */
 type PermissionViewMap<K extends string> = string extends K ? Record<string, PermissionView | undefined> : {
     [P in K]: PermissionView<P>;
 };
-/**
- * Map an EffectivePermission to a serializable {@link PermissionView}.
- * 実効権限を直列化可能な {@link PermissionView} へ変換する処理。
- *
- * @returns The UI-facing permission summary (all-false when `perm` is absent). UI 表示用の権限サマリ。
- */
 declare function toPermissionView<K extends string>(resourceKey: K, perm: EffectivePermission | null | undefined): PermissionView<K>;
-/**
- * React Router adapter. Binds `appKey` and the DI deps, exposing:
- *  - `requirePermission(request, {resourceKey, action}, options?)` → `{ userId, tenantId, scope, permission }` on allow
- *    (apply row WHERE / column mask with `scope`; render `permission` in the UI); denies throw 403 or redirect.
- *    Every check is scoped to the tenant `resolveTenantId` returns, that tenant must be one the caller is proven
- *    to belong to (`assertTenantMembership`, else deny `not-a-tenant-member`), and a permission issued for
- *    another tenant is denied (`tenant-mismatch`) rather than trusted.
- *  - `getMyPermissions(request, {resourceKeys})` → `Record<resourceKey, PermissionView>` for the UI,
- *    or `getMyPermissions(request)` for every registered resource when `listResourceKeys` is configured.
- *    Membership is proven **before** that resource list is read, so naming a foreign tenant never reveals
- *    which resources it has registered.
- * `appKey` と DI ポートを束ね、ガードと自己権限取得の 2 面だけを公開するファクトリ。
- *
- * @returns The bound `requirePermission` / `getMyPermissions` pair. 結線済みの認可 API 一式。
- */
 declare function createAuthz(config: AuthzConfig): {
     requirePermission: <K extends string>(request: Request, query: {
         resourceKey: K;
@@ -193,21 +62,6 @@ declare function createAuthz(config: AuthzConfig): {
         }): Promise<Record<string, PermissionView | undefined>>;
     };
 };
-
-/**
- * The label contract of the authorization admin UI: its string shape, the English defaults, and the
- * per-section merge that resolves a host's partial overrides against them.
- * 認可管理 UI のラベル契約 (文言の型・英語既定値・部分上書きを解決するセクション単位マージ)。
- *
- * A host overrides whole sections through `createAuthzAdminRoutes(..., { labels })`; sections it
- * leaves out keep the defaults, so a partial translation never blanks a screen.
- * アプリ側は `createAuthzAdminRoutes(..., { labels })` でセクション単位に上書きする形
- * (未指定セクションは既定値のまま残るため、部分翻訳でも画面が空にならない)。
- */
-/**
- * Authz admin UI strings (i18n). Defaults are English; override per-section via `createAuthzAdminRoutes(..., { labels })`.
- * 認可管理 UI の文言 (i18n)。既定は英語で、セクション単位に上書きできる形。
- */
 type AuthzAdminLabels = {
     title: string;
     myPermission: string;
@@ -219,10 +73,6 @@ type AuthzAdminLabels = {
         group_roles: string;
         graph: string;
     };
-    /**
-     * Strings shared by every tab, including the tenant column / field every tenant-scoped table shows.
-     * 全タブ共通の文言 (テナント列・テナント入力欄を含む)。
-     */
     common: {
         add: string;
         save: string;
@@ -325,27 +175,10 @@ type PartialAuthzAdminLabels = {
     error?: Partial<AuthzAdminLabels["error"]>;
     warn?: Partial<AuthzAdminLabels["warn"]>;
 };
-/**
- * Merge partial overrides onto the English defaults, one section at a time.
- * 部分的な上書きを英語の既定値へセクション単位で統合する処理。
- *
- * The merge is shallow **per section**, not a whole-object replace: a host that overrides only
- * `grants.note` keeps every other `grants` string instead of losing them.
- * 統合はセクション単位の浅いマージであり全体置換ではない形
- * (`grants.note` だけを上書きしても、同セクションの他文言は失われない)。
- *
- * @param over Partial overrides, or `undefined` to keep the defaults. 部分的な上書き (`undefined` なら既定値のまま)。
- * @returns The fully resolved label set. 解決済みの全文言。
- */
 declare function resolveLabels(over?: PartialAuthzAdminLabels): AuthzAdminLabels;
-
 type WithLabels = {
     labels: AuthzAdminLabels;
 };
-/**
- * Loader payload of any tenant-scoped tab: the tenant every row on screen was loaded for.
- * テナント単位タブの loader ペイロード共通部 (画面上の全行を読み込んだテナント)。
- */
 type WithTenant = {
     tenantId: string;
 };
@@ -367,88 +200,24 @@ type AuthzLayoutProps = {
         annotation: React.ReactNode;
     }) => React.ReactNode;
 };
-/**
- * Layout route for a nested route configuration; the active tab is rendered through `Outlet`.
- * ネストルート構成用のレイアウト (子タブは `Outlet` で描画)。`routes.ts` をネスト構成にする場合の入口。
- *
- * @param props Optional header renderer. 任意のヘッダ描画関数。
- * @returns The framed admin page hosting the nested route. ネストされた子ルートを収めた管理画面。
- */
 declare function AuthzLayout({ renderHeader }?: AuthzLayoutProps): react.JSX.Element;
-/**
- * Build the admin UI's error boundary with labels baked in.
- * ラベルを埋め込んだ認可管理 UI のエラー境界を生成する処理。
- *
- * An error boundary cannot read loader data, so its wording cannot come from the loader the way
- * every tab's does; the host injects its own locale here instead.
- * エラー境界は loader データを読めないため、他タブのようにラベルを loader から得られない形
- * (アプリ側が自分のロケールをここで注入する)。
- *
- * @param over Partial label overrides; omitted sections keep the English defaults. 部分的なラベル上書き (未指定は英語の既定値)。
- * @returns An error boundary component bound to those labels. そのラベルを束縛したエラー境界コンポーネント。
- */
 declare function makeAuthzErrorBoundary(over?: PartialAuthzAdminLabels): () => React.ReactElement;
-/**
- * The error boundary bound to the package's English default labels.
- * 英語 (既定ラベル) のエラー境界。i18n する場合は {@link makeAuthzErrorBoundary} を使う形。
- */
 declare const AuthzErrorBoundary: () => React.ReactElement;
 type AuthzRolesData = WithLabels & WithTenant & {
     roles: AuthzRole[];
     selfAdminRoleIds?: number[];
 };
-/**
- * Roles tab: lists the tenant's roles and offers create / rename / enable / delete.
- * ロールタブ。当該テナントのロール一覧と、作成・改名・有効切替・削除の操作を提供するコンポーネント。
- *
- * Reads {@link AuthzRolesData}; the tenant shown in every row is the one the guard resolved, which
- * the loader also echoes as `tenantId`.
- * {@link AuthzRolesData} を読む形。表示するテナントはガードが解決したもの (loader が `tenantId` として同梱)。
- *
- * @returns The roles tab. ロールタブ。
- */
 declare function AuthzRolesView(): react.JSX.Element;
 type AuthzResourcesData = WithLabels & WithTenant & {
     resources: AuthzResource[];
 };
-/**
- * Resources tab: lists the tenant's resources and offers create / rename / delete.
- * リソースタブ。当該テナントのリソース一覧と、作成・改名・削除の操作を提供するコンポーネント。
- *
- * Reads {@link AuthzResourcesData}; the tenant shown is the guard-resolved one.
- * {@link AuthzResourcesData} を読む形 (表示するテナントはガードが解決したもの)。
- *
- * @returns The resources tab. リソースタブ。
- */
 declare function AuthzResourcesView(): react.JSX.Element;
-/**
- * Grants tab payload. `roles` / `resources` are the **full** rows, not just the id + key pairs the
- * select boxes need: a grant row carries no tenant of its own, so the referenced role's projected
- * tenant is what the tenant column shows.
- * 付与タブのペイロード。`roles` / `resources` は全項目を持つ行 (付与行にテナント列が無く、参照先ロールの実テナントを表示するため)。
- */
 type AuthzGrantsData = WithLabels & WithTenant & {
     grants: AuthzGrant[];
     roles: AuthzRole[];
     resources: AuthzResource[];
 };
-/**
- * Permissions tab: lists the tenant's grants and offers grant / re-scope / revoke.
- * 権限付与タブ。当該テナントの付与一覧と、付与・スコープ変更・削除の操作を提供するコンポーネント。
- *
- * Reads {@link AuthzGrantsData}; its role and resource pickers are already narrowed to the
- * guard-resolved tenant by the loader, so a cross-tenant pair cannot be selected here.
- * {@link AuthzGrantsData} を読む形。ロール・リソースの選択肢は loader が解決済みテナントへ絞ってあるため、
- * 越境した組み合わせは選べない。
- *
- * @returns The permissions tab. 権限付与タブ。
- */
 declare function AuthzGrantsView(): react.JSX.Element;
-/**
- * User-assignment tab payload. `roles` holds the **full** role rows because `TDUserRole` has no tenant
- * column: the assignment's tenant is the one projected onto the role it points at.
- * ユーザー割当タブのペイロード。`TDUserRole` にテナント列が無いため、`roles` は参照先ロールの実テナントを含む全項目行。
- */
 type AuthzUserRolesData = WithLabels & WithTenant & {
     assignments: AuthzAssignment[];
     roles: AuthzRole[];
@@ -456,33 +225,12 @@ type AuthzUserRolesData = WithLabels & WithTenant & {
     actorUserId?: number;
     selfAdminRoleIds?: number[];
 };
-/**
- * User-roles tab: lists the tenant's user assignments and offers assign / unassign.
- * ユーザー割当タブ。当該テナントのユーザー×ロール割当一覧と、割当・解除の操作を提供するコンポーネント。
- *
- * Reads {@link AuthzUserRolesData}; removing an assignment that supports the actor's own admin
- * status is confirmed first through {@link confirmGuard}.
- * {@link AuthzUserRolesData} を読む形 (実行者自身の管理権限を支える割当の解除は {@link confirmGuard} で確認)。
- *
- * @returns The user-roles tab. ユーザー割当タブ。
- */
 declare function AuthzUserRolesView(): react.JSX.Element;
 type AuthzGroupRolesData = WithLabels & WithTenant & {
     groupRoles: AuthzGroupRoleAssignment[];
     roles: AuthzRole[];
     groups: AuthzGroupSummary[];
 };
-/**
- * Group-roles tab: lists the tenant's group assignments and offers assign / unassign.
- * グループ割当タブ。当該テナントのグループ×ロール割当一覧と、割当・解除の操作を提供するコンポーネント。
- *
- * Reads {@link AuthzGroupRolesData}. See the module docstring for its known layout deviations from
- * the other tabs (hard-coded confirmation text, no tenant column, error alert placed differently).
- * {@link AuthzGroupRolesData} を読む形。他タブとの既知の逸脱 (確認文言のハードコード・テナント列の非表示・
- * エラー表示位置の相違) はモジュール冒頭の記載を参照。
- *
- * @returns The group-roles tab. グループ割当タブ。
- */
 declare function AuthzGroupRolesView(): react.JSX.Element;
 type AuthzGraphData = WithLabels & WithTenant & {
     users: AuthzUser[];
@@ -494,16 +242,6 @@ type AuthzGraphData = WithLabels & WithTenant & {
     groups?: AuthzGroupSummary[];
 };
 type AuthzNodeType = "user" | "group" | "role" | "resource";
-/**
- * Graph tab: the authorization relations of the tenant, as a topology map or as linked columns.
- * グラフタブ。当該テナントの認可関係を、トポロジ図または連動カラム表示で俯瞰するコンポーネント。
- *
- * Reads {@link AuthzGraphData}. Selecting a node filters the other three columns to what that node
- * actually reaches, and the search box narrows every column at once.
- * {@link AuthzGraphData} を読む形 (ノード選択で他 3 カラムを到達範囲に絞り、検索は全カラムへ同時適用)。
- *
- * @returns The graph tab. グラフタブ。
- */
 declare function AuthzGraphView(): react.JSX.Element;
 type AuthzAdminAppViewProps = {
     renderHeader?: (props: {
@@ -511,19 +249,7 @@ type AuthzAdminAppViewProps = {
         annotation: React.ReactNode;
     }) => React.ReactNode;
 };
-/**
- * Render the whole admin UI from a single splat route (`authz/*`), without depending on any store.
- * スプラット (`authz/*`) 1 ルートで認可管理 UI 全体を描画するコンポーネント (store 非依存)。
- *
- * The loader's `segment` selects the tab; the shell and the tab read one merged loader payload
- * (the segment's rows plus `myPermissions` and `labels` at the top level).
- * loader が返す `segment` に応じてタブを選ぶ形 (外枠と各ビューは統合済みの同一 loader データを読む)。
- *
- * @param props Optional header renderer. 任意のヘッダ描画関数。
- * @returns The admin page for the requested segment. 要求セグメントに対応する管理画面。
- */
 declare function AuthzAdminAppView({ renderHeader }?: AuthzAdminAppViewProps): react.JSX.Element;
-
 type Req = {
     request: Request;
 };
@@ -531,121 +257,36 @@ type PermissionQuery = {
     resourceKey: string;
     action: AuthzAction;
 };
-/**
- * Everything a guarded admin request resolved to: the tenant it acts within and the acting user.
- * ガード済みの管理リクエストが解決した文脈 (操作対象テナントと実行ユーザー)。
- *
- * Both fields are required. The tenant is what every store call is scoped by, and the user id is what
- * the audit columns and the "last administrator" warning are computed from; neither has a meaningful
- * "absent" value on this route.
- * 双方必須 (テナントは全ストア呼び出しの絞り込み、ユーザー ID は監査列と自己管理者判定の基準)。
- */
 type AuthzAdminContext = {
     tenantId: string;
     userId: string | number;
 };
 type CreateAuthzAdminServerOptions = {
     store: AuthzAdminStore;
-    /** 管理画面のガード資源キー(既定 `authz_admin`)。 */
     resourceKey?: string;
-    /** 未ログインをログインへ誘導する(例: throw redirect(...))。 */
     requireUser: (request: Request) => Promise<unknown>;
-    /**
-     * Authorization guard supplied by the app (from `createAuthz`); allow → `{ userId, tenantId, permission }`.
-     * 認可ガード (アプリの createAuthz 由来)。allow で { userId, tenantId, permission } を返すポート。
-     * `userId` は nullable(未解決/万一の public 付与)であり、createAuthzAdminServer 内で deny する
-     * (管理経路は監査・自己権限計算に実 id が必須のため非 null を保証)。
-     * `tenantId` は **ガードが判定に使ったテナントそのもの**。ここで捨てて画面側が別経路で引き直すと、
-     * 「A テナントの権限で B テナントを編集できる」という越境が構造的に開く。
-     * `permission` は **同一判定から導かれた** 自己権限ビューであり、表示用に再取得しない
-     * (再取得は「ガードは通るのにバッジは権限なし」という乖離の温床)。
-     */
     requirePermission: (request: Request, query: PermissionQuery) => Promise<{
         userId: string | number | null;
         tenantId: string;
         permission: PermissionView;
     }>;
-    /** 文言の部分上書き(既定は日本語)。 */
     labels?: PartialAuthzAdminLabels;
 };
-/**
- * Build the authorization admin UI's server side: one guard seam, per-tab data loaders, and the
- * loader / action pair of every route.
- * 認可管理 UI のサーバ側 (単一のガードシーム、タブ別データ取得、各ルートの loader/action) を構築する処理。
- *
- * Every route entry is guarded through the app-supplied `requirePermission`, whose result — the
- * tenant, the acting user, and the self-permission view — comes from **one** evaluation and is
- * carried onward as an {@link AuthzAdminContext}. Nothing here re-derives the tenant from the request
- * or re-loads the permission for display: a second lookup can disagree with the first, which is
- * exactly the "guard allows but the badge says denied" failure, and re-deriving the tenant is how a
- * screen ends up editing a tenant the guard never authorized.
- * 各ルートはアプリ由来の `requirePermission` を通し、その 1 回の判定から得たテナント・実行ユーザー・
- * 自己権限を {@link AuthzAdminContext} として持ち回る形 (テナントの引き直しも表示用の再取得も行わない)。
- *
- * Writes never trust the submitted ids: each one is re-loaded from a tenant-scoped listing and, where
- * the row carries its own tenant, compared against it. A missing row and a foreign row are answered
- * identically, so the screen cannot be used as a cross-tenant existence oracle.
- * 書き込みは送信された id を信用せず、テナント絞り込みの一覧から引き直して帰属を確認する形
- * (「存在しない」と「別テナント」は同じ応答にし、他テナントの存在確認手段にしない)。
- *
- * @param opts Store port, guard seams, admin resource key and label overrides.
- *   store ポート・ガードシーム・管理リソースキー・文言上書き。
- * @returns The labels, the guarded resource key, `layoutGuard`, and every route's loader / action.
- *   文言・ガード対象リソースキー・`layoutGuard`・各ルートの loader/action。
- */
 declare function createAuthzAdminServer(opts: CreateAuthzAdminServerOptions): {
-    /** 露出: スプラットマウント(app.ts)がガードを 1 回だけ行うために使う。 */
     labels: AuthzAdminLabels;
     resourceKey: string;
     layoutGuard: (request: Request) => Promise<AuthzAdminContext & {
         myPermissions: Record<string, PermissionView | undefined>;
     }>;
-    /** /authz レイアウト: requireUser(302) → requirePermission(read, 403)。自己権限はガードの戻り値から得る。 */
     layout: {
-        /**
-         * Layout loader: guard once, then hand the shell the tenant and the self-permission map.
-         * レイアウトの loader。ガードを 1 回だけ行い、テナントと自己権限マップを外枠へ渡す処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The layout payload. レイアウトの表示データ。
-         * @throws {Response} `302` when unauthenticated, `403` when the read is denied. 未認証は 302、拒否は 403。
-         */
         loader({ request }: Req): Promise<AuthzLayoutData>;
     };
-    /** /authz index → roles へ。 */
     index: {
-        /**
-         * Index loader: the admin root has no view of its own, so it redirects to the roles tab.
-         * インデックスの loader。管理ルートは固有の表示を持たないためロールタブへ転送する処理。
-         *
-         * @returns Never returns; always throws the redirect. 常に転送を送出 (正常復帰しない)。
-         * @throws {Response} The `/authz/roles` redirect. `/authz/roles` への転送。
-         */
         loader(): never;
     };
     roles: {
         data: (ctx: AuthzAdminContext) => Promise<AuthzRolesData>;
-        /**
-         * Roles tab loader: guard for `read`, then load the tab within the guarded tenant.
-         * ロールタブの loader。`read` をガードし、ガード済みテナントの範囲で読み込む処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The roles tab payload. ロールタブの表示データ。
-         * @throws {AuthzDeniedError} When the read is denied. 読み取りが拒否された場合。
-         */
         loader({ request }: Req): Promise<AuthzRolesData>;
-        /**
-         * Roles tab action: create / save / toggle / delete, each guarded for its own verb.
-         * ロールタブの action。作成・保存・有効切替・削除を、それぞれの動詞でガードして実行する処理。
-         *
-         * `create` and `save` additionally reconcile the submitted `tenantId` with the guarded one
-         * before the store is called, and every id is re-loaded through `ownedRole`.
-         * `create`/`save` は送信された `tenantId` をガード側と突合し、id は必ず `ownedRole` で引き直す形。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns `{ ok: true }`, or a `400` payload on a validation failure. 成功、または検証失敗時の 400 応答。
-         * @throws {Response} `403` when the guard denies the verb. 動詞のガードが拒否した場合。
-         */
         action({ request }: Req): Promise<react_router.UNSAFE_DataWithResponseInit<{
             error: string;
         }> | {
@@ -654,27 +295,7 @@ declare function createAuthzAdminServer(opts: CreateAuthzAdminServerOptions): {
     };
     resources: {
         data: (ctx: AuthzAdminContext) => Promise<AuthzResourcesData>;
-        /**
-         * Resources tab loader: guard for `read`, then load the tab within the guarded tenant.
-         * リソースタブの loader。`read` をガードし、ガード済みテナントの範囲で読み込む処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The resources tab payload. リソースタブの表示データ。
-         * @throws {AuthzDeniedError} When the read is denied. 読み取りが拒否された場合。
-         */
         loader({ request }: Req): Promise<AuthzResourcesData>;
-        /**
-         * Resources tab action: create / save / delete, each guarded for its own verb.
-         * リソースタブの action。作成・保存・削除を、それぞれの動詞でガードして実行する処理。
-         *
-         * `create` reconciles the submitted `tenantId` with the guarded one; `save` and `delete`
-         * re-load the id through `ownedResource` instead of trusting the form.
-         * `create` は送信 `tenantId` を突合し、`save`/`delete` は `ownedResource` で id を引き直す形。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns `{ ok: true }`, or a `400` payload on a validation failure. 成功、または検証失敗時の 400 応答。
-         * @throws {Response} `403` when the guard denies the verb. 動詞のガードが拒否した場合。
-         */
         action({ request }: Req): Promise<react_router.UNSAFE_DataWithResponseInit<{
             error: string;
         }> | {
@@ -683,28 +304,7 @@ declare function createAuthzAdminServer(opts: CreateAuthzAdminServerOptions): {
     };
     grants: {
         data: (ctx: AuthzAdminContext) => Promise<AuthzGrantsData>;
-        /**
-         * Grants tab loader: guard for `read`, then load the tab within the guarded tenant.
-         * 権限付与タブの loader。`read` をガードし、ガード済みテナントの範囲で読み込む処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The grants tab payload. 権限付与タブの表示データ。
-         * @throws {AuthzDeniedError} When the read is denied. 読み取りが拒否された場合。
-         */
         loader({ request }: Req): Promise<AuthzGrantsData>;
-        /**
-         * Grants tab action: create / save / delete, each guarded for its own verb.
-         * 権限付与タブの action。作成・保存・削除を、それぞれの動詞でガードして実行する処理。
-         *
-         * A grant links two rows, so `create` proves **both** the role and the resource belong to
-         * the guarded tenant; `save` and `delete` prove the grant itself through `assertOwnedGrant`.
-         * 付与は 2 行を結ぶため `create` はロール・リソース双方の帰属を証明し、`save`/`delete` は
-         * `assertOwnedGrant` で付与自体の帰属を証明する形。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns `{ ok: true }`, or a `400` payload on a validation failure. 成功、または検証失敗時の 400 応答。
-         * @throws {Response} `403` when the guard denies the verb. 動詞のガードが拒否した場合。
-         */
         action({ request }: Req): Promise<react_router.UNSAFE_DataWithResponseInit<{
             error: string;
         }> | {
@@ -713,28 +313,7 @@ declare function createAuthzAdminServer(opts: CreateAuthzAdminServerOptions): {
     };
     userRoles: {
         data: (ctx: AuthzAdminContext) => Promise<AuthzUserRolesData>;
-        /**
-         * User-roles tab loader: guard for `read`, then load the tab within the guarded tenant.
-         * ユーザー割当タブの loader。`read` をガードし、ガード済みテナントの範囲で読み込む処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The user-roles tab payload. ユーザー割当タブの表示データ。
-         * @throws {AuthzDeniedError} When the read is denied. 読み取りが拒否された場合。
-         */
         loader({ request }: Req): Promise<AuthzUserRolesData>;
-        /**
-         * User-roles tab action: assign / remove, each guarded for its own verb.
-         * ユーザー割当タブの action。割当・解除を、それぞれの動詞でガードして実行する処理。
-         *
-         * The assignment row carries no tenant of its own, so both ends are proven — the user
-         * through `assertOwnedUser` and the role through `ownedRole` — before the store is called.
-         * 割当行はテナントを持たないため、ユーザー側 (`assertOwnedUser`) とロール側 (`ownedRole`) の
-         * 両端の帰属を証明してからストアを呼ぶ形。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns `{ ok: true }`, or a `400` payload on a validation failure. 成功、または検証失敗時の 400 応答。
-         * @throws {Response} `403` when the guard denies the verb. 動詞のガードが拒否した場合。
-         */
         action({ request }: Req): Promise<react_router.UNSAFE_DataWithResponseInit<{
             error: string;
         }> | {
@@ -743,27 +322,7 @@ declare function createAuthzAdminServer(opts: CreateAuthzAdminServerOptions): {
     };
     groupRoles: {
         data: (ctx: AuthzAdminContext) => Promise<AuthzGroupRolesData>;
-        /**
-         * Group-roles tab loader: guard for `read`, then load the tab within the guarded tenant.
-         * グループ割当タブの loader。`read` をガードし、ガード済みテナントの範囲で読み込む処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The group-roles tab payload. グループ割当タブの表示データ。
-         * @throws {AuthzDeniedError} When the read is denied. 読み取りが拒否された場合。
-         */
         loader({ request }: Req): Promise<AuthzGroupRolesData>;
-        /**
-         * Group-roles tab action: assign / remove, each guarded for its own verb.
-         * グループ割当タブの action。割当・解除を、それぞれの動詞でガードして実行する処理。
-         *
-         * As with user roles the link row carries no tenant, so both the group (`ownedGroup`) and
-         * the role (`ownedRole`) are proven to belong to the guarded tenant first.
-         * ユーザー割当と同様に割当行はテナントを持たないため、グループ側・ロール側双方の帰属を先に証明する形。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns `{ ok: true }`, or a `400` payload on a validation failure. 成功、または検証失敗時の 400 応答。
-         * @throws {Response} `403` when the guard denies the verb. 動詞のガードが拒否した場合。
-         */
         action({ request }: Req): Promise<react_router.UNSAFE_DataWithResponseInit<{
             error: string;
         }> | {
@@ -772,32 +331,16 @@ declare function createAuthzAdminServer(opts: CreateAuthzAdminServerOptions): {
     };
     graph: {
         data: (ctx: AuthzAdminContext) => Promise<AuthzGraphData>;
-        /**
-         * Graph tab loader: guard for `read`, then load every listing of the guarded tenant.
-         * グラフタブの loader。`read` をガードし、ガード済みテナントの全一覧を読み込む処理。
-         *
-         * @param args The route arguments (request only). ルート引数 (request のみ)。
-         * @returns The graph tab payload. グラフタブの表示データ。
-         * @throws {AuthzDeniedError} When the read is denied. 読み取りが拒否された場合。
-         */
         loader({ request }: Req): Promise<AuthzGraphData>;
     };
 };
-
 type RouteArgs = {
     request: Request;
     params: Record<string, string | undefined>;
 };
 type CreateAuthzAdminAppOptions = CreateAuthzAdminServerOptions & {
-    /** マウントのベースパス(タブリンク/未指定セグメントのリダイレクト先)。既定 `/authz`。 */
     basePath?: string;
 };
-/**
- * Build the loader/action pair that serves the whole authorization admin UI from one splat route.
- * 認可管理 UI 全体を 1 本のスプラットルートで提供する loader/action 対を生成するファクトリ。
- *
- * @returns The route `loader` / `action` plus the underlying server for direct use. ルートの loader/action と内部サーバ。
- */
 declare function createAuthzAdminApp(opts: CreateAuthzAdminAppOptions): {
     loader: (args: RouteArgs) => Promise<{
         labels: AuthzAdminLabels;
@@ -915,16 +458,6 @@ declare function createAuthzAdminApp(opts: CreateAuthzAdminAppOptions): {
         };
     };
 };
-
-/**
- * Inline styles shared by the admin tabs, keyed by role.
- * 管理タブ共通のインラインスタイル (役割名をキーとする形)。
- *
- * `satisfies` is used rather than a `Record<string, CSSProperties>` annotation: the annotation
- * erases the key set, so a typo such as `ui.dangerBtn` type-checks and silently renders unstyled.
- * `Record<string, CSSProperties>` の注釈ではなく `satisfies` を用いる形 (注釈はキー集合を消し、
- * `ui.dangerBtn` のような綴り誤りが型検査を素通りして無装飾描画になるため)。
- */
 declare const ui: {
     page: {
         padding: string;
@@ -1069,72 +602,27 @@ declare const ui: {
         padding: string;
     };
 };
-/**
- * Stack a label above its control, keeping the two from overlapping and the tabs consistent.
- * ラベルを上、コントロールを下に縦積みするフィールド (重なり防止・レイアウト統一)。
- *
- * A `<div>` rather than a `<label>`: the control is expected to carry its own `aria-label`.
- * `<label>` ではなく `<div>` で構成する形 (コントロール側が `aria-label` を持つ前提のため)。
- *
- * @param props The label text, an optional hint, and the control to wrap. ラベル文言・任意の補足・包むコントロール。
- * @returns The stacked field. 縦積みされたフィールド。
- */
 declare function Field({ label, hint, children }: {
     label: string;
     hint?: string;
     children: ReactNode;
 }): react.JSX.Element;
-/**
- * Render an error message as an assertive alert, or nothing when there is no message.
- * エラーメッセージを `role="alert"` で表示するコンポーネント (メッセージが無ければ何も描画しない形)。
- *
- * @param props The message to show, if any. 表示するメッセージ (省略可)。
- * @returns The alert element, or `null`. アラート要素、または `null`。
- */
 declare function ErrorAlert({ message }: {
     message?: string;
 }): react.JSX.Element | null;
-
 type MyPermissionGroupItem = {
-    /** Expected or actual resource key */
     resourceKey?: string;
-    /** Human-readable resource display name (e.g. "NI", "KT", "オリジナル") */
     resourceName: string;
-    /** Permission view data for this resource */
     permission: PermissionView | null | undefined;
-    /** Expected resource key to detect mismatches with permission.resourceKey during development */
     expectedResourceKey?: string;
-    /** Nesting level for hierarchical rendering (0: root, 1: child, etc.) */
     level?: number;
-    /** Optional child items for hierarchical rendering */
     children?: MyPermissionGroupItem[];
 };
-/**
- * Flattens hierarchical items tree into a single array with computed nesting levels.
- * 木構造またはフラット配列のアイテムに level 属性を付与してフラット化する処理。
- */
 declare function flattenGroupItems(items: MyPermissionGroupItem[], currentLevel?: number): MyPermissionGroupItem[];
 type MyPermissionGroupStatusProps = {
-    /** List of resources and their permissions */
     items: MyPermissionGroupItem[];
-    /** Prefix label shown before group items or inside popover header. Default: "あなたの権限" */
     prefixLabel?: string;
-    /**
-     * Display style variant:
-     * - "pills": Inline parent label + compact status tags per item
-     * - "popover": Compact single button trigger opening detailed popup card
-     * Default: "pills"
-     */
     variant?: "pills" | "popover";
-    /**
-     * Component size variant:
-     * - "2xs": Ultra micro size for extremely dense UI
-     * - "xs": Extra small size for compact headers
-     * - "sm": Small size
-     * - "md": Standard default size
-     * - "lg": Larger size
-     * Default: "md"
-     */
     size?: "2xs" | "xs" | "sm" | "md" | "lg";
     labels?: {
         read?: string;
@@ -1149,107 +637,50 @@ type MyPermissionGroupStatusProps = {
     className?: string;
     style?: CSSProperties;
 };
-/**
- * Get human-readable summary text and style for a resource permission.
- * 権限状態から簡潔なサマリテキストとスタイルを判定 (カスタムラベル対応)。
- */
 declare function getPermissionSummary(permission: PermissionView | null | undefined, customLabels?: MyPermissionGroupStatusProps["labels"]): {
     text: string;
     color: string;
     bgColor: string;
     borderColor: string;
 };
-/**
- * Multi-resource "Your Permissions" status component.
- * Supports inline compact pills (Proposal 1) and dropdown popover card (Proposal 2).
- * 複数リソースの権限状態を共通レイアウト（pills/popover）で綺麗に整列・表示するコンポーネント。
- */
 declare function MyPermissionGroupStatus({ items, prefixLabel, variant, size, labels, className, style }: MyPermissionGroupStatusProps): react.JSX.Element;
-
 type MyPermissionIndicatorProps<K extends string = string> = {
     permission: PermissionView<K> | null | undefined;
-    /** Human-readable resource display name (e.g. "文書データ"). Falls back to permission.resourceKey. */
     resourceName?: string;
-    /**
-     * Expected resource key. Typed as `NoInfer<K>`, so when the permission carries a literal key
-     * (`getMyPermissions` / `requirePermission` both do) a mismatch is a **compile error**; the runtime
-     * detector below stays for dynamically-keyed and JavaScript callers.
-     */
     expectedResourceKey?: NoInfer<K>;
-    /** Whether to include resource name/key tooltip. Default true. */
     showResourceTooltip?: boolean;
     labels?: {
         read?: string;
         write?: string;
         delete?: string;
     };
-    /** Show a "（部分）" hint when read is partial. Default true. */
     showScopeSummary?: boolean;
     className?: string;
 };
 type MyPermissionStatusProps<K extends string = string> = MyPermissionIndicatorProps<K> & {
-    /** Label prefix shown before the indicator badges. Default: "あなたの権限" */
     prefixLabel?: string;
-    /** Whether to display the prefix label. Default: true */
     showPrefixLabel?: boolean;
-    /** Additional inline styles for wrapper element. */
     style?: React.CSSProperties;
 };
-/**
- * Format human-readable resource tooltip text.
- * リソース表示名およびキーからツールチップ用テキストを生成。
- */
 declare function formatResourceTooltip(resourceKey?: string, resourceName?: string): string | undefined;
-/**
- * Display permission indicator badges for read, write, and delete capabilities.
- * 閲覧・編集・削除の権限状態バッジ群を描画。
- */
 declare function MyPermissionIndicator<K extends string = string>({ permission, resourceName, expectedResourceKey, showResourceTooltip, labels, showScopeSummary, className }: MyPermissionIndicatorProps<K>): react.JSX.Element;
-/**
- * Reusable "Your Permissions" status bar component suitable for any application page.
- * 「あなたの権限」ラベルと権限状態インジケータを束ねた再利用可能なコンポーネント。
- */
 declare function MyPermissionStatus<K extends string = string>({ permission, resourceName, expectedResourceKey, prefixLabel, showPrefixLabel, showResourceTooltip, labels, showScopeSummary, className, style, }: MyPermissionStatusProps<K>): react.JSX.Element;
-
-/**
- * Resource definition and registry utilities for preventing page-resource mismatches.
- * ページとリソースの表示・権限食い違いを防止するためのリソースレジストリ定義。
- */
 type ResourceDefinition = {
-    /** Unique resource key used in authorization rules (e.g. "documents") */
     key: string;
-    /** Human-readable display name (e.g. "文書管理") */
     name: string;
-    /** Optional description for administration UI */
     description?: string;
 };
 type ResourceDefinitionInput = {
-    /** Optional explicit resource key; defaults to the object property name */
     key?: string;
-    /** Human-readable display name (e.g. "文書管理") */
     name: string;
-    /** Optional description for administration UI */
     description?: string;
 };
 type ResourceRegistry<T extends Record<string, ResourceDefinition>> = T;
-/**
- * The resource key an entry resolves to: its explicit `key`, otherwise the property name.
- * `key` を明示していればそれ、無ければプロパティ名。
- *
- * `Extract<…, string>` を挟むのは `key?: string` (省略可) が `string | undefined` になり、素の
- * `extends string` では偽になってプロパティ名を名乗ってしまうため (実行時は `key` を使うので型が嘘になる)。
- * `key` を書いていないエントリでは `Extract` が `never` になり、プロパティ名へ落ちる。
- */
-type ResolvedResourceKey<PropertyName extends string, Input extends ResourceDefinitionInput> = [Extract<Input["key"], string>] extends [never] ? PropertyName : Extract<Input["key"], string>;
-/**
- * Define type-safe resource registry for an application.
- * アプリ全体のリソース定義（キー・表示名・説明）を一元管理するヘルパー。
- *
- * 各エントリの `key` はリテラル型のまま保持する。`Record<string, …>` へ広げてしまうと
- * {@link resourceKeysOf} が `string[]` に落ち、権限マップのキー型検査が効かなくなるため。
- *
- * @returns The registry with literal-typed resource keys. リソースキーをリテラル型で保持したレジストリ。
- */
+type ResolvedResourceKey<PropertyName extends string, Input extends ResourceDefinitionInput> = [
+    Extract<Input["key"], string>
+] extends [
+    never
+] ? PropertyName : Extract<Input["key"], string>;
 declare function defineResources<const T extends Record<string, ResourceDefinitionInput>>(resources: T): {
     [K in keyof T & string]: {
         key: ResolvedResourceKey<K, T[K]>;
@@ -1257,54 +688,19 @@ declare function defineResources<const T extends Record<string, ResourceDefiniti
         description?: string;
     };
 };
-/**
- * Extract a registry's resource keys with their literal types preserved.
- * レジストリのリソースキーをリテラル型を保ったまま取り出す処理。
- *
- * `Object.keys(registry)` は `string[]` になり、`getMyPermissions` の戻り値も索引型へ落ちてキーの誤りを
- * 検出できなくなる。加えて `Object.keys` は **プロパティ名** を返すため、`key` を明示したエントリでは
- * 実際のリソースキーと食い違う。
- *
- * ⚠️ 1 エントリでもリテラルでない `key` (例: 変数由来の `string`) を持つと、合併の性質上レジストリ全体の
- * キー型が `string` へ広がり、他のエントリ分のコンパイル時検査も無効になる。`key` は必ずリテラルで書くこと。
- *
- * @returns The registry's resource keys as a literal union array. リテラル合併型のリソースキー配列。
- */
 declare function resourceKeysOf<T extends Record<string, {
     key: string;
 }>>(registry: T): Array<T[keyof T & string]["key"]>;
-
-/**
- * Display-state derivation for a {@link PermissionView} (pure, no React state involved).
- * {@link PermissionView} から表示状態を導出するモジュール (React の状態は一切持たない純粋関数)。
- */
-
 type PermState = "full" | "partial" | "none";
-/**
- * Display-oriented reading of a {@link PermissionView}: the same `can*` booleans (safe defaults when the
- * view is absent) plus the ○△× tri-state used by the indicator components.
- * {@link PermissionView} の表示向け読み取り結果。同名の `can*` 真偽値と ○△× の三値状態を併せ持つ形。
- */
 type UsePermission = {
     canRead: boolean;
     canCreate: boolean;
     canUpdate: boolean;
     canDelete: boolean;
-    /** create ∪ update */
     canWrite: boolean;
-    /** read: none(×) / partial(△, row|col restricted) / full(○). */
     readState: PermState;
-    /** write = create ∪ update: full(○ both) / partial(△ one) / none(×). */
     writeState: PermState;
     deleteState: PermState;
 };
-/**
- * Derive ○△× display states from a {@link PermissionView}. Pure (safe to call in render);
- * named `usePermission` for ergonomic call-sites.
- * {@link PermissionView} から ○△× の表示状態を導出する純粋関数 (レンダー内から安全に呼べる形)。
- *
- * @returns The permission booleans plus their display states. 権限の真偽値と表示状態の組。
- */
 declare function usePermission(view: PermissionView | null | undefined): UsePermission;
-
 export { AuthzAdminAppView, type AuthzAdminAppViewProps, type AuthzAdminContext, type AuthzAdminLabels, type AuthzConfig, AuthzErrorBoundary, type AuthzGrantsData, AuthzGrantsView, type AuthzGraphData, AuthzGraphView, type AuthzGroupRolesData, AuthzGroupRolesView, AuthzLayout, type AuthzLayoutData, type AuthzLayoutProps, type AuthzLayoutShellProps, type AuthzNodeType, type AuthzResourcesData, AuthzResourcesView, type AuthzRolesData, AuthzRolesView, AuthzUsageError, type AuthzUserId, type AuthzUserRolesData, AuthzUserRolesView, type CreateAuthzAdminAppOptions, type CreateAuthzAdminServerOptions, type EffectivePermissionsQuery, ErrorAlert, Field, type MyPermissionGroupItem, MyPermissionGroupStatus, type MyPermissionGroupStatusProps, MyPermissionIndicator, type MyPermissionIndicatorProps, MyPermissionStatus, type MyPermissionStatusProps, type PartialAuthzAdminLabels, type PermState, type PermissionView, type PermissionViewMap, type RequirePermissionOptions, type RequirePermissionResult, type ResourceDefinition, type ResourceDefinitionInput, type ResourceRegistry, type UsePermission, createAuthz, createAuthzAdminApp, createAuthzAdminServer, defaultAuthzAdminLabels, defineResources, flattenGroupItems, formatResourceTooltip, getPermissionSummary, makeAuthzErrorBoundary, resolveLabels, resourceKeysOf, toPermissionView, ui, usePermission };