@openedx/frontend-app-authn 1.0.0 → 2.0.0-alpha.2

package/README.rst

@@ -2,153 +2,323 @@
 frontend-app-authn
 ##################
 
-|Build Status| |ci-badge| |Codecov| |semantic-release|
+|license-badge| |status-badge| |ci-badge| |codecov-badge| |semantic-release|
+
+Authn is a `frontend-base`_ application: a library that plugs into the Open edX
+frontend shell, rather than a standalone micro-frontend bundled with its own
+webpack build.
+
+.. _frontend-base: https://github.com/openedx/frontend-base
 
 ********
 Purpose
 ********
 
-This is a micro-frontend application responsible for the login, registration and password reset functionality.
-
-**What is the domain of this MFE?**
+This app is responsible for the login, registration and password reset
+functionality, and serves:
 
 - Register page
-
 - Login page
-
 - Forgot password page
-
 - Reset password page
-
 - Progressive profiling page
 
+*********************
+Branches and Releases
+*********************
+
+This app is published to NPM by ``semantic-release``, and its branches follow
+`OEP-10 ADR 0002`_:
+
+``master``
+  Unstable.  Every merge publishes a prerelease on the ``alpha`` dist-tag.
+  Breaking changes land here with no DEPR process and no warning, so it is not
+  supported in production.  All changes, including bug fixes, should target this
+  branch first.
+
+``stable``
+  Carries the newest stable major and owns the ``latest`` dist-tag.  Changes
+  arrive here as backports from ``master``, and no breaking change lands after
+  publication.
+
+``n.x`` and ``n.m.x``
+  Maintenance branches for majors and minors that ``stable`` has moved past.
+  Each owns the dist-tag matching its own name, so consumers select a maintained
+  line by semver range, e.g. ``"1.x"``.
+
+``stable`` is cut, and ``1.0.0`` is the current stable release.  Both
+``.releaserc`` and the ``Release CI`` workflow know the whole layout, including
+the maintenance branch patterns, so a new line starts publishing as soon as it
+is pushed.
+
+This repository is no longer branched or tagged for Open edX releases in its own
+right.  It participates by published version instead, per `OEP-10 ADR 0003`_.
+
+The micro-frontend this app replaces goes on living on `legacy-mfe`_, which is
+where any further ``release/RELEASENAME`` branches for it are cut, for as long as
+a supported release still ships it.  Teak, Ulmo and Verawood all do.
+
+.. _OEP-10 ADR 0002: https://docs.openedx.org/projects/openedx-proposals/en/latest/processes/oep-0010/decisions/0002-frontend-stable-branches.html
+.. _OEP-10 ADR 0003: https://docs.openedx.org/projects/openedx-proposals/en/latest/processes/oep-0010/decisions/0003-frontend-release-strategy.html
+.. _legacy-mfe: https://github.com/openedx/frontend-app-authn/tree/legacy-mfe
+
 ***************
 Getting Started
 ***************
 
-Installation
-============
+Prerequisites
+=============
 
-`Tutor`_ is currently recommended as a development environment for your new MFE. Please refer to the `relevant tutor-mfe documentation`_ to get started using it.
+A running Open edX instance is needed to serve this app's backend APIs.
+`Tutor`_ in development mode is the usual choice, and ``site.config.dev.tsx``
+already points at its default hostnames.
+
+Unlike a micro-frontend, this app is neither built nor served by ``tutor-mfe``.
+The dev server below runs on the host.  Note that ``tutor-mfe`` v22 and later do
+ship this app as a frontend-base application for *deployment*, disabled by
+default; see `Frontend apps`_ in its README to enable it.
 
 .. _Tutor: https://github.com/overhangio/tutor
-.. _relevant tutor-mfe documentation: https://github.com/overhangio/tutor-mfe?tab=readme-ov-file#mfe-development
+.. _Frontend apps: https://github.com/overhangio/tutor-mfe#frontend-apps
+
+Cloning and Startup
+===================
+
+1. Clone the repo:
+
+   ``git clone https://github.com/openedx/frontend-app-authn.git``
+
+2. Use the version of Node specified in the ``.nvmrc`` file.
 
-Environment Variables/Setup Notes
-=================================
+   Using other major versions of Node *may* work, but is unsupported.  This
+   repository includes an ``.nvmrc`` file to help set the correct Node version
+   via `nvm <https://github.com/nvm-sh/nvm>`_.
 
