@openedx/frontend-app-catalog 1.0.0-alpha.0

package/README.rst

@@ -0,0 +1,300 @@
+frontend-app-catalog
+####################
+
+|license-badge| |status-badge| |ci-badge| |codecov-badge|
+
+The catalog 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
+*******
+
+The catalog serves the public-facing Home, Course About, and Course
+Catalog pages — the intended replacement for the corresponding legacy
+views in ``edx-platform``.
+
+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`` has not been cut yet: until this app is first ready for
+production use, ``master`` and its alphas are all there is.  Both
+``.releaserc`` and the ``Release CI`` workflow already 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.
+
+.. _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-catalog/tree/legacy-mfe
+
+Getting Started
+***************
+
+Prerequisites
+=============
+
+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.
+
+.. _Tutor: https://github.com/overhangio/tutor
+
+Cloning and Startup
+===================
+
+1. Clone the repo:
+
+   ``git clone https://github.com/openedx/frontend-app-catalog.git``
+
+2. Use the version of Node specified in the ``.nvmrc`` file.
+
+   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>`_.
+
+3. Install npm dependencies:
+
+   ``cd frontend-app-catalog && npm install``
+
+4. Start the dev server:
+
+   ``npm run dev``
+
+The dev server defaults to ``PORT=1998 PUBLIC_PATH=/catalog`` (set in
+the ``dev`` script in ``package.json``) and is available at
+`http://apps.local.openedx.io:1998/catalog <http://apps.local.openedx.io:1998/catalog>`_.
+
+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
+=============
+
+The catalog app declares the following ``AppConfig`` fields (defaults
+live in ``src/app.ts``). Sites can override any of them by spreading
+over ``catalogApp.config`` in ``site.config.*.tsx``:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 40 60
+
+   * - Field
+     - Purpose
+   * - ``ENABLE_COURSE_DISCOVERY``
+     - Show the Discover / Explore links in the header.
+   * - ``ENABLE_PROGRAMS``
+     - Show the Programs link in the header.
+   * - ``ENABLE_COURSE_SORTING_BY_START_DATE``
+     - Enable start-date sorting in the catalog search.
+   * - ``HOMEPAGE_COURSE_MAX``
+     - Maximum number of courses to render on the homepage list
+       (default ``9``).
+   * - ``HOMEPAGE_PROMO_VIDEO_YOUTUBE_ID``
+     - YouTube video id for the homepage promo video.
+   * - ``NON_BROWSABLE_COURSES``
+     - When truthy, hides catalog links for authenticated users.
+   * - ``INFO_EMAIL``
+     - Support email address shown on the catalog error page.
+   * - ``SUPPORT_URL``
+     - URL of the support / help page linked from the catalog.
+   * - ``LEARNING_BASE_URL``
+     - Base URL for course-outline links from the course-about page.
+   * - ``COURSE_ABOUT_TWITTER_ACCOUNT``
+     - Twitter handle used by the course-about sidebar's share widget.
+
+See ``site.config.dev.tsx`` in this repo for a worked example of
+overriding these for local development.
+
+Slots
+*****
+
+This app offers a number of 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
+=================
+
+The layout follows the standard `frontend-base app layout`_:
+
+- ``src/app.ts`` — the app configuration imported by
+  ``site.config.*.tsx``.
+- ``src/constants.ts`` — the app's ``appId`` and role identifiers.
+- ``src/index.ts`` — the package's public exports (this is a
+  library).
+- ``src/routes.tsx`` — the app's react-router routes.
+- ``src/Main.tsx`` — the root component for the app's routes.
+- ``src/slots.tsx`` — the slot operations the app applies to the
+  shell.
+- ``src/slots/`` — the slots this app offers to consumers.
+- ``src/style.scss`` — app-scoped runtime styles.
+
+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**
+
+``npm run build`` compiles the library into ``dist/`` via ``tsc`` and
+``tsc-alias``. This is what gets published and consumed by sites.
+
+**CI build**
+
+``npm run build:ci`` runs ``openedx build`` against
+``site.config.ci.tsx`` so webpack traverses the full app graph. This
+catches issues (like 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`_.
+
+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.
+
+https://github.com/openedx/frontend-app-catalog/issues
+
+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/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, security fixes, maintenance work, or new features. However,
+please make sure to have a discussion about your new feature idea
+with the maintainers prior to beginning development to maximize the
+chances of your change being accepted. You can start a conversation
+by creating a new issue on this repo summarizing your idea.
+
+The Open edX 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`_. Backstage pulls this data from the
+``catalog-info.yaml`` file in this repo.
+
+.. _Backstage: https://open-edx-backstage.herokuapp.com/catalog/default/component/frontend-app-catalog
+
+Reporting Security Issues
+*************************
+
+Please do not report security issues in public, and email
+security@openedx.org instead.
+
+.. |license-badge| image:: https://img.shields.io/github/license/openedx/frontend-app-catalog.svg
+    :target: https://github.com/openedx/frontend-app-catalog/blob/master/LICENSE
+    :alt: License
+
+.. |status-badge| image:: https://img.shields.io/badge/Status-Maintained-brightgreen
+    :alt: Maintained
+
+.. |ci-badge| image:: https://github.com/openedx/frontend-app-catalog/actions/workflows/ci.yml/badge.svg
+    :target: https://github.com/openedx/frontend-app-catalog/actions/workflows/ci.yml
+    :alt: Continuous Integration
+
+.. |codecov-badge| image:: https://codecov.io/github/openedx/frontend-app-catalog/coverage.svg?branch=master
+    :target: https://codecov.io/github/openedx/frontend-app-catalog?branch=master
+    :alt: Codecov

package/dist/Main.d.ts

@@ -0,0 +1,3 @@
+import './style.scss';
+declare const Main: () => import("react/jsx-runtime").JSX.Element;
+export default Main;

package/dist/Main.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { CurrentAppProvider } from '@openedx/frontend-base';
+import { Outlet } from 'react-router-dom';
+import { appId } from './constants';
+import './style.scss';
+const Main = () => (_jsx(CurrentAppProvider, { appId: appId, children: _jsx("main", { className: "d-flex flex-column flex-grow-1", children: _jsx(Outlet, {}) }) }));
+export default Main;
+//# sourceMappingURL=Main.js.map

package/dist/Main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Main.js","sourceRoot":"","sources":["../src/Main.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,cAAc,CAAC;AAEtB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CACjB,KAAC,kBAAkB,IAAC,KAAK,EAAE,KAAK,YAC9B,eAAM,SAAS,EAAC,gCAAgC,YAC9C,KAAC,MAAM,KAAG,GACL,GACY,CACtB,CAAC;AAEF,eAAe,IAAI,CAAC","sourcesContent":["import { CurrentAppProvider } from '@openedx/frontend-base';\nimport { Outlet } from 'react-router-dom';\n\nimport { appId } from './constants';\n\nimport './style.scss';\n\nconst Main = () => (\n  <CurrentAppProvider appId={appId}>\n    <main className=\"d-flex flex-column flex-grow-1\">\n      <Outlet />\n    </main>\n  </CurrentAppProvider>\n);\n\nexport default Main;\n"]}

