@morehao/ark-iam-react 0.0.0-stage → 1.0.0

package/dist/_types/types/platform.d.ts

@@ -0,0 +1,347 @@
+export type SysAdminType = 'admin' | 'normal';
+/**
+ * 应用/客户端来源（后端 model.AppSource / model.ApplicationClientSource）：
+ * builtin-内置（平台随产品交付的控制台应用：平台管理后台 / 租户管理后台，受删除保护）、
+ * first_party-第一方受控应用（平台自建但非内置，当前由运维产生）、third_party-第三方接入。
+ * 控制台创建的资源恒为 third_party；builtin / first_party 只能由种子与运维产生。
+ */
+export type AppSource = 'builtin' | 'first_party' | 'third_party';
+/**
+ * 启停状态（后端具名类型 model.AppStatus / ApplicationClientStatus / TenantApplicationStatus）。
+ * 取值与后端常量一一对应，禁止在页面里裸写字面量。
+ */
+export type AppStatus = 'enable' | 'disable';
+export type ApplicationClientStatus = 'enable' | 'disable';
+export type TenantApplicationStatus = 'enable' | 'disable';
+/** 连接器状态（后端具名类型 model.ConnectorStatus）：全局启停语义 enable/disable */
+export type ConnectorStatus = 'enable' | 'disable';
+/**
+ * 应用策略开关（后端具名类型，取值 enable/disable；语义等价旧 bool：true=enable / false=disable）：
+ * - AppPersonCreateTenantPolicy：application.allow_person_create_tenant（个人自助创建租户）
+ * - AppJoinByInvitePolicy：application.allow_join_by_invite（凭邀请码加入租户）
+ */
+export type AppPersonCreateTenantPolicy = 'enable' | 'disable';
+export type AppJoinByInvitePolicy = 'enable' | 'disable';
+/** 客户端协议开关（后端具名类型）：requirePKCE / requireAuthTime，取值 enable/disable。 */
+export type ClientPKCEPolicy = 'enable' | 'disable';
+export type ClientAuthTimeClaimPolicy = 'enable' | 'disable';
+/**
+ * 应用角色模板项：本应用对外提供的一个跨系统授权契约值。
+ * 下游按「claim_prefix + code」认策略名（策略在下游是全局命名实体、全租户共用一条），
+ * 故 code 由应用方在这里定义一次，租户只能"授权"、不能造值（后端 model.RoleTemplateItem）。
+ */
+export interface ApplicationRoleTemplateItem {
+    /** 契约值（= OIDC ID token 的 groups 取值）：小写字母开头，仅含小写字母、数字与下划线，模板内唯一 */
+    code: string;
+    /** 展示名：物化为租户角色的名称，非空且不超过 128 字符 */
+    name: string;
+}
+export interface ApplicationItem {
+    appID: string;
+    code: string;
+    name: string;
+    description: string;
+    logoUrl: string;
+    homepageUrl: string;
+    source: AppSource;
+    status: AppStatus;
+    sort: number;
+    allowPersonCreateTenant?: AppPersonCreateTenantPolicy;
+    allowJoinByInvite?: AppJoinByInvitePolicy;
+    /** 应用角色模板：本应用对外的契约值清单，开通应用时物化到各租户（后端 model.ApplicationEntity.RoleTemplate）。 */
+    roleTemplate?: ApplicationRoleTemplateItem[];
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface ApplicationCreateReq {
+    code: string;
+    name: string;
+    description?: string;
+    logoUrl?: string;
+    homepageUrl?: string;
+    sort?: number;
+    allowPersonCreateTenant?: AppPersonCreateTenantPolicy;
+    allowJoinByInvite?: AppJoinByInvitePolicy;
+    /** 应用角色模板：见 ApplicationItem.roleTemplate，留空表示无。 */
+    roleTemplate?: ApplicationRoleTemplateItem[];
+}
+export interface ApplicationUpdateReq {
+    appID: string;
+    /** 应用编码（自建应用可改，留空不修改；内置应用 source=builtin 恒只读）：小写字母开头，仅含小写字母、数字与下划线（后端 model.AppCodePattern）。 */
+    code?: string;
+    name?: string;
+    description?: string;
+    logoUrl?: string;
+    homepageUrl?: string;
+    status?: AppStatus;
+    sort?: number;
+    allowPersonCreateTenant?: AppPersonCreateTenantPolicy;
+    allowJoinByInvite?: AppJoinByInvitePolicy;
+    /** 应用角色模板：不传表示不修改，传 [] 表示清空，传值即全量替换（移除项会在各租户撤下该角色及其授权）。 */
+    roleTemplate?: ApplicationRoleTemplateItem[];
+}
+/** 授权类型（后端具名类型 model.GrantType，RFC 6749 标准字面量）。 */
+export type GrantType = 'authorization_code' | 'client_credentials' | 'refresh_token';
+/** 令牌端点认证方式（后端具名类型 model.TokenEndpointAuthMethod，RFC 8414 标准字面量）。 */
+export type TokenEndpointAuthMethod = 'client_secret_basic' | 'client_secret_post' | 'none';
+export interface OAuthClientItem {
+    applicationClientID: string;
+    appID: string;
+    /** 所属应用名称（后端列表/详情回填，避免前端只拿到 appID） */
+    appName: string;
+    /** 客户端编码 = OIDC client_id（后端 model.ApplicationClientEntity.Code，全局唯一；允许连字符） */
+    code: string;
+    name: string;
+    source: AppSource;
+    status: ApplicationClientStatus;
+    grantTypes: GrantType[];
+    tokenEndpointAuthMethod: TokenEndpointAuthMethod;
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface OAuthClientDetail extends OAuthClientItem {
+    tenantID: string;
+    redirectURIs: string[];
+    postLogoutRedirectURIs: string[];
+    backChannelLogoutURI: string;
+    responseTypes: string[];
+    allowedOrigins: string[];
+    /** 是否强制 PKCE（后端 model.ClientPKCEPolicy）：enable/disable。 */
+    requirePKCE: ClientPKCEPolicy;
+    /** 是否要求 id_token 带 auth_time（后端 model.ClientAuthTimeClaimPolicy）：enable/disable。 */
+    requireAuthTime: ClientAuthTimeClaimPolicy;
+    defaultScopes: string[];
+    accessTokenTTL: number;
+    refreshTokenTTL: number;
+}
+export interface OAuthClientCreateReq {
+    appID: string;
+    /** 客户端编码（= OIDC client_id）：小写字母开头，仅含小写字母与下划线（后端 model.ClientCodePattern）。 */
+    code: string;
+    name: string;
+    redirectURIs?: string[];
+    postLogoutRedirectURIs?: string[];
+    backChannelLogoutURI?: string;
+    grantTypes?: GrantType[];
+    responseTypes?: string[];
+    tokenEndpointAuthMethod?: TokenEndpointAuthMethod;
+    allowedOrigins?: string[];
+    /** 规则开关（后端具名类型 ClientPKCEPolicy）：enable/disable */
+    requirePKCE?: ClientPKCEPolicy;
+    requireAuthTime?: ClientAuthTimeClaimPolicy;
+    defaultScopes?: string[];
+    accessTokenTTL?: number;
+    refreshTokenTTL?: number;
+}
+export interface OAuthClientUpdateReq {
+    applicationClientID: string;
+    /** 客户端编码（= OIDC client_id，可改，留空不修改）：仅小写字母与下划线；内置客户端拒改。 */
+    code?: string;
+    name?: string;
+    status?: ApplicationClientStatus;
+    redirectURIs?: string[];
+    postLogoutRedirectURIs?: string[];
+    backChannelLogoutURI?: string;
+    grantTypes?: GrantType[];
+    responseTypes?: string[];
+    tokenEndpointAuthMethod?: TokenEndpointAuthMethod;
+    allowedOrigins?: string[];
+    /** 规则开关（后端具名类型 ClientPKCEPolicy）：enable/disable */
+    requirePKCE?: ClientPKCEPolicy;
+    requireAuthTime?: ClientAuthTimeClaimPolicy;
+    defaultScopes?: string[];
+    accessTokenTTL?: number;
+    refreshTokenTTL?: number;
+}
+export interface OAuthSecretItem {
+    id: string;
+    applicationClientID: string;
+    name: string;
+    valuePrefix: string;
+    expiresAt: number | null;
+    createdAt: number;
+}
+export interface OAuthSecretCreateResp {
+    id: string;
+    name: string;
+    valuePrefix: string;
+    secret: string;
+}
+export type TenantStatus = 'active' | 'suspended';
+/**
+ * 租户类型（后端具名类型 model.TenantType）：
+ * customer-客户租户 / platform-平台租户（分类标识，不参与隔离判定）。
+ */
+export type TenantType = 'customer' | 'platform';
+export interface TenantItem {
+    tenantID: string;
+    code: string;
+    dbUser: string;
+    name: string;
+    status: TenantStatus;
+    tag: string;
+    type: TenantType;
+    createdAt?: number;
+    updatedAt?: number;
+}
+/**
+ * 建租户时的内置管理员（必填）：建租户即产出可登录的租户管理员。
+ * 不含密码——初始临时密码由服务端生成并仅在创建响应返回一次（见
+ * docs/design/system-design.md §5.8）。
+ */
+export interface TenantAdminCreateReq {
+    name: string;
+    username?: string;
+    primaryEmail?: string;
+    primaryPhone?: string;
+}
+export interface TenantCreateReq {
+    name: string;
+    dbUser?: string;
+    status?: TenantStatus;
+    tag?: string;
+    type?: TenantType;
+    admin: TenantAdminCreateReq;
+}
+/**
+ * 建租户响应。adminInitialPassword 为空表示该管理员的邮箱/手机命中了已存在的自然人
+ * （其密码未被改动），此时不会回显任何凭据。
+ */
+export interface TenantCreateResp {
+    tenantID: string;
+    adminUserID: string;
+    adminInitialPassword: string;
+}
+/** 重置租户内置管理员密码响应：新临时密码仅此一次返回，该管理员下次登录必须改密。 */
+export interface TenantAdminResetPasswordResp {
+    userID: string;
+    initialPassword: string;
+}
+export interface TenantUpdateReq {
+    tenantID: string;
+    name?: string;
+    dbUser?: string;
+    status?: TenantStatus;
+    tag?: string;
+    type?: TenantType;
+}
+export interface TenantApplicationItem {
+    tenantAppID: string;
+    tenantID: string;
+    tenantName?: string;
+    appID: string;
+    appName?: string;
+    /**
+     * 所属应用来源（后端 model.AppSource）。builtin=订阅的是内置应用（平台管理后台/租户管理后台），
+     * 该订阅由系统开通（种子 / ProvisionTenantAdmin），不可删除——前端据此隐藏「删除」。
+     */
+    appSource?: AppSource;
+    status: TenantApplicationStatus;
+    /**
+     * 该租户下已准入（user_application.status=enable）本应用的成员数。
+     * 停用/删除订阅会让这些成员失去本应用访问，故用于确认文案回显「影响人数」。
+     */
+    grantedUserCount?: number;
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface TenantApplicationCreateReq {
+    tenantID: string;
+    appID: string;
+    status?: TenantApplicationStatus;
+}
+export interface TenantApplicationUpdateReq {
+    tenantAppID: string;
+    status?: TenantApplicationStatus;
+}
+export type MenuType = 'directory' | 'menu' | 'button';
+export type MenuStatus = 'enable' | 'disable';
+export type MenuVisibility = 'public' | 'member' | 'admin';
+/**
+ * 菜单展示开关（后端具名类型，取值 enable/disable；语义等价旧 0/1：1=enable / 0=disable）：
+ * MenuHiddenFlag / MenuExternalLinkFlag / MenuKeepAliveFlag。
+ */
+export type MenuHiddenFlag = 'enable' | 'disable';
+export type MenuExternalLinkFlag = 'enable' | 'disable';
+export type MenuKeepAliveFlag = 'enable' | 'disable';
+export interface MenuItem {
+    menuID: string;
+    appID: string;
+    parentID: string;
+    name: string;
+    code: string;
+    path: string;
+    icon: string;
+    sort: number;
+    type: MenuType;
+    visibility?: MenuVisibility;
+    component: string;
+    redirect: string;
+    /** 是否隐藏（后端 model.MenuHiddenFlag）：enable/disable */
+    hidden: MenuHiddenFlag;
+    /** 是否外链（后端 model.MenuExternalLinkFlag）：enable/disable */
+    externalLink: MenuExternalLinkFlag;
+    /** 是否缓存（后端 model.MenuKeepAliveFlag）：enable/disable */
+    keepAlive: MenuKeepAliveFlag;
+    status: MenuStatus;
+    createdAt?: number;
+    updatedAt?: number;
+    children?: MenuItem[];
+}
+export interface MenuTreeResp {
+    list: MenuItem[];
+}
+export interface MenuMyTreeResp {
+    list: MenuItem[];
+}
+/** 域名验证状态（后端具名类型 model.DomainVerificationStatus）：unverified/verified。 */
+export type DomainVerificationStatus = 'unverified' | 'verified';
+export interface DomainItem {
+    id: string;
+    domain: string;
+    /** 验证状态（后端 domain.verification_status）；后端 verified_at 已下线，不再回传验证时间。 */
+    verificationStatus: DomainVerificationStatus;
+    createdAt: number;
+    updatedAt: number;
+}
+/** 连接器协议（后端具名类型 model.ConnectorProtocol）。 */
+export type ConnectorProtocol = 'oidc' | 'oauth2';
+/** 连接器身份提供商（后端具名类型 model.ConnectorProvider）。 */
+export type ConnectorProvider = 'google' | 'github' | 'microsoft' | 'wechat';
+/** 连接器能力（后端具名类型 model.ConnectorCapability）。 */
+export type ConnectorCapability = 'authorize' | 'callback' | 'claim_mapping' | 'domain_policy' | 'profile_sync';
+/**
+ * 连接器开关（后端具名类型，取值 enable/disable；语义等价旧 bool：true=enable / false=disable）：
+ * ConnectorAutoCreateUserFlag / ConnectorAccountLinkFlag / ConnectorSyncProfileFlag / ConnectorTokenStorageFlag。
+ */
+export type ConnectorAutoCreateUserFlag = 'enable' | 'disable';
+export type ConnectorAccountLinkFlag = 'enable' | 'disable';
+export type ConnectorSyncProfileFlag = 'enable' | 'disable';
+export type ConnectorTokenStorageFlag = 'enable' | 'disable';
+export interface ConnectorItem {
+    connectorID: string;
+    tenantID: string;
+    name: string;
+    displayName: string;
+    protocol: ConnectorProtocol;
+    provider: ConnectorProvider;
+    status: ConnectorStatus;
+    allowAutoCreateUser: ConnectorAutoCreateUserFlag;
+    allowAccountLink: ConnectorAccountLinkFlag;
+    syncProfile: ConnectorSyncProfileFlag;
+    enableTokenStorage: ConnectorTokenStorageFlag;
+    config?: unknown;
+    claimMapping?: unknown;
+    domainPolicy?: unknown;
+    createdAt?: number;
+}
+export interface ConnectorFactoryItem {
+    factoryID: string;
+    protocol: ConnectorProtocol;
+    provider: ConnectorProvider;
+    displayName: string;
+    isStandard: boolean;
+    defaultScopes: string[];
+    capabilities: ConnectorCapability[];
+    configSchema?: unknown;
+}

package/dist/_types/types/response.d.ts

@@ -0,0 +1,14 @@
+export interface ApiResponse<T> {
+    code: number;
+    msg: string;
+    data: T;
+}
+export declare enum BizCode {
+    Success = 0,
+    Unauthorized = 110000,
+    Forbidden = 110001,
+    TokenInvalid = 110002,
+    TokenExpired = 110003,
+    PermissionDenied = 110004,
+    ParamInvalid = 100104
+}

package/dist/_types/types/tenant.d.ts

@@ -0,0 +1,243 @@
+import type { UserDepartmentItem } from './department';
+import type { AppStatus, MenuItem, SysAdminType } from './platform';
+/**
+ * 租户成员可用性（后端具名类型 model.UserStatus）：active-正常 / suspended-已挂起。
+ * 与 person 的 PersonStatus（auth.ts）刻意分列：两者是不同实体的生命周期。
+ */
+export type UserStatus = 'active' | 'suspended';
+/** 租户拥有者类型（后端具名类型 model.OwnerType）：owner-租户拥有者 / normal-普通成员。 */
+export type OwnerType = 'owner' | 'normal';
+export interface TenantUserItem {
+    userID: string;
+    tenantID: string;
+    username: string;
+    primaryEmail: string;
+    primaryPhone: string;
+    name: string;
+    avatar: string;
+    status: UserStatus;
+    primaryDepartmentName: string;
+    roleCount: number;
+    createdAt?: number;
+    updatedAt?: number;
+}
+/**
+ * 建成员入参。不含密码：初始临时密码由服务端生成、仅在创建响应返回一次，
+ * 且该成员首次登录必须改密（见 docs/design/system-design.md §5.8）。
+ */
+export interface TenantUserCreateReq {
+    personID?: string;
+    username?: string;
+    primaryEmail?: string;
+    primaryPhone?: string;
+    name: string;
+    avatar?: string;
+    /** 初始状态（后端 model.UserStatus）：缺省/空串按 active 落库。 */
+    status?: UserStatus;
+    primaryDepartmentID: string;
+    secondaryDepartmentIDs?: string[];
+    leaderDepartmentIDs?: string[];
+}
+/**
+ * 建成员响应。initialPassword 为空表示邮箱/手机命中了已存在的自然人（其密码未被改动），
+ * 此时不会回显任何凭据。
+ */
+export interface TenantUserCreateResp {
+    userID: string;
+    initialPassword: string;
+}
+/** 重置成员密码响应：新临时密码仅此一次返回，成员下次登录必须改密。 */
+export interface TenantUserResetPasswordResp {
+    userID: string;
+    initialPassword: string;
+}
+export interface TenantUserDepartmentUpdate {
+    username?: string;
+    primaryEmail?: string;
+    primaryPhone?: string;
+    primaryDepartmentID?: string;
+    secondaryDepartmentIDs?: string[];
+    leaderDepartmentIDs?: string[];
+}
+export interface TenantUserDetail extends TenantUserItem {
+    departments: UserDepartmentItem[];
+    roles: TenantUserRoleItem[];
+}
+export interface TenantUserRoleItem {
+    roleID: string;
+    appID: string;
+    appName: string;
+    name: string;
+    description: string;
+}
+export interface TenantUserIdentityItem {
+    userIdentityID: string;
+    issuer: string;
+    identityID: string;
+    detail?: unknown;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface TenantUserIdentityCreateReq {
+    userID: string;
+    issuer: string;
+    identityID: string;
+    detail?: unknown;
+}
+export interface TenantUserLoginLogItem {
+    userLoginLogID: string;
+    loginIP: string;
+    userAgent: string;
+    loginTime: number;
+}
+/**
+ * 租户已订阅且启用的应用（角色归属 / 菜单授权 / 应用准入的应用候选）。
+ * 接口：`GET /v1/tenant/applications`（原 `/tenant/apps` 已下线）。
+ */
+export interface TenantSubscribedApplicationItem {
+    appID: string;
+    code: string;
+    name: string;
+}
+/** 准入状态（后端具名类型 model.UserApplicationStatus）：撤销用 disable，行保留以备审计 */
+export type UserApplicationStatus = 'enable' | 'disable';
+/** 准入来源（后端具名类型 model.UserApplicationSource）：manual-手工分配 / role-角色授予自动补 / provision-引导写入 */
+export type UserApplicationSource = 'manual' | 'role' | 'provision';
+/**
+ * 用户视角的单个应用准入行。清单是「本租户订阅行 ∪ 该成员准入行」的并集：
+ * `subscribed`（租户已订阅且启用）/ `granted`（该成员已准入且启用）是两道门槛，
+ * 二者为真且 `appStatus === 'enable'` 才真正可用（后端判定式 CanUseApp）。
+ */
+export interface TenantUserApplicationItem {
+    appID: string;
+    code: string;
+    name: string;
+    appStatus: AppStatus;
+    subscribed: boolean;
+    granted: boolean;
+    /** 无准入行时为空串 */
+    status: UserApplicationStatus | '';
+    /** 无准入行时为空串 */
+    source: UserApplicationSource | '';
+    /** 该成员在此应用下的角色数：撤销准入会级联撤销这些角色绑定，用于二次确认文案 */
+    roleCount: number;
+    updatedAt: number;
+}
+/** 用户应用准入清单（含未准入的订阅应用，供 UI 呈现全集与选中态） */
+export interface TenantUserApplicationsListResp {
+    list: TenantUserApplicationItem[];
+}
+/** 应用视角的被准入成员行（仅含已准入成员） */
+export interface TenantApplicationUserItem {
+    userID: string;
+    /** 账号类型（后端具名类型 model.UserType）：member-真实用户 / machine-服务账号 */
+    userType: 'member' | 'machine';
+    name: string;
+    username: string;
+    primaryEmail: string;
+    status: UserStatus;
+    source: UserApplicationSource;
+    roleCount: number;
+    updatedAt: number;
+}
+export interface TenantApplicationUsersListResp {
+    list: TenantApplicationUserItem[];
+    total: number;
+}
+export type RoleSource = 'builtin' | 'custom';
+export interface TenantRoleItem {
+    roleID: string;
+    appID: string;
+    appName: string;
+    /**
+     * 角色编码（后端具名类型 model.RoleCode）：跨系统授权契约值，即 OIDC ID token 的 `groups` 声明，
+     * 下游系统按「前缀 + 编码」认策略名，形状 `^[a-z][a-z0-9_]*$`。
+     *
+     * **只读**：取值来自应用角色模板（开通应用时物化到本租户，见 `ApplicationItem.roleTemplate`）或产品锚点；
+     * 租户自建角色不参与跨系统契约，该字段为空串。
+     */
+    code: string;
+    name: string;
+    description: string;
+    source?: RoleSource;
+    adminType: SysAdminType;
+    memberCount: number;
+    menuCount: number;
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface TenantRoleCreateReq {
+    appID: string;
+    name: string;
+    description?: string;
+}
+/** 角色全量更新入参（PUT，body 不含 roleID，path 是 ID 唯一来源）。 */
+export interface TenantRoleUpdateReq {
+    roleID: string;
+    name: string;
+    description?: string;
+}
+export interface TenantRoleMenuResp {
+    list: MenuItem[];
+    menuIDs: string[];
+}
+export interface TenantMachineUserItem {
+    machineUserID: string;
+    tenantID: string;
+    name: string;
+    description: string;
+    primaryDepartmentID: string;
+    primaryDepartmentName: string;
+    status: UserStatus;
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface TenantMachineUserDepartment {
+    departmentID: string;
+    departmentName: string;
+    relationType: 'primary' | 'secondary';
+}
+export interface TenantMachineUserDetail extends TenantMachineUserItem {
+    departments: TenantMachineUserDepartment[];
+    roles: TenantUserRoleItem[];
+}
+export interface TenantMachineUserCreateReq {
+    name: string;
+    description?: string;
+    primaryDepartmentID: string;
+    secondaryDepartmentIDs?: string[];
+}
+export interface TenantMachineUserUpdateReq {
+    machineUserID: string;
+    name: string;
+    description?: string;
+    primaryDepartmentID?: string | null;
+    secondaryDepartmentIDs?: string[] | null;
+}
+export type TenantApiKeyOwnerType = 'member' | 'machine';
+export interface TenantApiKeyItem {
+    keyID: string;
+    name: string;
+    keyPrefix: string;
+    ownerUserID: string;
+    ownerType: TenantApiKeyOwnerType;
+    ownerName: string;
+    createdBy: string;
+    creatorName: string;
+    expiredAt: number | null;
+    revokedAt: number | null;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface TenantApiKeyCreateReq {
+    name: string;
+    machineUserID: string;
+    expiredAt?: number;
+}
+export interface TenantApiKeyCreateResp {
+    id: string;
+    name: string;
+    key: string;
+    keyPrefix: string;
+    expiredAt: number;
+}

package/dist/_types/ui/AppShell.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+import 'dayjs/locale/zh-cn';
+interface Props {
+    children: ReactNode;
+}
+/**
+ * 应用外壳：注入 Ant Design 全局主题（中文语言包 + 设计令牌）。
+ * 每个前端 app 的 main.tsx 用 <AppShell> 包裹。
+ * 根容器开启 tabular-nums，让 ID/时间/数字等宽对齐（Stripe 数据细节，见 DESIGN.md）。
+ *
+ * 全局 antd「结构级」微修正也集中在此：AppShell 是各 app 唯一公共挂载点，
+ * 而这类修正针对 antd 内部 DOM / portal 渲染的下拉等，无法用组件 inline style 表达
+ * （约定与清单见 DESIGN.md §7.1）。禁止各 app 新增 css 文件或在页面散落重复 <style>。
+ */
+export declare function AppShell({ children }: Props): import("react").JSX.Element;
+export {};

package/dist/_types/ui/EllipsisCell.d.ts

@@ -0,0 +1,16 @@
+export interface EllipsisCellProps {
+    /** 文本内容；空值展示为 placeholder */
+    value?: string | number | null;
+    /** 展示前先截断到该字符数（仅影响展示，悬浮提示仍为完整内容） */
+    limit?: number;
+    /** 使用等宽字体 */
+    monospace?: boolean;
+    /** 空值占位文案，默认 `-` */
+    placeholder?: string;
+}
+/**
+ * 可能展示不全的文本单元格：
+ * - 超出单元格宽度即省略号截断
+ * - 鼠标悬浮展示完整内容（可拖选直接复制）
+ */
+export declare function EllipsisCell({ value, limit, monospace, placeholder }: EllipsisCellProps): import("react").JSX.Element;

package/dist/_types/ui/IDCell.d.ts

@@ -0,0 +1,14 @@
+export interface IDCellProps {
+    /** ID 值；空值展示为 - */
+    value?: string | number | null;
+    /** 保留的前缀长度，默认 8 */
+    prefix?: number;
+    /** 保留的后缀长度，默认 4 */
+    suffix?: number;
+}
+/**
+ * 长 ID 单元格（UUID v7 等）：
+ * - 默认仅展示首尾片段，如 `0190e2a4…c3d4`
+ * - 鼠标悬浮展示完整 ID（可拖选直接复制，无独立复制按钮）
+ */
+export declare function IDCell({ value, prefix, suffix }: IDCellProps): import("react").JSX.Element;

package/dist/_types/ui/InitialPasswordModal.d.ts

@@ -0,0 +1,18 @@
+export interface InitialPasswordModalProps {
+    /**
+     * 一次性初始/临时密码明文。为空表示未生成（如复用了既有自然人，其密码未被改动），
+     * 此时 Modal 不展示。
+     */
+    password: string;
+    /** 弹窗标题，默认「初始密码已生成」。 */
+    title?: string;
+    /** 密码上方的补充说明（如「该成员首次登录必须修改密码」）。 */
+    description?: string;
+    onClose: () => void;
+}
+/**
+ * 一次性初始密码展示 Modal：密码由服务端生成、仅在本次响应返回一次，关闭后不可再查。
+ * 平台侧（建租户/重置内置管理员密码）与租户侧（建成员/重置成员密码）共用同一交互，
+ * 保证两边"密码相关交互一致"（见 docs/design/system-design.md §5.8）。
+ */
+export declare function InitialPasswordModal({ password, title, description, onClose }: InitialPasswordModalProps): import("react").JSX.Element;

package/dist/_types/ui/LoginPage.d.ts

@@ -0,0 +1,6 @@
+interface Props {
+    title: string;
+    subtitle?: string;
+}
+export declare function LoginPage({ title, subtitle }: Props): import("react").JSX.Element;
+export {};