-This MFE is configured via environment variables supplied at build time.  All micro-frontends have a shared set of required environment variables, as documented in the Open edX Developer Guide under `Required Environment Variables <https://github.com/overhangio/tutor-mfe?tab=readme-ov-file#mfe-development>`__.
+3. Install npm dependencies:
 
-The authentication micro-frontend also requires the following additional variable:
+   ``cd frontend-app-authn && npm install``
 
-.. list-table:: Environment Variables
-   :widths: 30 50 20
+4. Start the dev server:
+
+   ``npm run dev``
+
+The dev server defaults to ``PORT=1999 PUBLIC_PATH=/authn`` (set in the ``dev``
+script in ``package.json``) and is available at
+`http://apps.local.openedx.io:1999/authn <http://apps.local.openedx.io:1999/authn>`_.
+
+Configuration used by the dev server is defined in ``site.config.dev.tsx`` at
+the repo root.
+
+Local Development Against ``frontend-base``
+===========================================
+
+To develop this app and a local checkout of ``frontend-base`` in tandem, use the
+built-in npm workspace support:
+
+.. code-block:: sh
+
+    mkdir -p packages/frontend-base
+    sudo mount --bind /path/to/frontend-base packages/frontend-base
+    npm install
+    npm run dev:packages
+
+Bind mounts are used instead of symlinks because Node resolves symlinks to their
+real paths, which breaks hoisted dependency resolution.  When you are done,
+unmount with ``sudo umount packages/frontend-base``.
+
+Configuration
+=============
+
+This app is no longer configured by build-time environment variables.
+``getAppConfig`` resolves three sources, in order of increasing precedence: the
+app's bundled ``defaultConfig``, the site's ``commonAppConfig``, and the app's
+``config``.  The first is the app author's, at build time; the other two are the
+operator's, the second applying to every app on the site and the third to this
+app alone.
+
+Authn bundles three defaults, in ``src/app.ts``:
+``DISABLE_ENTERPRISE_LOGIN``, ``LOGO_URL`` and ``LOGO_WHITE_URL``.  Every other
+field below is supplied by the operator.
+
+.. list-table::
+   :widths: 30 70
    :header-rows: 1
 
    * - Name
      - Description / Usage
-     - Example
-
-   * - ``LOGIN_ISSUE_SUPPORT_LINK``
-     - The fully-qualified URL to the login issue support page in the target environment.
-     - ``https://support.example.com``
 
    * - ``ACTIVATION_EMAIL_SUPPORT_LINK``
-     - The fully-qualified URL to the activation email support page in the target environment.
-     - ``https://support.example.com``
+     - Support page linked from the account-activation error message.  Unset,
+       the message names support as plain text rather than a link.
 
-   * - ``PASSWORD_RESET_SUPPORT_LINK``
-     - The fully-qualified URL to the password reset support page in the target environment.
-     - ``https://support.example.com``
+   * - ``ALLOW_PUBLIC_ACCOUNT_CREATION``
+     - Whether visitors may register themselves.  Set it to ``false`` to hide
+       the registration page and the links to it; visitors may register
+       otherwise.
 
    * - ``AUTHN_PROGRESSIVE_PROFILING_SUPPORT_LINK``
-     - The fully-qualified URL to the progressive profiling support page in the target environment.
-     - ``https://support.example.com``
+     - Support page linked from the progressive-profiling form.  Not rendered
+       when unset.
 
-   * - ``TOS_AND_HONOR_CODE``
-     - The fully-qualified URL to the Honor code page in the target environment.
-     - ``https://example.com/honor``
+   * - ``BANNER_IMAGE_EXTRA_SMALL``, ``BANNER_IMAGE_SMALL``,
+       ``BANNER_IMAGE_MEDIUM``, ``BANNER_IMAGE_LARGE``
+     - Banner images for the image layout, one per breakpoint.  Where one is
+       unset the banner falls back to a flat background.  Only used when
+       ``ENABLE_IMAGE_LAYOUT`` is on.
 
-   * - ``TOS_LINK``
-     - The fully-qualified URL to the Terms of service page in the target environment.
-     - ``https://example.com/tos``
-
-   * - ``PRIVACY_POLICY``
-     - The fully-qualified URL to the Privacy policy page in the target environment.
-     - ``https://example.com/privacy``
+   * - ``DISABLE_ENTERPRISE_LOGIN``
+     - Disables the enterprise login flow.  Bundled as ``true``; set it to
+       ``false`` to offer enterprise login.
 
-   * - ``INFO_EMAIL``
-     - The valid email address for information query regarding the target environment.
-     - ``info@example.com``
+   * - ``ENABLE_AUTO_GENERATED_USERNAME``
+     - Generates the username from the registration form rather than asking for
+       one.
 
    * - ``ENABLE_DYNAMIC_REGISTRATION_FIELDS``
