@pactor-app/ui 0.1.0

package/dist/layout/index.d.cts

@@ -0,0 +1,158 @@
+import { PermissionChecker } from '@pactor-app/permission';
+import { MenuRegistry, NavigationBridge, RouteContext, MenuItem } from '@pactor-app/router';
+import * as React from 'react';
+import { ReactNode, ComponentType } from 'react';
+import { Registry } from '@pactor-app/core';
+
+/** 结构模式（管理后台外壳布局形态） */
+type AdminLayoutMode = 
+/** 顶部 header + 下方 sidebar/content（缺省） */
+'top-side'
+/** 上-中-下：header + content + footer，无 sidebar */
+ | 'top-bottom'
+/** 通栏侧边：sidebar 全高居左（含品牌区），header+content 居右 */
+ | 'side-full'
+/** 侧边两列：一级菜单窄列 + 当前一级菜单的子菜单列 */
+ | 'two-column';
+/** 响应式断点（视口小于断点时 sidebar 自动收起） */
+type AdminLayoutBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+/** 布局配置（bootstrap.layout 透传；缺省：header/sidebar 开，tabs/breadcrumb/footer 关，mode top-side） */
+interface AdminLayoutConfig {
+    header?: boolean;
+    sidebar?: boolean;
+    tabs?: boolean;
+    breadcrumb?: boolean;
+    footer?: boolean;
+    /** 结构模式，缺省 'top-side' */
+    mode?: AdminLayoutMode;
+    /** 固定顶部（内容区独立滚动），缺省 true；显式 false 关闭 */
+    fixedHeader?: boolean;
+    /** 固定侧边栏（sidebar 自身滚动，不随内容区），缺省 true；显式 false 关闭 */
+    fixedSider?: boolean;
+    /** sidebar 收起/展开 trigger */
+    collapsible?: boolean;
+    /** 初始收起（仅 collapsible 时有意义） */
+    collapsed?: boolean;
+    /** 视口小于断点时 sidebar 自动收起 */
+    breakpoint?: AdminLayoutBreakpoint;
+}
+/** 品牌区 */
+interface AdminBrand {
+    title: string;
+    logo?: ReactNode;
+}
+/**
+ * AdminLayout props（设计决策 D1）。
+ *
+ * `route` 优先用于选中态（测试友好）；未传时内部订阅 bridge
+ * 自行 resolveRoute（生产用法）。
+ */
+interface AdminLayoutProps {
+    config?: AdminLayoutConfig;
+    brand: AdminBrand;
+    registry: MenuRegistry;
+    bridge: NavigationBridge;
+    route?: RouteContext;
+    permissionChecker?: PermissionChecker;
+    headerExtra?: ReactNode;
+    children?: ReactNode;
+}
+interface BlankLayoutProps {
+    children?: ReactNode;
+}
+/** 登录页品牌区 */
+interface LoginBrand {
+    title: string;
+    logo?: ReactNode;
+    description?: ReactNode;
+}
+interface LoginLayoutProps {
+    /** center：居中卡片；split：左品牌右表单（缺省 center） */
+    variant?: 'center' | 'split';
+    brand: LoginBrand;
+    children?: ReactNode;
+}
+interface LandingLayoutProps {
+    /** 顶部导航插槽 */
+    navbar?: ReactNode;
+    /** 底部插槽 */
+    footer?: ReactNode;
+    children?: ReactNode;
+}
+
+/**
+ * 菜单链（设计决策 D2）：沿可见树查找 menuId 的父链，
+ * 返回从顶层到目标项的 MenuItem 数组（含目标项自身），供 Breadcrumb 渲染。
+ * 未命中返回空数组。
+ */
+declare function findMenuChain(registry: MenuRegistry, menuId: string): MenuItem[];
+
+/**
+ * 收集默认展开的 group id。
+ *
+ * 包含两类：
+ * - 声明了 `defaultOpen: true` 的 group；
+ * - 当前激活菜单（activeMenuId）父链上的 group——刷新 / 直达子页面时，
+ *   选中项所在分组必须展开，否则高亮项不可见（菜单"没有展开"）。
+ */
+declare function collectDefaultOpenKeys(registry: MenuRegistry, activeMenuId?: string): string[];
+
+/**
+ * ShadcnAdminLayout：与 pactor-layout 的 AdminLayout（antd 版）契约一致——
+ * 复用 `AdminLayoutProps`；Header（brand + headerExtra）/ Sidebar / 内容出口；
+ * config 开关（header/sidebar 缺省开，tabs/breadcrumb/footer 缺省关）一致；
+ * mode（top-side/top-bottom/side-full/two-column）、fixedHeader/fixedSider、
+ * collapsible/collapsed、breakpoint 响应式收起与 antd 版语义一致。
+ * 菜单由 MenuRegistry 可见树渲染（group 折叠经 vendored shadcn Accordion），
+ * permissionChecker 过滤、activeMenu 高亮、page → bridge.push、
+ * link/external → window.open；Breadcrumb 按菜单链；Tabs 访问页签
+ * （去重、点击导航、关闭当前回退最后一个）。route props 优先、
+ * bridge 订阅兜底的选中态来源与 antd 版一致。
+ *
+ * 样式：Tailwind 工具类读取 shadcn 语义令牌（bg-background / border-border /
+ * text-muted-foreground …），结构钩子用 data-slot 属性。
+ */
+declare function ShadcnAdminLayout({ config, brand, registry, bridge, route: routeProp, permissionChecker, headerExtra, children, }: AdminLayoutProps): React.JSX.Element;
+
+/**
+ * ShadcnBlankLayout：与 pactor-layout 的 BlankLayout（antd 版）契约一致——
+ * 无壳布局，直接渲染 children（带最小页面容器样式）。
+ */
+declare function ShadcnBlankLayout({ children }: BlankLayoutProps): React.JSX.Element;
+
+/**
+ * ShadcnLoginLayout：与 pactor-layout 的 LoginLayout（antd 版）契约一致——
+ * 登录页外壳，只负责品牌区与表单出口的布局，不含任何认证逻辑。
+ * variant center：居中卡片（vendored shadcn Card）；split：左品牌右表单
+ * （缺省 center）。
+ */
+declare function ShadcnLoginLayout({ variant, brand, children, }: LoginLayoutProps): React.JSX.Element;
+
+/**
+ * ShadcnLandingLayout：与 pactor-layout 的 LandingLayout（antd 版）契约一致——
+ * 落地页外壳，可选 navbar / footer 插槽，children 为主内容区。
+ */
+declare function ShadcnLandingLayout({ navbar, footer, children, }: LandingLayoutProps): React.JSX.Element;
+
+/** 布局组件类型（各布局 props 不同，注册表按通用组件存储） */
+type LayoutComponent = ComponentType<any>;
+/** LayoutRegistry：布局类型名 → 布局组件（复用 core Registry） */
+type LayoutRegistry = Registry<LayoutComponent>;
+/**
+ * registerShadcnLayouts：向 LayoutRegistry 注册 shadcn 实现的四种布局
+ * （类型名：admin / blank / login / landing）。
+ */
+declare function registerShadcnLayouts(registry: LayoutRegistry): void;
+/**
+ * createShadcnLayoutRegistry（设计决策 D5）：预注册 shadcn 版
+ * admin / blank / login / landing 四种布局组件。
+ * 业务可继续 register 自定义布局类型。
+ */
+declare function createShadcnLayoutRegistry(): LayoutRegistry;
+/**
+ * resolveLayout（设计决策 D5）：按类型名解析布局组件；
+ * 未命中返回 ShadcnBlankLayout 并 console.warn（不抛错，不崩页面）。
+ */
+declare function resolveLayout(registry: LayoutRegistry, type: string): LayoutComponent;
+
+export { type AdminBrand, type AdminLayoutBreakpoint, type AdminLayoutConfig, type AdminLayoutMode, type AdminLayoutProps, type BlankLayoutProps, type LandingLayoutProps, type LayoutComponent, type LayoutRegistry, type LoginBrand, type LoginLayoutProps, ShadcnAdminLayout, ShadcnBlankLayout, ShadcnLandingLayout, ShadcnLoginLayout, collectDefaultOpenKeys, createShadcnLayoutRegistry, findMenuChain, registerShadcnLayouts, resolveLayout };