package/dist/app.d.ts

@@ -0,0 +1,3 @@
+import { App } from '@openedx/frontend-base';
+declare const app: App;
+export default app;

package/dist/app.js

@@ -0,0 +1,22 @@
+import { appId } from './constants';
+import routes from './routes';
+import slots from './slots';
+const app = {
+    appId,
+    routes,
+    slots,
+    config: {
+        ENABLE_COURSE_DISCOVERY: false,
+        ENABLE_PROGRAMS: false,
+        HOMEPAGE_PROMO_VIDEO_YOUTUBE_ID: '',
+        HOMEPAGE_COURSE_MAX: 9,
+        ENABLE_COURSE_SORTING_BY_START_DATE: false,
+        NON_BROWSABLE_COURSES: '',
+        INFO_EMAIL: '',
+        SUPPORT_URL: '',
+        LEARNING_BASE_URL: '',
+        COURSE_ABOUT_TWITTER_ACCOUNT: '',
+    },
+};
+export default app;
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,GAAG,GAAQ;IACf,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM,EAAE;QACN,uBAAuB,EAAE,KAAK;QAC9B,eAAe,EAAE,KAAK;QACtB,+BAA+B,EAAE,EAAE;QACnC,mBAAmB,EAAE,CAAC;QACtB,mCAAmC,EAAE,KAAK;QAC1C,qBAAqB,EAAE,EAAE;QACzB,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,iBAAiB,EAAE,EAAE;QACrB,4BAA4B,EAAE,EAAE;KACjC;CACF,CAAC;AAEF,eAAe,GAAG,CAAC","sourcesContent":["import { App } from '@openedx/frontend-base';\nimport { appId } from '@src/constants';\nimport routes from '@src/routes';\nimport slots from '@src/slots';\n\nconst app: App = {\n  appId,\n  routes,\n  slots,\n  config: {\n    ENABLE_COURSE_DISCOVERY: false,\n    ENABLE_PROGRAMS: false,\n    HOMEPAGE_PROMO_VIDEO_YOUTUBE_ID: '',\n    HOMEPAGE_COURSE_MAX: 9,\n    ENABLE_COURSE_SORTING_BY_START_DATE: false,\n    NON_BROWSABLE_COURSES: '',\n    INFO_EMAIL: '',\n    SUPPORT_URL: '',\n    LEARNING_BASE_URL: '',\n    COURSE_ABOUT_TWITTER_ACCOUNT: '',\n  },\n};\n\nexport default app;\n"]}