-     - Enables support for configurable registration fields on the MFE. This flag must be enabled to show any required registration field besides the default fields (name, email, username, password).
-     - ``true`` | ``''`` (empty strings are falsy)
+     - Enables configurable registration fields.  Must be enabled to show any
+       registration field besides the defaults (name, email, username,
+       password).
+
+   * - ``ENABLE_IMAGE_LAYOUT``
+     - Allows images in the base container layout.  See `Modifying base
+       container <docs/how_tos/modifying_base_container.rst>`_.
 
    * - ``ENABLE_PROGRESSIVE_PROFILING_ON_AUTHN``
-     - Enables support for progressive profiling. If enabled, users are redirected to a second page where data for optional registration fields can be collected.
-     - ``true`` | ``''`` (empty strings are falsy)
+     - Enables progressive profiling.  If enabled, users are redirected to a
+       second page where data for optional registration fields is collected.
 
-   * - ``DISABLE_ENTERPRISE_LOGIN``
-     - Disables the enterprise login from Authn MFE.
-     - ``true`` | ``''`` (empty strings are falsy)
+   * - ``INFO_EMAIL``
+     - Support address offered on the forgot-password page.  The sentence
+       offering it is omitted when unset.
+
+   * - ``LOGIN_ISSUE_SUPPORT_LINK``
+     - Support page linked from the forgot-password form.  Not rendered when
+       unset.
 
-   * - ``MFE_CONFIG_API_URL``
-     - Link of the API to get runtime mfe configuration variables from the site configuration or django settings.
-     - ``/api/v1/mfe_config`` | ``''`` (empty strings are falsy)  
+   * - ``LOGO_URL``, ``LOGO_WHITE_URL``
+     - The site logo, in its regular and light-on-dark forms.  Both are bundled
+       with the same default frontend-base uses for the shell header.
 
-   * - ``APP_ID``
-     - Name of MFE, this will be used by the API to get runtime configurations for the specific micro frontend. For a frontend repo `frontend-app-appName`, use `appName` as APP_ID.
-     - ``authn`` | ``''``
+   * - ``MARKETING_SITE_BASE_URL``
+     - Marketing site the logo links to.  The logo renders unlinked when unset.
 
-   * - ``ENABLE_IMAGE_LAYOUT``
-     - Enables the image layout feature within the authn. When set to True, this feature allows the inclusion of images in the base container layout. For more details on configuring this feature, please refer to the `Modifying base container <docs/how_tos/modifying_base_container.rst>`_.
-     - ``true`` | ``''`` (empty strings are falsy)
+   * - ``PASSWORD_RESET_SUPPORT_LINK``
+     - Support page linked from the password-reset confirmation.  Unset, the
+       message names support as plain text rather than a link.
+
+   * - ``POST_REGISTRATION_REDIRECT_URL``
+     - Where to send a user after registration, sent to the host page in the
+       embedded-registration flow.
+
+   * - ``PRIVACY_POLICY``, ``TOS_LINK``, ``TOS_AND_HONOR_CODE``
+     - Destinations for the privacy-policy, terms-of-service and honor-code
+       links on the registration form.  Each falls back to ``#`` when unset, so
+       a site collecting agreement to them should set them.
+
+   * - ``SEARCH_CATALOG_URL``
+     - Where to send a learner who finishes progressive profiling with no
+       ``nextUrl`` from the backend.  Falls back to the site itself.
+
+   * - ``SESSION_COOKIE_DOMAIN``
+     - Domain the cookies this app sets are scoped to.  Unset, they are scoped
+       to the host that served the page.
+
+   * - ``SHOW_REGISTRATION_LINKS``
+     - Whether to show links to the registration page from the other pages.  Set
+       it to ``false`` to hide them; they are shown otherwise.
 
+   * - ``USER_RETENTION_COOKIE_NAME``
+     - Name of the cookie set on successful registration.  No cookie is set when
+       unset.
 
-edX-specific Environment Variables
-==================================
+edX-specific Configuration
+==========================
 
-Furthermore, there are several edX-specific environment variables that enable integrations with closed-source services private to the edX organization, and might be unsupported in Open edX.
+The following key enables an integration with a closed-source service private to
+the edX organization, and might be unsupported in Open edX.
 
-.. list-table:: edX-specific Environment Variables
-   :widths: 30 50 20
+.. list-table::
+   :widths: 30 70
    :header-rows: 1
 
    * - Name
      - Description / Usage