package/dist/layout/index.d.ts

@@ -0,0 +1,158 @@
+import { PermissionChecker } from '@pactor-app/permission';
+import { MenuRegistry, NavigationBridge, RouteContext, MenuItem } from '@pactor-app/router';
+import * as React from 'react';
+import { ReactNode, ComponentType } from 'react';
+import { Registry } from '@pactor-app/core';
+
+/** 结构模式（管理后台外壳布局形态） */
+type AdminLayoutMode = 
+/** 顶部 header + 下方 sidebar/content（缺省） */
+'top-side'
+/** 上-中-下：header + content + footer，无 sidebar */
+ | 'top-bottom'
+/** 通栏侧边：sidebar 全高居左（含品牌区），header+content 居右 */
+ | 'side-full'
+/** 侧边两列：一级菜单窄列 + 当前一级菜单的子菜单列 */
+ | 'two-column';
+/** 响应式断点（视口小于断点时 sidebar 自动收起） */
+type AdminLayoutBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+/** 布局配置（bootstrap.layout 透传；缺省：header/sidebar 开，tabs/breadcrumb/footer 关，mode top-side） */
+interface AdminLayoutConfig {
+    header?: boolean;
+    sidebar?: boolean;
+    tabs?: boolean;
+    breadcrumb?: boolean;
+    footer?: boolean;
+    /** 结构模式，缺省 'top-side' */
+    mode?: AdminLayoutMode;
+    /** 固定顶部（内容区独立滚动），缺省 true；显式 false 关闭 */
+    fixedHeader?: boolean;
+    /** 固定侧边栏（sidebar 自身滚动，不随内容区），缺省 true；显式 false 关闭 */
+    fixedSider?: boolean;
+    /** sidebar 收起/展开 trigger */
+    collapsible?: boolean;
+    /** 初始收起（仅 collapsible 时有意义） */
+    collapsed?: boolean;
+    /** 视口小于断点时 sidebar 自动收起 */
+    breakpoint?: AdminLayoutBreakpoint;
+}
+/** 品牌区 */
+interface AdminBrand {
+    title: string;
+    logo?: ReactNode;
+}
+/**
+ * AdminLayout props（设计决策 D1）。
+ *
+ * `route` 优先用于选中态（测试友好）；未传时内部订阅 bridge
+ * 自行 resolveRoute（生产用法）。
+ */
+interface AdminLayoutProps {
+    config?: AdminLayoutConfig;
+    brand: AdminBrand;
+    registry: MenuRegistry;
+    bridge: NavigationBridge;
+    route?: RouteContext;
+    permissionChecker?: PermissionChecker;
+    headerExtra?: ReactNode;
+    children?: ReactNode;
+}
+interface BlankLayoutProps {
+    children?: ReactNode;
+}
+/** 登录页品牌区 */
+interface LoginBrand {
+    title: string;
+    logo?: ReactNode;
+    description?: ReactNode;
+}
+interface LoginLayoutProps {
+    /** center：居中卡片；split：左品牌右表单（缺省 center） */
+    variant?: 'center' | 'split';
+    brand: LoginBrand;
+    children?: ReactNode;
+}
+interface LandingLayoutProps {
+    /** 顶部导航插槽 */
+    navbar?: ReactNode;
+    /** 底部插槽 */
+    footer?: ReactNode;
+    children?: ReactNode;
+}
+
+/**
+ * 菜单链（设计决策 D2）：沿可见树查找 menuId 的父链，
+ * 返回从顶层到目标项的 MenuItem 数组（含目标项自身），供 Breadcrumb 渲染。
+ * 未命中返回空数组。
+ */
+declare function findMenuChain(registry: MenuRegistry, menuId: string): MenuItem[];
+
+/**
+ * 收集默认展开的 group id。
+ *
+ * 包含两类：
+ * - 声明了 `defaultOpen: true` 的 group；
+ * - 当前激活菜单（activeMenuId）父链上的 group——刷新 / 直达子页面时，
+ *   选中项所在分组必须展开，否则高亮项不可见（菜单"没有展开"）。
+ */
+declare function collectDefaultOpenKeys(registry: MenuRegistry, activeMenuId?: string): string[];
+
+/**
+ * ShadcnAdminLayout：与 pactor-layout 的 AdminLayout（antd 版）契约一致——
+ * 复用 `AdminLayoutProps`；Header（brand + headerExtra）/ Sidebar / 内容出口；
+ * config 开关（header/sidebar 缺省开，tabs/breadcrumb/footer 缺省关）一致；
+ * mode（top-side/top-bottom/side-full/two-column）、fixedHeader/fixedSider、
+ * collapsible/collapsed、breakpoint 响应式收起与 antd 版语义一致。
+ * 菜单由 MenuRegistry 可见树渲染（group 折叠经 vendored shadcn Accordion），
+ * permissionChecker 过滤、activeMenu 高亮、page → bridge.push、
+ * link/external → window.open；Breadcrumb 按菜单链；Tabs 访问页签
+ * （去重、点击导航、关闭当前回退最后一个）。route props 优先、
+ * bridge 订阅兜底的选中态来源与 antd 版一致。
+ *
+ * 样式：Tailwind 工具类读取 shadcn 语义令牌（bg-background / border-border /
+ * text-muted-foreground …），结构钩子用 data-slot 属性。
+ */
+declare function ShadcnAdminLayout({ config, brand, registry, bridge, route: routeProp, permissionChecker, headerExtra, children, }: AdminLayoutProps): React.JSX.Element;
+
+/**
+ * ShadcnBlankLayout：与 pactor-layout 的 BlankLayout（antd 版）契约一致——
+ * 无壳布局，直接渲染 children（带最小页面容器样式）。
+ */
+declare function ShadcnBlankLayout({ children }: BlankLayoutProps): React.JSX.Element;
+
+/**
+ * ShadcnLoginLayout：与 pactor-layout 的 LoginLayout（antd 版）契约一致——
+ * 登录页外壳，只负责品牌区与表单出口的布局，不含任何认证逻辑。
+ * variant center：居中卡片（vendored shadcn Card）；split：左品牌右表单
+ * （缺省 center）。
+ */
+declare function ShadcnLoginLayout({ variant, brand, children, }: LoginLayoutProps): React.JSX.Element;
+
+/**
+ * ShadcnLandingLayout：与 pactor-layout 的 LandingLayout（antd 版）契约一致——
+ * 落地页外壳，可选 navbar / footer 插槽，children 为主内容区。
+ */
+declare function ShadcnLandingLayout({ navbar, footer, children, }: LandingLayoutProps): React.JSX.Element;
+
+/** 布局组件类型（各布局 props 不同，注册表按通用组件存储） */
+type LayoutComponent = ComponentType<any>;
+/** LayoutRegistry：布局类型名 → 布局组件（复用 core Registry） */
+type LayoutRegistry = Registry<LayoutComponent>;
+/**
+ * registerShadcnLayouts：向 LayoutRegistry 注册 shadcn 实现的四种布局
+ * （类型名：admin / blank / login / landing）。
+ */
+declare function registerShadcnLayouts(registry: LayoutRegistry): void;
+/**
+ * createShadcnLayoutRegistry（设计决策 D5）：预注册 shadcn 版
+ * admin / blank / login / landing 四种布局组件。
+ * 业务可继续 register 自定义布局类型。
+ */
+declare function createShadcnLayoutRegistry(): LayoutRegistry;
+/**
+ * resolveLayout（设计决策 D5）：按类型名解析布局组件；
+ * 未命中返回 ShadcnBlankLayout 并 console.warn（不抛错，不崩页面）。
+ */
+declare function resolveLayout(registry: LayoutRegistry, type: string): LayoutComponent;
+
+export { type AdminBrand, type AdminLayoutBreakpoint, type AdminLayoutConfig, type AdminLayoutMode, type AdminLayoutProps, type BlankLayoutProps, type LandingLayoutProps, type LayoutComponent, type LayoutRegistry, type LoginBrand, type LoginLayoutProps, ShadcnAdminLayout, ShadcnBlankLayout, ShadcnLandingLayout, ShadcnLoginLayout, collectDefaultOpenKeys, createShadcnLayoutRegistry, findMenuChain, registerShadcnLayouts, resolveLayout };

package/dist/layout/index.js

@@ -0,0 +1,25 @@
+import {
+  ShadcnAdminLayout,
+  ShadcnBlankLayout,
+  ShadcnLandingLayout,
+  ShadcnLoginLayout,
+  collectDefaultOpenKeys,
+  createShadcnLayoutRegistry,
+  findMenuChain,
+  registerShadcnLayouts,
+  resolveLayout
+} from "../chunk-DMK6RSTK.js";
+import "../chunk-SNFDI77B.js";
+import "../chunk-57NRUZ5G.js";
+import "../chunk-RQHJBTEU.js";
+export {
+  ShadcnAdminLayout,
+  ShadcnBlankLayout,
+  ShadcnLandingLayout,
+  ShadcnLoginLayout,
+  collectDefaultOpenKeys,
+  createShadcnLayoutRegistry,
+  findMenuChain,
+  registerShadcnLayouts,
+  resolveLayout
+};