@fudanda/admin-antd 0.0.0-stage → 2.20261024.1-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 iwangbowen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @fudanda/admin-antd
+
+Ant Design implementation of the ArcBase admin, with the same props, paths,
+permissions and module contracts as `@fudanda/admin`.
+
+```tsx
+import {ArcBaseAdmin} from '@fudanda/admin-antd';
+import '@fudanda/admin-antd/styles.css';
+import { GoaClient } from '@fudanda/client';
+import { createRoot } from 'react-dom/client';
+
+const client = new GoaClient();
+const root = createRoot(document.getElementById('root')!);
+root.render(
+  <ArcBaseAdmin client={client} basePath="/dash"
+    assetBasePath="/dash/arcbase-assets/" />,
+);
+```
+
+Keep `client`, `authSession`, and a supplied dedicated `queryClient` stable while
+mounted. The admin restores Cookie sessions through `/api/v1/auth/me`; CSRF stays
+in the client. A host-owned `authSession` must be started by the host and implements
+`login(input): Promise<LoginResult>`, `resolveSessionConflict(ticket)`, and awaited
+`logout(): Promise<void>`. Its lifecycle matches [Elements](../elements/README.md).
+
+Host pages use generated Goa descriptors with `client.call(operation, input)`.
+Results are native DTOs; 201 creates return the created entity and 204 mutations
+return `undefined`. `GoaError` exposes HTTP status and the complete native error
+body in `details`. See [React Core](../react-core/README.md) for query examples.
+
+Copy `dist/public` to your `assetBasePath` and `dist/file-viewer` to `/dash/file-viewer`.
+Import `createAutomationAdminModule` from `/automation` when the host mounts the
+automation backend. The canvas and its Semi styles load when opening a designer.
+Provide Ant Design components for your own module pages; host JSX is not converted.
+
+Dependencies are pinned to Ant Design 6.6.5 and Pro Components 3.1.15-6, with React 19.
+Dayjs is a shared host dependency so calendar locale changes reach Ant Design.
+
+The shell is adapted from Condor Hero's `react-antd-admin` layout: fixed sidebar,
+48px header, independent tabbar, scrolling content and mobile drawer. Four navigation
+layouts reuse ArcBase preferences, permissions and tab/cache state. Upstream license
+attribution is included in `THIRD_PARTY_NOTICES.md`.
+
+Tables use the `BasicTable` adapted from the same project: ProTable card and toolbar,
+native search forms, refresh, density, column visibility/order/pinning, fullscreen,
+page height fitting, and pagination defaults. `buildTableSearch` connects declared
+filters and business actions to ProTable; it does not add a second request layer.
+ArcBase retains controlled TanStack
+Query data, permissions, column/display preferences and bulk actions. Embedded
+tables keep their natural size; an explicit `scroll.y` overrides height fitting.
+
+OverlayScrollbars 2.16.0 and its React wrapper 0.5.6 style the shell, navigation
+and preference scroll areas. The SDK includes their JavaScript and CSS. Import
+the usual `styles.css`; scrollbar colors follow the local Ant Design theme.
+
+## 表格组件
+
+业务扩展可从 `@fudanda/admin-antd` 导入 `BasicTable` 和 `BasicTableProps`。组件使用原生 ProTable 的搜索表单、刷新、密度、列设置和全屏工具，支持 OverlayScrollbars 与 `adaptive` 高度。通过领域 Query hooks 提供受控 `dataSource`、`loading` 和分页；仅在 `onSubmit` 时提交搜索草稿，`onReset` 清空已提交条件。以 `columnsState` 保存表格列偏好。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,55 @@
+# Third-party notices
+
+The Ant Design admin layout and BasicTable include code adapted from Condor Hero's
+`react-antd-admin` (local checkout commit `9283fa021c7362676696fb7116715e69a60c2742`).
+Source: https://github.com/condorheroblog/react-antd-admin
+
+## react-antd-admin
+
+MIT License
+
+Copyright (c) 2023-PRESENT CondorHero<https://github.com/condorheroblog>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## OverlayScrollbars 2.16.0 and overlayscrollbars-react 0.5.6
+
+Source: https://github.com/KingSora/OverlayScrollbars
+
+MIT License
+
+Copyright (c) 2022 Rene Haas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.