-     - Example
 
    * - ``MARKETING_EMAILS_OPT_IN``
-     - Enables support for opting in marketing emails that helps us getting user consent for sending marketing emails.
-     - ``true`` | ``''`` (empty strings are falsy)
+     - Enables opting in to marketing emails, to capture user consent for
+       sending them.
 
-For more information see the document: `Micro-frontend applications in Open
-edX <https://github.com/overhangio/tutor-mfe?tab=readme-ov-file#mfe-development>`__.
 
-How To Contribute
+*****
+Slots
+*****
+
+This app offers slots for operators to customize its pages.  See `src/slots/`_
+for the current list and per-slot READMEs with usage examples.
+
+.. _src/slots/: ./src/slots/
+
+**********
+Developing
+**********
+
+Project Structure
 =================
 
-Contributions are very welcome, and strongly encouraged! We've
-put together `some documentation that describes our contribution process <https://docs.openedx.org/en/latest/developers/references/developer_guide/process/index.html>`_.
+The layout follows the standard `frontend-base app layout`_:
+
+- ``src/app.ts`` - the app definition imported by ``site.config.*.tsx``.
+- ``src/constants.ts`` - the app's ``appId`` and route role identifiers.
+- ``src/index.ts`` - the package's public exports (this is a library).
+- ``src/routes.jsx`` - the app's react-router routes.
+- ``src/Main.tsx`` - the root component for the app's routes.
+- ``src/provides.ts`` - what the app provides to the shell; here, the roles that
+  render its pages chromeless.
+- ``src/slots/`` - the slots this app offers to consumers.
+- ``src/style.scss`` and ``src/sass/`` - app-scoped runtime styles.
+
+Everything else under ``src/`` is a feature directory, one per page or shared
+concern, as described in `ADR 0002: feature based application organization
+<docs/decisions/0002-feature-based-application-organization.rst>`_.
+
+For more, see the `frontend-base migration how-to`_.
+
+.. _frontend-base app layout: https://github.com/openedx/frontend-base/blob/main/docs/how_tos/migrate-frontend-app.md#src-file-structure
+.. _frontend-base migration how-to: https://github.com/openedx/frontend-base/blob/main/docs/how_tos/migrate-frontend-app.md
+
+Build Process Notes
+===================
+
+**Library build**
 
-Even though they were written with edx-platform in mind, the guidelines should be followed for Open edX code in general.
+``npm run build`` compiles the library into ``dist/`` via ``tsc`` and
+``tsc-alias``, and copies the SCSS across.  This is what gets published and
+consumed by sites.
 
-PR description template should be automatically applied if you are sending PR from github interface; otherwise you
-can find it it at `PULL_REQUEST_TEMPLATE.md <https://github.com/openedx/frontend-app-authn/blob/master/.github/pull_request_template.md>`_
+**CI build**
 
-This project is currently accepting all types of contributions, bug fixes and security fixes.
+``npm run build:ci`` runs ``openedx build`` against ``site.config.ci.tsx`` so
+webpack traverses the full app graph.  This catches issues, such as broken
+lazy-loaded imports, that ``tsc`` and Jest would not surface.
 
+Internationalization
+====================
+
+Please refer to the `frontend-base i18n howto`_ for documentation on
+internationalization.
+
+.. _frontend-base i18n howto: https://github.com/openedx/frontend-base/blob/main/docs/how_tos/i18n.rst
+
+************
 Getting Help
-============
+************
 
 If you're having trouble, we have discussion forums at
 https://discuss.openedx.org where you can connect with others in the community.
 
-Our real-time conversations are on Slack. You can request a `Slack
-invitation`_, then join our `community Slack workspace`_.  Because this is a
-frontend repository, the best place to discuss it would be in the `#wg-frontend
-channel`_.
+Our real-time conversations are on Slack. You can request a `Slack invitation`_,
+then join our `community Slack workspace`_.  Because this is a frontend
+repository, the best place to discuss it would be in the `#wg-frontend channel`_.
 
 For anything non-trivial, the best path is to open an issue in this repository
 with as many details about the issue you are facing as you can provide.
@@ -160,45 +330,71 @@ For more information about these options, see the `Getting Help`_ page.
 .. _Slack invitation: https://openedx.org/slack
 .. _community Slack workspace: https://openedx.slack.com/
 .. _#wg-frontend channel: https://openedx.slack.com/archives/C04BM6YC7A6
