@antscorp/antsomi-ui 1.3.7-beta.70 → 1.3.7-beta.71

package/README.md

@@ -1,78 +1,148 @@
-<p align="center">
-  <a href="https://ant.design">
-    <img width="200" src="https://st-home.antsomi.com/wp-content/uploads/2020/04/Antsomi-CDP-365-logo.png">
-  </a>
-</p>
-
-<h1 align="center">Antsomi UI</h1>
-
-<div align="center">
-
-An enterprise-class UI design language and React UI library.
-
-[![NPM version][npm-image]][npm-url] [![NPM downloads][download-image]][download-url] [![][bundlephobia-image]][bundlephobia-url]
-
-[npm-image]: https://img.shields.io/npm/v/@antscorp/antsomi-ui.svg?style=flat-square
-[npm-url]: https://www.npmjs.com/package/@antscorp/antsomi-ui
-[github-action-image]: https://github.com/ant-design/ant-design/workflows/%E2%9C%85%20test/badge.svg
-[github-action-url]: https://github.com/ant-design/ant-design/actions?query=workflow%3A%22%E2%9C%85+test%22
-[codecov-image]: https://img.shields.io/codecov/c/github/ant-design/ant-design/master.svg?style=flat-square
-[codecov-url]: https://codecov.io/gh/ant-design/ant-design/branch/master
-[download-image]: https://img.shields.io/npm/dm/@antscorp/antsomi-ui.svg?style=flat-square
-[download-url]: https://npmjs.org/package/antd
-[fossa-image]: https://app.fossa.io/api/projects/git%2Bgithub.com%2Fant-design%2Fant-design.svg?type=shield
-[fossa-url]: https://app.fossa.io/projects/git%2Bgithub.com%2Fant-design%2Fant-design?ref=badge_shield
-[help-wanted-image]: https://flat.badgen.net/github/label-issues/ant-design/ant-design/help%20wanted/open
-[help-wanted-url]: https://github.com/ant-design/ant-design/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22
-[twitter-image]: https://img.shields.io/twitter/follow/AntDesignUI.svg?label=Ant%20Design
-[twitter-url]: https://twitter.com/AntDesignUI
-[bundlesize-js-image]: https://img.badgesize.io/https:/unpkg.com/antd/dist/antd.min.js?label=antd.min.js&compression=gzip&style=flat-square
-[unpkg-js-url]: https://unpkg.com/browse/antd/dist/antd.min.js
-[bundlephobia-image]: https://badgen.net/bundlephobia/minzip/antd?style=flat-square
-[bundlephobia-url]: https://bundlephobia.com/package/@antscorp/antsomi-ui
-[issues-helper-image]: https://img.shields.io/badge/using-issues--helper-orange?style=flat-square
-[issues-helper-url]: https://github.com/actions-cool/issues-helper
-[renovate-image]: https://img.shields.io/badge/renovate-enabled-brightgreen.svg?style=flat-square
-[renovate-dashboard-url]: https://github.com/ant-design/ant-design/issues/32498
-[dumi-image]: https://img.shields.io/badge/docs%20by-dumi-blue?style=flat-square
-[dumi-url]: https://github.com/umijs/dumi
-
-</div>
-
-[![](https://st-media-template.antsomi.com/upload/2023/03/22/9d157c08-5f33-4b60-a558-1da9dde42d61.png)](https://antsomi-docs.vercel.app/)
-
-## ✨ Features
-
-- 🌈 Enterprise-class UI designed for web applications.
-- 📦 A set of high-quality React components out of the box.
-- 🛡 Written in TypeScript with predictable static types.
-- ⚙️ Whole package of design resources and development tools.
-- 🌍 Internationalization support for dozens of languages.
-- 🎨 Powerful theme customization based on CSS-in-JS.
-
-## 📦 Install
-
-```bash
-npm install @antscorp/antsomi-ui
-```
-
-```bash
-yarn add @antscorp/antsomi-ui
-```
-
-## 🔨 Usage
-
-```jsx
-import React from 'react';
-import { Button } from '@antscorp/antsomi-ui';
-
-const App = () => (
-  <>
-    <Button type="primary">Click me</Button>
-  </>
-);
-```
-
-### TypeScript
-
-`@antscorp/antsomi-ui` is written in TypeScript with complete definitions.
+<p align="center">
+  <a href="https://ant.design">
+    <img width="200" src="https://st-home.antsomi.com/wp-content/uploads/2020/04/Antsomi-CDP-365-logo.png">
+  </a>
+</p>
+
+<h1 align="center">Antsomi UI</h1>
+
+<div align="center">
+
+An enterprise-class UI design language and React UI library.
+
+[![NPM version][npm-image]][npm-url] [![NPM downloads][download-image]][download-url] [![][bundlephobia-image]][bundlephobia-url]
+
+[npm-image]: https://img.shields.io/npm/v/@antscorp/antsomi-ui.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@antscorp/antsomi-ui
+[github-action-image]: https://github.com/ant-design/ant-design/workflows/%E2%9C%85%20test/badge.svg
+[github-action-url]: https://github.com/ant-design/ant-design/actions?query=workflow%3A%22%E2%9C%85+test%22
+[codecov-image]: https://img.shields.io/codecov/c/github/ant-design/ant-design/master.svg?style=flat-square
+[codecov-url]: https://codecov.io/gh/ant-design/ant-design/branch/master
+[download-image]: https://img.shields.io/npm/dm/@antscorp/antsomi-ui.svg?style=flat-square
+[download-url]: https://npmjs.org/package/antd
+[fossa-image]: https://app.fossa.io/api/projects/git%2Bgithub.com%2Fant-design%2Fant-design.svg?type=shield
+[fossa-url]: https://app.fossa.io/projects/git%2Bgithub.com%2Fant-design%2Fant-design?ref=badge_shield
+[help-wanted-image]: https://flat.badgen.net/github/label-issues/ant-design/ant-design/help%20wanted/open
+[help-wanted-url]: https://github.com/ant-design/ant-design/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22
+[twitter-image]: https://img.shields.io/twitter/follow/AntDesignUI.svg?label=Ant%20Design
+[twitter-url]: https://twitter.com/AntDesignUI
+[bundlesize-js-image]: https://img.badgesize.io/https:/unpkg.com/antd/dist/antd.min.js?label=antd.min.js&compression=gzip&style=flat-square
+[unpkg-js-url]: https://unpkg.com/browse/antd/dist/antd.min.js
+[bundlephobia-image]: https://badgen.net/bundlephobia/minzip/antd?style=flat-square
+[bundlephobia-url]: https://bundlephobia.com/package/@antscorp/antsomi-ui
+[issues-helper-image]: https://img.shields.io/badge/using-issues--helper-orange?style=flat-square
+[issues-helper-url]: https://github.com/actions-cool/issues-helper
+[renovate-image]: https://img.shields.io/badge/renovate-enabled-brightgreen.svg?style=flat-square
+[renovate-dashboard-url]: https://github.com/ant-design/ant-design/issues/32498
+[dumi-image]: https://img.shields.io/badge/docs%20by-dumi-blue?style=flat-square
+[dumi-url]: https://github.com/umijs/dumi
+
+</div>
+
+[![](https://st-media-template.antsomi.com/upload/2023/03/22/9d157c08-5f33-4b60-a558-1da9dde42d61.png)](https://antsomi-docs.vercel.app/)
+
+## ✨ Features
+
+- 🌈 Enterprise-class UI designed for web applications.
+- 📦 A set of high-quality React components out of the box.
+- 🛡 Written in TypeScript with predictable static types.
+- ⚙️ Whole package of design resources and development tools.
+- 🌍 Internationalization support for dozens of languages.
+- 🎨 Powerful theme customization based on CSS-in-JS.
+
+## 📦 Install
+
+```bash
+npm install @antscorp/antsomi-ui
+```
+
+```bash
+yarn add @antscorp/antsomi-ui
+```
+
+## 🔨 Usage
+
+```jsx
+import React from 'react';
+import { Button } from '@antscorp/antsomi-ui';
+
+const App = () => (
+  <>
+    <Button type="primary">Click me</Button>
+  </>
+);
+```
+
+### TypeScript
+
+`@antscorp/antsomi-ui` is written in TypeScript with complete definitions.
+
+### Ory OAuth browser login
+
+`Login` retains the released legacy flow. Use the independent `LoginV2` with `useOry`;
+the existing SignIn form, logo and banner remain visible. Its password submit
+uses Kratos JSON browser-flow APIs and CSRF, then starts Hydra authorization:
+
+```jsx
+<LoginV2
+  loginDomain={window.location.origin}
+  useOry
+  oauthAuthorizeUrl="/api/account/oauth-authenticate"
+  oauthTokenUrl="/oauth2/token"
+  oauthClientId="your-public-client-id"
+  oauthRedirectUri="https://app.example.test/oauth/callback"
+  oauthScope="openid profile email offline_access"
+  oauthLoginUrl="/oauth2/login"
+  kratosLoginUrl="/self-service/login/browser"
+  sessionUrl="/api/session"
+  onOAuthSuccess={handleOAuthSuccess}
+/>
+```
+
+The component generates an S256 PKCE verifier and state in session storage,
+starts authorization through the configured IAM entrypoint, verifies the
+callback state, and exchanges the one-time code at the public token endpoint.
+The token response is delivered in memory to `onOAuthSuccess`; it is never
+written to cookies or local storage. Passwords are submitted only to the Kratos
+flow and are not persisted. A login challenge uses the verified session when
+available; otherwise it shows the same SignIn form. A consent challenge renders the package's portal and scope screens and calls
+the IAM consent API with CSRF protection.
+
+`oauthAutoStart` defaults to `false`. Set it to `true` only for a consumer that
+wants to start authorization immediately. Configure Hydra login and consent
+URLs to this component's page and proxy Kratos `/self-service` plus IAM
+`/oauth2` APIs on the frontend origin. Business scopes still require portal
+selection and current IAM permissions; basic login does not grant those rights.
+LoginV2 supports inline Ory MFA and browser recovery with validated provider
+flows, CSRF and session checks. Helpers, types and components live under
+`es/components/organism/LoginV2`; legacy Login is not their implementation.
+
+
+### Exact LoginV2 release and manual publication
+
+```tsx
+import { Login, LoginV2, OryConsent, OryThemeProvider } from '@antscorp/antsomi-ui';
+import type { LoginV2Props } from '@antscorp/antsomi-ui';
+import '@antscorp/antsomi-ui/dist/main.css';
+```
+
+The reviewed release is `1.3.7-beta.71`, published only with the `login-v2` tag.
+After publication and registry integrity verification, install the exact
+version with `npm install --save-exact @antscorp/antsomi-ui@1.3.7-beta.71`.
+React/ReactDOM/router and Antsomi constants/locales remain consumer peers;
+use one React instance. A bundler consuming precompiled `dist/main.css` may
+skip this package's SCSS imports. Required CSS font/image files ship in dist.
+
+Publish the reviewed immutable tarball, never this dirty source directory:
+
+```sh
+npm publish /path/to/reviewed/antscorp-antsomi-ui-1.3.7-beta.71.tgz \
+  --ignore-scripts --tag login-v2 --registry=https://registry.npmjs.org
+```
+
+The source `prepublishOnly` runs yarn/build:es and deletes dist. The release
+stage disables source lifecycle scripts; `--ignore-scripts` is required for
+manual publication. Keep latest/beta/staging and other existing tags unchanged.
+The release stage preserves published beta.70 ES/types/assets and adds only
+V2, named exports, audited CSS/resources and necessary runtime metadata.
+Local tarball install/build validation is not a registry install or deployment.