package/dist/assets/images/no-course-image.svg

@@ -0,0 +1,4 @@
+<svg width="386" height="252" viewBox="0 0 386 252" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M380 0H6C2.68629 0 0 2.68629 0 6V246C0 249.314 2.68629 252 6 252H380C383.314 252 386 249.314 386 246V6C386 2.68629 383.314 0 380 0Z" fill="#E1DDDB"/>
+<path d="M211 144V108H175V144H211ZM186 129L191 135.02L198 126L207 138H179L186 129Z" fill="#707070"/>
+</svg>

package/dist/assets/scss/_animations.scss

@@ -0,0 +1,23 @@
+@keyframes home-banner-info-animation {
+    0% {
+        opacity: 0;
+        transform: translateY(18.75rem);
+    }
+
+    45% {
+        opacity: 1;
+    }
+
+    65% {
+        transform: translateY(-2.5rem);
+    }
+
+    85% {
+        transform: translateY(.625rem);
+    }
+
+    100% {
+        top: 0;
+        transform: translateY(0);
+    }
+}

package/dist/catalog/CatalogPage.d.ts

@@ -0,0 +1,2 @@
+declare const CatalogPage: () => import("react/jsx-runtime").JSX.Element;
+export default CatalogPage;

package/dist/catalog/CatalogPage.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo } from 'react';
+import { Helmet } from 'react-helmet';
+import { Container, Alert } from '@openedx/paragon';
+import { ErrorPage, getAppConfig, getSiteConfig, useIntl, } from '@openedx/frontend-base';
+import { useSearchParams } from 'react-router-dom';
+import { appId } from '../constants';
+import { DEFAULT_PAGE_SIZE } from '../data/course-list-search/constants';
+import { useCourseListSearch } from '../data/course-list-search/hooks';
+import CourseCatalogIntroSlot from '../slots/CourseCatalogIntroSlot';
+import { CourseCatalogDataTableSlot } from '../slots/CourseCatalogDataTableSlots';
+import CourseCatalogSearchFieldSlot from '../slots/CourseCatalogSearchFieldSlot';
+import { useDebouncedSearchInput } from './hooks/useDebouncedSearchInput';
+import { AlertNotification, Loading } from '../generic';
+import { useCatalog } from './hooks/useCatalog';
+import messages from './messages';
+import { transformAggregationsToFilterChoices } from './utils';
+const CatalogPage = () => {
+    var _a, _b, _c, _d;
+    const intl = useIntl();
+    const [searchParams, setSearchParams] = useSearchParams();
+    const searchQuery = searchParams.get('search_query') || '';
+    const { data: courseData, isLoading, isError, fetchData, isFetching, } = useCourseListSearch({ searchString: searchQuery });
+    const { pageIndex, filterState, searchString, hasInitializedFromUrl, urlSearchQuery, previousCourseData, handleSearch, handleFetchData, resetFilterProgress, } = useCatalog({
+        fetchData, courseData, isFetching, searchParams, setSearchParams,
+    });
+    const { setSearchInput } = useDebouncedSearchInput({
+        searchString,
+        handleSearch,
+    });
+    const displayData = useMemo(() => {
+        var _a, _b;
+        const hasSearchResults = ((_b = (_a = courseData === null || courseData === void 0 ? void 0 : courseData.results) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0;
+        const hasActiveSearch = Boolean(searchString);
+        const shouldShowPreviousData = hasActiveSearch && !hasSearchResults && previousCourseData;
+        return shouldShowPreviousData ? previousCourseData : courseData;
+    }, [courseData, searchString, previousCourseData]);
+    useEffect(() => {
+        if (!isFetching && filterState.isFilterChangeInProgress) {
+            resetFilterProgress();
+        }
+    }, [isFetching, filterState.isFilterChangeInProgress, resetFilterProgress]);
+    const tableColumns = useMemo(() => transformAggregationsToFilterChoices(displayData === null || displayData === void 0 ? void 0 : displayData.aggs, intl), [displayData === null || displayData === void 0 ? void 0 : displayData.aggs, intl]);
+    if (isLoading || (!hasInitializedFromUrl && urlSearchQuery)) {
+        return (_jsx(Loading, {}));
+    }
+    if (isError) {
+        return (_jsx(Container, { className: "py-5.5", children: _jsx(Alert, { variant: "danger", children: _jsx(ErrorPage
+                // @ts-expect-error frontend-base ErrorPage declares message?: null but renders the prop as text. Remove when typing is fixed upstream.
+                , { 
+                    // @ts-expect-error frontend-base ErrorPage declares message?: null but renders the prop as text. Remove when typing is fixed upstream.
+                    message: intl.formatMessage(messages.errorMessage, {
+                        supportEmail: getAppConfig(appId).INFO_EMAIL,
+                    }) }) }) }));
+    }
+    const totalCourses = (_b = (_a = displayData === null || displayData === void 0 ? void 0 : displayData.results) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+    const pageCount = Math.ceil(((displayData === null || displayData === void 0 ? void 0 : displayData.total) || totalCourses) / DEFAULT_PAGE_SIZE);
+    const hasCourses = totalCourses > 0 || ((_c = previousCourseData === null || previousCourseData === void 0 ? void 0 : previousCourseData.total) !== null && _c !== void 0 ? _c : 0) > 0;
+    return (_jsxs(_Fragment, { children: [_jsx(Helmet, { children: _jsx("title", { children: intl.formatMessage(messages.pageTitle, {
+                        siteName: getSiteConfig().siteName,
+                    }) }) }), _jsxs(Container, { fluid: false, size: "xl", className: "pt-5.5 mb-6", children: [_jsx(CourseCatalogIntroSlot, { searchString: searchString, courseDataResultsLength: (_d = courseData === null || courseData === void 0 ? void 0 : courseData.results) === null || _d === void 0 ? void 0 : _d.length }), hasCourses ? (_jsxs(_Fragment, { children: [_jsx(CourseCatalogSearchFieldSlot, { setSearchInput: setSearchInput, handleSearch: handleSearch, initialSearchValue: searchString }), _jsx(CourseCatalogDataTableSlot, { displayData: displayData, totalCourses: totalCourses, pageCount: pageCount, pageIndex: pageIndex, tableColumns: tableColumns, handleFetchData: handleFetchData })] })) : (_jsx(AlertNotification, { title: intl.formatMessage(messages.noCoursesAvailable), message: intl.formatMessage(messages.noCoursesAvailableMessage) }))] })] }));
+};
+export default CatalogPage;
+//# sourceMappingURL=CatalogPage.js.map

package/dist/catalog/CatalogPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatalogPage.js","sourceRoot":"","sources":["../../src/catalog/CatalogPage.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\nimport { Helmet } from 'react-helmet';\nimport { Container, Alert } from '@openedx/paragon';\nimport {\n  ErrorPage, getAppConfig, getSiteConfig, useIntl,\n} from '@openedx/frontend-base';\nimport { useSearchParams } from 'react-router-dom';\n\nimport { appId } from '@src/constants';\nimport { DEFAULT_PAGE_SIZE } from '@src/data/course-list-search/constants';\nimport { useCourseListSearch } from '@src/data/course-list-search/hooks';\nimport CourseCatalogIntroSlot from '@src/slots/CourseCatalogIntroSlot';\nimport { CourseCatalogDataTableSlot } from '@src/slots/CourseCatalogDataTableSlots';\nimport CourseCatalogSearchFieldSlot from '@src/slots/CourseCatalogSearchFieldSlot';\nimport { useDebouncedSearchInput } from './hooks/useDebouncedSearchInput';\nimport { AlertNotification, Loading } from '../generic';\nimport { useCatalog } from './hooks/useCatalog';\nimport messages from './messages';\nimport { transformAggregationsToFilterChoices } from './utils';\n\nconst CatalogPage = () => {\n  const intl = useIntl();\n  const [searchParams, setSearchParams] = useSearchParams();\n  const searchQuery = searchParams.get('search_query') || '';\n  const {\n    data: courseData,\n    isLoading,\n    isError,\n    fetchData,\n    isFetching,\n  } = useCourseListSearch({ searchString: searchQuery });\n\n  const {\n    pageIndex,\n    filterState,\n    searchString,\n    hasInitializedFromUrl,\n    urlSearchQuery,\n    previousCourseData,\n    handleSearch,\n    handleFetchData,\n    resetFilterProgress,\n  } = useCatalog({\n    fetchData, courseData, isFetching, searchParams, setSearchParams,\n  });\n\n  const { setSearchInput } = useDebouncedSearchInput({\n    searchString,\n    handleSearch,\n  });\n\n  const displayData = useMemo(() => {\n    const hasSearchResults = (courseData?.results?.length ?? 0) > 0;\n    const hasActiveSearch = Boolean(searchString);\n\n    const shouldShowPreviousData = hasActiveSearch && !hasSearchResults && previousCourseData;\n\n    return shouldShowPreviousData ? previousCourseData : courseData;\n  }, [courseData, searchString, previousCourseData]);\n\n  useEffect(() => {\n    if (!isFetching && filterState.isFilterChangeInProgress) {\n      resetFilterProgress();\n    }\n  }, [isFetching, filterState.isFilterChangeInProgress, resetFilterProgress]);\n\n  const tableColumns = useMemo(\n    () => transformAggregationsToFilterChoices(displayData?.aggs, intl),\n    [displayData?.aggs, intl],\n  );\n\n  if (isLoading || (!hasInitializedFromUrl && urlSearchQuery)) {\n    return (\n      <Loading />\n    );\n  }\n\n  if (isError) {\n    return (\n      <Container className=\"py-5.5\">\n        <Alert variant=\"danger\">\n          <ErrorPage\n            // @ts-expect-error frontend-base ErrorPage declares message?: null but renders the prop as text. Remove when typing is fixed upstream.\n            message={intl.formatMessage(messages.errorMessage, {\n              supportEmail: getAppConfig(appId).INFO_EMAIL as string,\n            })}\n          />\n        </Alert>\n      </Container>\n    );\n  }\n\n  const totalCourses = displayData?.results?.length ?? 0;\n  const pageCount = Math.ceil((displayData?.total || totalCourses) / DEFAULT_PAGE_SIZE);\n  const hasCourses = totalCourses > 0 || (previousCourseData?.total ?? 0) > 0;\n\n  return (\n    <>\n      <Helmet>\n        <title>\n          {intl.formatMessage(messages.pageTitle, {\n            siteName: getSiteConfig().siteName,\n          })}\n        </title>\n      </Helmet>\n      <Container fluid={false} size=\"xl\" className=\"pt-5.5 mb-6\">\n        <CourseCatalogIntroSlot searchString={searchString} courseDataResultsLength={courseData?.results?.length} />\n        {hasCourses ? (\n          <>\n            <CourseCatalogSearchFieldSlot\n              setSearchInput={setSearchInput}\n              handleSearch={handleSearch}\n              initialSearchValue={searchString}\n            />\n            <CourseCatalogDataTableSlot\n              displayData={displayData}\n              totalCourses={totalCourses}\n              pageCount={pageCount}\n              pageIndex={pageIndex}\n              tableColumns={tableColumns}\n              handleFetchData={handleFetchData}\n            />\n          </>\n        ) : (\n          <AlertNotification\n            title={intl.formatMessage(messages.noCoursesAvailable)}\n            message={intl.formatMessage(messages.noCoursesAvailableMessage)}\n          />\n        )}\n      </Container>\n    </>\n  );\n};\n\nexport default CatalogPage;\n"]}

package/dist/catalog/hooks/types.d.ts

@@ -0,0 +1,24 @@
+import { useSearchParams } from 'react-router-dom';
+import type { CourseListSearchResponse, DataTableParams } from '../../data/course-list-search/types';
+export interface UseCatalogProps {
+    fetchData: (params: DataTableParams) => void;
+    courseData: CourseListSearchResponse | undefined;
+    isFetching: boolean;
+    searchParams: ReturnType<typeof useSearchParams>[0];
+    setSearchParams: ReturnType<typeof useSearchParams>[1];
+}
+export interface UseCourseDataProps {
+    courseData: CourseListSearchResponse | undefined;
+    searchString: string;
+}
+export interface UseSearchProps {
+    fetchData: (params: DataTableParams) => void;
+    isFetching: boolean;
+    searchParams: ReturnType<typeof useSearchParams>[0];
+    setSearchParams: ReturnType<typeof useSearchParams>[1];
+}
+export interface UseDebouncedSearchInputProps {
+    searchString: string | null | undefined;
+    handleSearch: (value: string) => void;
+    debounceDelay?: number;
+}

package/dist/catalog/hooks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/catalog/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/catalog/hooks/types.ts"],"names":[],"mappings":"","sourcesContent":["import { useSearchParams } from 'react-router-dom';\n\nimport type { CourseListSearchResponse, DataTableParams } from '@src/data/course-list-search/types';\n\nexport interface UseCatalogProps {\n  fetchData: (params: DataTableParams) => void,\n  courseData: CourseListSearchResponse | undefined,\n  isFetching: boolean,\n  searchParams: ReturnType<typeof useSearchParams>[0],\n  setSearchParams: ReturnType<typeof useSearchParams>[1],\n}\n\nexport interface UseCourseDataProps {\n  courseData: CourseListSearchResponse | undefined,\n  searchString: string,\n}\n\nexport interface UseSearchProps {\n  fetchData: (params: DataTableParams) => void,\n  isFetching: boolean,\n  searchParams: ReturnType<typeof useSearchParams>[0],\n  setSearchParams: ReturnType<typeof useSearchParams>[1],\n}\n\nexport interface UseDebouncedSearchInputProps {\n  searchString: string | null | undefined,\n  handleSearch: (value: string) => void,\n  debounceDelay?: number,\n}\n"]}

package/dist/catalog/hooks/useCatalog.d.ts

@@ -0,0 +1,29 @@
+import type { DataTableParams } from '../../data/course-list-search/types';
+import type { UseCatalogProps } from './types';
+/**
+ * Main catalog hook that orchestrates all catalog functionality.
+ *
+ * This hook combines multiple specialized hooks to provide a complete
+ * catalog management solution with search, filtering, pagination, and data caching.
+ *
+ * Features:
+ * - Search functionality
+ * - Filter management with intelligent change detection
+ * - Pagination state management
+ * - Course data caching for better UX
+ * - Coordinated data fetching with proper state management
+ */
+export declare const useCatalog: ({ fetchData, courseData, isFetching, searchParams, setSearchParams, }: UseCatalogProps) => {
+    pageIndex: number;
+    filterState: {
+        previousFilters: any[] | Record<string, any> | null;
+        isFilterChangeInProgress: boolean;
+    };
+    searchString: string;
+    hasInitializedFromUrl: boolean;
+    urlSearchQuery: string;
+    previousCourseData: import("../../data/course-list-search/types").CourseListSearchResponse | null;
+    handleSearch: (query: string) => void;
+    handleFetchData: (params: DataTableParams) => void;
+    resetFilterProgress: () => void;
+};

package/dist/catalog/hooks/useCatalog.js

@@ -0,0 +1,52 @@
+import { useCallback } from 'react';
+import { DEFAULT_PAGE_INDEX } from '../../data/course-list-search/constants';
+import { useSearch } from './useSearch';
+import { useFilter } from './useFilter';
+import { usePagination } from './usePagination';
+import { useCourseData } from './useCourseData';
+/**
+ * Main catalog hook that orchestrates all catalog functionality.
+ *
+ * This hook combines multiple specialized hooks to provide a complete
+ * catalog management solution with search, filtering, pagination, and data caching.
+ *
+ * Features:
+ * - Search functionality
+ * - Filter management with intelligent change detection
+ * - Pagination state management
+ * - Course data caching for better UX
+ * - Coordinated data fetching with proper state management
+ */
+export const useCatalog = ({ fetchData, courseData, isFetching, searchParams, setSearchParams, }) => {
+    const { hasInitializedFromUrl, urlSearchQuery, searchString, handleSearch, } = useSearch({
+        fetchData, isFetching, searchParams, setSearchParams,
+    });
+    const { filterState, resetFilterProgress, handleFilterChange } = useFilter();
+    const { pageIndex, handlePageChange, resetPagination } = usePagination();
+    const { previousCourseData } = useCourseData({
+        courseData,
+        searchString,
+    });
+    const handleFetchData = useCallback((params) => {
+        const { pageIndex: newPageIndex, filters: newFilters } = params;
+        const filterChanged = handleFilterChange(newFilters, fetchData, searchString);
+        if (filterChanged) {
+            resetPagination();
+            return;
+        }
+        handlePageChange(newPageIndex !== null && newPageIndex !== void 0 ? newPageIndex : DEFAULT_PAGE_INDEX);
+        fetchData(Object.assign(Object.assign({}, params), { searchString }));
+    }, [handleFilterChange, fetchData, searchString, resetPagination, handlePageChange]);
+    return {
+        pageIndex,
+        filterState,
+        searchString,
+        hasInitializedFromUrl,
+        urlSearchQuery,
+        previousCourseData,
+        handleSearch,
+        handleFetchData,
+        resetFilterProgress,
+    };
+};
+//# sourceMappingURL=useCatalog.js.map

package/dist/catalog/hooks/useCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCatalog.js","sourceRoot":"","sources":["../../../src/catalog/hooks/useCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACzB,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,eAAe,GACC,EAAE,EAAE;IACpB,MAAM,EACJ,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,YAAY,GACb,GAAG,SAAS,CAAC;QACZ,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe;KACrD,CAAC,CAAC;IAEH,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,GAAG,SAAS,EAAE,CAAC;IAE7E,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAC;IAEzE,MAAM,EAAE,kBAAkB,EAAE,GAAG,aAAa,CAAC;QAC3C,UAAU;QACV,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,MAAuB,EAAE,EAAE;QAC9D,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAEhE,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAA+B,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QAEnG,IAAI,aAAa,EAAE,CAAC;YAClB,eAAe,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,gBAAgB,CAAC,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,kBAAkB,CAAC,CAAC;QACrD,SAAS,iCAAM,MAAM,KAAE,YAAY,IAAG,CAAC;IACzC,CAAC,EAAE,CAAC,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAErF,OAAO;QACL,SAAS;QACT,WAAW;QACX,YAAY;QACZ,qBAAqB;QACrB,cAAc;QACd,kBAAkB;QAClB,YAAY;QACZ,eAAe;QACf,mBAAmB;KACpB,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { useCallback } from 'react';\n\nimport type { DataTableParams, DataTableFilter } from '@src/data/course-list-search/types';\nimport { DEFAULT_PAGE_INDEX } from '@src/data/course-list-search/constants';\nimport { useSearch } from './useSearch';\nimport { useFilter } from './useFilter';\nimport { usePagination } from './usePagination';\nimport { useCourseData } from './useCourseData';\nimport type { UseCatalogProps } from './types';\n\n/**\n * Main catalog hook that orchestrates all catalog functionality.\n *\n * This hook combines multiple specialized hooks to provide a complete\n * catalog management solution with search, filtering, pagination, and data caching.\n *\n * Features:\n * - Search functionality\n * - Filter management with intelligent change detection\n * - Pagination state management\n * - Course data caching for better UX\n * - Coordinated data fetching with proper state management\n */\nexport const useCatalog = ({\n  fetchData,\n  courseData,\n  isFetching,\n  searchParams,\n  setSearchParams,\n}: UseCatalogProps) => {\n  const {\n    hasInitializedFromUrl,\n    urlSearchQuery,\n    searchString,\n    handleSearch,\n  } = useSearch({\n    fetchData, isFetching, searchParams, setSearchParams,\n  });\n\n  const { filterState, resetFilterProgress, handleFilterChange } = useFilter();\n\n  const { pageIndex, handlePageChange, resetPagination } = usePagination();\n\n  const { previousCourseData } = useCourseData({\n    courseData,\n    searchString,\n  });\n\n  const handleFetchData = useCallback((params: DataTableParams) => {\n    const { pageIndex: newPageIndex, filters: newFilters } = params;\n\n    const filterChanged = handleFilterChange(newFilters as DataTableFilter[], fetchData, searchString);\n\n    if (filterChanged) {\n      resetPagination();\n      return;\n    }\n\n    handlePageChange(newPageIndex ?? DEFAULT_PAGE_INDEX);\n    fetchData({ ...params, searchString });\n  }, [handleFilterChange, fetchData, searchString, resetPagination, handlePageChange]);\n\n  return {\n    pageIndex,\n    filterState,\n    searchString,\n    hasInitializedFromUrl,\n    urlSearchQuery,\n    previousCourseData,\n    handleSearch,\n    handleFetchData,\n    resetFilterProgress,\n  };\n};\n"]}

package/dist/catalog/hooks/useCourseData.d.ts

@@ -0,0 +1,12 @@
+import type { CourseListSearchResponse } from '../../data/course-list-search/types';
+import type { UseCourseDataProps } from './types';
+/**
+ * Custom hook for managing course data caching.
+ *
+ * This hook provides functionality to:
+ * - Cache previous course data when not searching
+ * - Manage data persistence for better UX
+ */
+export declare const useCourseData: ({ courseData, searchString, }: UseCourseDataProps) => {
+    previousCourseData: CourseListSearchResponse | null;
+};

package/dist/catalog/hooks/useCourseData.js

@@ -0,0 +1,21 @@
+import { useState, useEffect } from 'react';
+/**
+ * Custom hook for managing course data caching.
+ *
+ * This hook provides functionality to:
+ * - Cache previous course data when not searching
+ * - Manage data persistence for better UX
+ */
+export const useCourseData = ({ courseData, searchString, }) => {
+    const [previousCourseData, setPreviousCourseData] = useState(null);
+    /**
+     * Handles course data state changes.
+     */
+    useEffect(() => {
+        if (courseData && !searchString && courseData.total > 0) {
+            setPreviousCourseData(courseData);
+        }
+    }, [courseData, searchString]);
+    return { previousCourseData };
+};
+//# sourceMappingURL=useCourseData.js.map

package/dist/catalog/hooks/useCourseData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCourseData.js","sourceRoot":"","sources":["../../../src/catalog/hooks/useCourseData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAK5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,UAAU,EACV,YAAY,GACO,EAAE,EAAE;IACvB,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAAkC,IAAI,CAAC,CAAC;IAEpG;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,UAAU,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACxD,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAE/B,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAChC,CAAC,CAAC","sourcesContent":["import { useState, useEffect } from 'react';\n\nimport type { CourseListSearchResponse } from '@src/data/course-list-search/types';\nimport type { UseCourseDataProps } from './types';\n\n/**\n * Custom hook for managing course data caching.\n *\n * This hook provides functionality to:\n * - Cache previous course data when not searching\n * - Manage data persistence for better UX\n */\nexport const useCourseData = ({\n  courseData,\n  searchString,\n}: UseCourseDataProps) => {\n  const [previousCourseData, setPreviousCourseData] = useState<CourseListSearchResponse | null>(null);\n\n  /**\n   * Handles course data state changes.\n   */\n  useEffect(() => {\n    if (courseData && !searchString && courseData.total > 0) {\n      setPreviousCourseData(courseData);\n    }\n  }, [courseData, searchString]);\n\n  return { previousCourseData };\n};\n"]}

package/dist/catalog/hooks/useDebouncedSearchInput.d.ts

@@ -0,0 +1,7 @@
+import type { UseDebouncedSearchInputProps } from './types';
+/**
+ * Custom hook for managing debounced search input with deferred value optimization.
+ */
+export declare const useDebouncedSearchInput: ({ searchString, handleSearch, debounceDelay, }: UseDebouncedSearchInputProps) => {
+    setSearchInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+};