-.. _Getting Help: https://openedx.org/community/connect
+.. _Getting Help: https://openedx.org/getting-help
+
+*******
+License
+*******
+
+The code in this repository is licensed under the AGPLv3 unless otherwise noted.
+
+Please see `LICENSE <LICENSE>`_ for details.
+
+************
+Contributing
+************
+
+Contributions are very welcome. Please read `How To Contribute`_ for details.
+
+.. _How To Contribute: https://openedx.org/r/how-to-contribute
 
+This project is currently accepting all types of contributions, bug fixes and
+security fixes.
+
+The PR description template should be applied automatically if you open the pull
+request from the GitHub interface; otherwise you can find it at
+`pull_request_template.md <.github/pull_request_template.md>`_.
+
+****************************
 The Open edX Code of Conduct
-============================
-All community members are expected to follow the `Open edX Code of Conduct <https://openedx.org/code-of-conduct/>`_.
+****************************
+
+All community members are expected to follow the `Open edX Code of Conduct`_.
 
+.. _Open edX Code of Conduct: https://openedx.org/code-of-conduct/
+
+******
 People
-======
+******
+
 The assigned maintainers for this component and other project details may be
-found in `Backstage <https://backstage.openedx.org/catalog/default/group/2u-infinity>`_. Backstage pulls this data from the ``catalog-info.yaml``
+found in `Backstage`_. Backstage pulls this data from the ``catalog-info.yaml``
 file in this repo.
 
-Reporting Security Issues
-=========================
-
-Please do not report security issues in public. Please email security@openedx.org.
-
-Known Issues
-============
+.. _Backstage: https://backstage.openedx.org/catalog/default/component/frontend-app-authn
 
-None
+*************************
+Reporting Security Issues
+*************************
 
-License
-=======
+Please do not report security issues in public, and email security@openedx.org
+instead.
 
-The code in this repository is licensed under the GNU Affero General Public License v3.0, unless
-otherwise noted.
+.. |license-badge| image:: https://img.shields.io/github/license/openedx/frontend-app-authn.svg
+    :target: https://github.com/openedx/frontend-app-authn/blob/master/LICENSE
+    :alt: License
 
-Please see `LICENSE <https://github.com/openedx/frontend-app-authn/blob/master/LICENSE>`_ for details.
+.. |status-badge| image:: https://img.shields.io/badge/Status-Maintained-brightgreen
+    :alt: Maintained
 
+.. |ci-badge| image:: https://github.com/openedx/frontend-app-authn/actions/workflows/ci.yml/badge.svg
+    :target: https://github.com/openedx/frontend-app-authn/actions/workflows/ci.yml
+    :alt: Continuous Integration
 
-==============================
+.. |codecov-badge| image:: https://codecov.io/github/openedx/frontend-app-authn/coverage.svg?branch=master
+    :target: https://codecov.io/github/openedx/frontend-app-authn?branch=master
+    :alt: Codecov
 
-.. |Build Status| image:: https://api.travis-ci.com/edx/frontend-app-authn.svg?branch=master
-   :target: https://travis-ci.com/edx/frontend-app-authn
-.. |Codecov| image:: https://img.shields.io/codecov/c/github/edx/frontend-app-authn
-   :target: https://codecov.io/gh/edx/frontend-app-authn
-.. |ci-badge| image:: https://github.com/openedx/edx-developer-docs/actions/workflows/ci.yml/badge.svg
-   :target: https://github.com/openedx/edx-developer-docs/actions/workflows/ci.yml
-   :alt: Continuous Integration
 .. |semantic-release| image:: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
-   :target: https://github.com/semantic-release/semantic-release
+    :target: https://github.com/semantic-release/semantic-release
+    :alt: semantic-release

package/dist/app.js

@@ -5,36 +5,10 @@ const app = {
     appId,
     routes,
     provides,
-    config: {
-        ACTIVATION_EMAIL_SUPPORT_LINK: null,
-        ALLOW_PUBLIC_ACCOUNT_CREATION: true,
-        AUTHN_PROGRESSIVE_PROFILING_SUPPORT_LINK: null,
-        BANNER_IMAGE_EXTRA_SMALL: '',
-        BANNER_IMAGE_LARGE: '',
-        BANNER_IMAGE_MEDIUM: '',
-        BANNER_IMAGE_SMALL: '',
+    defaultConfig: {
         DISABLE_ENTERPRISE_LOGIN: true,
-        ENABLE_AUTO_GENERATED_USERNAME: false,
-        ENABLE_DYNAMIC_REGISTRATION_FIELDS: false,
-        ENABLE_IMAGE_LAYOUT: false,
-        ENABLE_PROGRESSIVE_PROFILING_ON_AUTHN: false,
-        FAVICON_URL: 'https://edx-cdn.org/v3/default/favicon.ico',
-        INFO_EMAIL: '',
-        LOGIN_ISSUE_SUPPORT_LINK: null,
-        LOGO_TRADEMARK_URL: 'https://edx-cdn.org/v3/default/logo-trademark.svg',
         LOGO_URL: 'https://edx-cdn.org/v3/default/logo.svg',
         LOGO_WHITE_URL: 'https://edx-cdn.org/v3/default/logo-white.svg',
-        MARKETING_EMAILS_OPT_IN: '',
-        MARKETING_SITE_BASE_URL: 'http://local.openedx.io',
-        PASSWORD_RESET_SUPPORT_LINK: null,
-        POST_REGISTRATION_REDIRECT_URL: '',
-        PRIVACY_POLICY: null,
-        SEARCH_CATALOG_URL: null,
-        SESSION_COOKIE_DOMAIN: 'local.openedx.io',
-        SHOW_REGISTRATION_LINKS: true,
-        TOS_AND_HONOR_CODE: null,
-        TOS_LINK: null,
-        USER_RETENTION_COOKIE_NAME: '',
     },
 };
 export default app;

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,MAAM,GAAG,GAAQ;IACf,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM,EAAE;QACN,6BAA6B,EAAE,IAAI;QACnC,6BAA6B,EAAE,IAAI;QACnC,wCAAwC,EAAE,IAAI;QAC9C,wBAAwB,EAAE,EAAE;QAC5B,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,EAAE;QACvB,kBAAkB,EAAE,EAAE;QACtB,wBAAwB,EAAE,IAAI;QAC9B,8BAA8B,EAAE,KAAK;QACrC,kCAAkC,EAAE,KAAK;QACzC,mBAAmB,EAAE,KAAK;QAC1B,qCAAqC,EAAE,KAAK;QAC5C,WAAW,EAAE,4CAA4C;QACzD,UAAU,EAAE,EAAE;QACd,wBAAwB,EAAE,IAAI;QAC9B,kBAAkB,EAAE,mDAAmD;QACvE,QAAQ,EAAE,yCAAyC;QACnD,cAAc,EAAE,+CAA+C;QAC/D,uBAAuB,EAAE,EAAE;QAC3B,uBAAuB,EAAE,yBAAyB;QAClD,2BAA2B,EAAE,IAAI;QACjC,8BAA8B,EAAE,EAAE;QAClC,cAAc,EAAE,IAAI;QACpB,kBAAkB,EAAE,IAAI;QACxB,qBAAqB,EAAE,kBAAkB;QACzC,uBAAuB,EAAE,IAAI;QAC7B,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;QACd,0BAA0B,EAAE,EAAE;KAC/B;CACF,CAAC;AAEF,eAAe,GAAG,CAAC","sourcesContent":["import { App } from '@openedx/frontend-base';\nimport { appId } from './constants';\nimport provides from './provides';\nimport routes from './routes';\n\nconst app: App = {\n  appId,\n  routes,\n  provides,\n  config: {\n    ACTIVATION_EMAIL_SUPPORT_LINK: null,\n    ALLOW_PUBLIC_ACCOUNT_CREATION: true,\n    AUTHN_PROGRESSIVE_PROFILING_SUPPORT_LINK: null,\n    BANNER_IMAGE_EXTRA_SMALL: '',\n    BANNER_IMAGE_LARGE: '',\n    BANNER_IMAGE_MEDIUM: '',\n    BANNER_IMAGE_SMALL: '',\n    DISABLE_ENTERPRISE_LOGIN: true,\n    ENABLE_AUTO_GENERATED_USERNAME: false,\n    ENABLE_DYNAMIC_REGISTRATION_FIELDS: false,\n    ENABLE_IMAGE_LAYOUT: false,\n    ENABLE_PROGRESSIVE_PROFILING_ON_AUTHN: false,\n    FAVICON_URL: 'https://edx-cdn.org/v3/default/favicon.ico',\n    INFO_EMAIL: '',\n    LOGIN_ISSUE_SUPPORT_LINK: null,\n    LOGO_TRADEMARK_URL: 'https://edx-cdn.org/v3/default/logo-trademark.svg',\n    LOGO_URL: 'https://edx-cdn.org/v3/default/logo.svg',\n    LOGO_WHITE_URL: 'https://edx-cdn.org/v3/default/logo-white.svg',\n    MARKETING_EMAILS_OPT_IN: '',\n    MARKETING_SITE_BASE_URL: 'http://local.openedx.io',\n    PASSWORD_RESET_SUPPORT_LINK: null,\n    POST_REGISTRATION_REDIRECT_URL: '',\n    PRIVACY_POLICY: null,\n    SEARCH_CATALOG_URL: null,\n    SESSION_COOKIE_DOMAIN: 'local.openedx.io',\n    SHOW_REGISTRATION_LINKS: true,\n    TOS_AND_HONOR_CODE: null,\n    TOS_LINK: null,\n    USER_RETENTION_COOKIE_NAME: '',\n  },\n};\n\nexport default app;\n"]}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,MAAM,GAAG,GAAQ;IACf,KAAK;IACL,MAAM;IACN,QAAQ;IACR,aAAa,EAAE;QACb,wBAAwB,EAAE,IAAI;QAC9B,QAAQ,EAAE,yCAAyC;QACnD,cAAc,EAAE,+CAA+C;KAChE;CACF,CAAC;AAEF,eAAe,GAAG,CAAC","sourcesContent":["import { App } from '@openedx/frontend-base';\nimport { appId } from './constants';\nimport provides from './provides';\nimport routes from './routes';\n\nconst app: App = {\n  appId,\n  routes,\n  provides,\n  defaultConfig: {\n    DISABLE_ENTERPRISE_LOGIN: true,\n    LOGO_URL: 'https://edx-cdn.org/v3/default/logo.svg',\n    LOGO_WHITE_URL: 'https://edx-cdn.org/v3/default/logo-white.svg',\n  },\n};\n\nexport default app;\n"]}

package/dist/base-container/components/BrandLogo.d.ts

@@ -0,0 +1,24 @@
+export default BrandLogo;
+/**
+ * The site logo, linked to the marketing site when the operator has configured one.
+ *
+ * `MARKETING_SITE_BASE_URL` has no default that could work for every site, so when it is
+ * unset the logo renders on its own rather than as a link to nowhere.
+ */
+declare function BrandLogo({ className, variant }: {
+    className: any;
+    variant: any;
+}): import("react/jsx-runtime").JSX.Element;
+declare namespace BrandLogo {
+    namespace defaultProps {
+        let className: null;
+        let variant: string;
+    }
+    namespace propTypes {
+        let className_1: PropTypes.Requireable<string>;
+        export { className_1 as className };
+        let variant_1: PropTypes.Requireable<string>;
+        export { variant_1 as variant };
+    }
+}
+import PropTypes from 'prop-types';

package/dist/base-container/components/BrandLogo.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getSiteConfig, useAppConfig } from '@openedx/frontend-base';
+import { Hyperlink, Image } from '@openedx/paragon';
+import PropTypes from 'prop-types';
+/**
+ * The site logo, linked to the marketing site when the operator has configured one.
+ *
+ * `MARKETING_SITE_BASE_URL` has no default that could work for every site, so when it is
+ * unset the logo renders on its own rather than as a link to nowhere.
+ */
+const BrandLogo = ({ className, variant }) => {
+    const { LOGO_URL, LOGO_WHITE_URL, MARKETING_SITE_BASE_URL } = useAppConfig();
+    const image = (_jsx(Image, { className: className, alt: getSiteConfig().siteName, src: variant === 'white' ? LOGO_WHITE_URL : LOGO_URL }));
+    if (!MARKETING_SITE_BASE_URL) {
+        return image;
+    }
+    return (_jsx(Hyperlink, { destination: MARKETING_SITE_BASE_URL, children: image }));
+};
+BrandLogo.defaultProps = {
+    className: null,
+    variant: 'white',
+};
+BrandLogo.propTypes = {
+    className: PropTypes.string,
+    variant: PropTypes.oneOf(['white', 'default']),
+};
+export default BrandLogo;
+//# sourceMappingURL=BrandLogo.js.map

package/dist/base-container/components/BrandLogo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandLogo.js","sourceRoot":"","sources":["../../../src/base-container/components/BrandLogo.jsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;IAC3C,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,EAAE,GAAG,YAAY,EAAE,CAAC;IAC7E,MAAM,KAAK,GAAG,CACZ,KAAC,KAAK,IACJ,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,aAAa,EAAE,CAAC,QAAQ,EAC7B,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,GACpD,CACH,CAAC;IAEF,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,KAAC,SAAS,IAAC,WAAW,EAAE,uBAAuB,YAC5C,KAAK,GACI,CACb,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,CAAC,YAAY,GAAG;IACvB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,SAAS,CAAC,SAAS,GAAG;IACpB,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;CAC/C,CAAC;AAEF,eAAe,SAAS,CAAC","sourcesContent":["import { getSiteConfig, useAppConfig } from '@openedx/frontend-base';\nimport { Hyperlink, Image } from '@openedx/paragon';\nimport PropTypes from 'prop-types';\n\n/**\n * The site logo, linked to the marketing site when the operator has configured one.\n *\n * `MARKETING_SITE_BASE_URL` has no default that could work for every site, so when it is\n * unset the logo renders on its own rather than as a link to nowhere.\n */\nconst BrandLogo = ({ className, variant }) => {\n  const { LOGO_URL, LOGO_WHITE_URL, MARKETING_SITE_BASE_URL } = useAppConfig();\n  const image = (\n    <Image\n      className={className}\n      alt={getSiteConfig().siteName}\n      src={variant === 'white' ? LOGO_WHITE_URL : LOGO_URL}\n    />\n  );\n\n  if (!MARKETING_SITE_BASE_URL) {\n    return image;\n  }\n\n  return (\n    <Hyperlink destination={MARKETING_SITE_BASE_URL}>\n      {image}\n    </Hyperlink>\n  );\n};\n\nBrandLogo.defaultProps = {\n  className: null,\n  variant: 'white',\n};\n\nBrandLogo.propTypes = {\n  className: PropTypes.string,\n  variant: PropTypes.oneOf(['white', 'default']),\n};\n\nexport default BrandLogo;\n"]}

package/dist/base-container/components/default-layout/LargeLayout.js

@@ -1,11 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useAppConfig, getSiteConfig, useIntl } from '@openedx/frontend-base';
-import { Hyperlink, Image } from '@openedx/paragon';
+import { getSiteConfig, useIntl } from '@openedx/frontend-base';
 import classNames from 'classnames';
+import BrandLogo from '../BrandLogo';
 import messages from './messages';
 const LargeLayout = () => {
     const { formatMessage } = useIntl();
-    return (_jsxs("div", { className: "w-50 d-flex", children: [_jsxs("div", { className: "col-md-9 bg-primary-400", children: [_jsx(Hyperlink, { destination: useAppConfig().MARKETING_SITE_BASE_URL, children: _jsx(Image, { className: "logo position-absolute", alt: getSiteConfig().siteName, src: useAppConfig().LOGO_WHITE_URL }) }), _jsxs("div", { className: "min-vh-100 d-flex align-items-center", children: [_jsx("div", { className: classNames({ 'large-yellow-line mr-n4.5': getSiteConfig().siteName === 'edX' }) }), _jsxs("h1", { className: classNames('display-2 text-white mw-xs', { 'ml-6': getSiteConfig().siteName !== 'edX' }), children: [formatMessage(messages['start.learning']), _jsx("div", { className: "text-accent-a", children: formatMessage(messages['with.site.name'], { siteName: getSiteConfig().siteName }) })] })] })] }), _jsx("div", { className: "col-md-3 bg-white p-0", children: _jsx("svg", { className: "ml-n1 w-100 h-100 large-screen-svg-primary", preserveAspectRatio: "xMaxYMin meet", children: _jsx("g", { transform: "skewX(171.6)", children: _jsx("rect", { x: "0", y: "0", height: "100%", width: "100%" }) }) }) })] }));
+    return (_jsxs("div", { className: "w-50 d-flex", children: [_jsxs("div", { className: "col-md-9 bg-primary-400", children: [_jsx(BrandLogo, { className: "logo position-absolute" }), _jsxs("div", { className: "min-vh-100 d-flex align-items-center", children: [_jsx("div", { className: classNames({ 'large-yellow-line mr-n4.5': getSiteConfig().siteName === 'edX' }) }), _jsxs("h1", { className: classNames('display-2 text-white mw-xs', { 'ml-6': getSiteConfig().siteName !== 'edX' }), children: [formatMessage(messages['start.learning']), _jsx("div", { className: "text-accent-a", children: formatMessage(messages['with.site.name'], { siteName: getSiteConfig().siteName }) })] })] })] }), _jsx("div", { className: "col-md-3 bg-white p-0", children: _jsx("svg", { className: "ml-n1 w-100 h-100 large-screen-svg-primary", preserveAspectRatio: "xMaxYMin meet", children: _jsx("g", { transform: "skewX(171.6)", children: _jsx("rect", { x: "0", y: "0", height: "100%", width: "100%" }) }) }) })] }));
 };
 export default LargeLayout;
 //# sourceMappingURL=LargeLayout.js.map