keycloakify 10.0.0-rc.22 → 10.0.0-rc.24

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "keycloakify",
-    "version": "10.0.0-rc.22",
+    "version": "10.0.0-rc.24",
     "description": "Create Keycloak themes using React",
     "repository": {
         "type": "git",
@@ -130,15 +130,9 @@
         "account/kcContext/KcContext.d.ts",
         "account/kcContext/KcContext.js",
         "account/kcContext/KcContext.js.map",
-        "account/kcContext/createGetKcContext.d.ts",
-        "account/kcContext/createGetKcContext.js",
-        "account/kcContext/createGetKcContext.js.map",
-        "account/kcContext/getKcContext.d.ts",
-        "account/kcContext/getKcContext.js",
-        "account/kcContext/getKcContext.js.map",
-        "account/kcContext/getKcContextFromWindow.d.ts",
-        "account/kcContext/getKcContextFromWindow.js",
-        "account/kcContext/getKcContextFromWindow.js.map",
+        "account/kcContext/getKcContextMock.d.ts",
+        "account/kcContext/getKcContextMock.js",
+        "account/kcContext/getKcContextMock.js.map",
         "account/kcContext/index.d.ts",
         "account/kcContext/index.js",
         "account/kcContext/index.js.map",
@@ -289,15 +283,9 @@
         "login/kcContext/KcContext.d.ts",
         "login/kcContext/KcContext.js",
         "login/kcContext/KcContext.js.map",
-        "login/kcContext/createGetKcContext.d.ts",
-        "login/kcContext/createGetKcContext.js",
-        "login/kcContext/createGetKcContext.js.map",
-        "login/kcContext/getKcContext.d.ts",
-        "login/kcContext/getKcContext.js",
-        "login/kcContext/getKcContext.js.map",
-        "login/kcContext/getKcContextFromWindow.d.ts",
-        "login/kcContext/getKcContextFromWindow.js",
-        "login/kcContext/getKcContextFromWindow.js.map",
+        "login/kcContext/getKcContextMock.d.ts",
+        "login/kcContext/getKcContextMock.js",
+        "login/kcContext/getKcContextMock.js.map",
         "login/kcContext/index.d.ts",
         "login/kcContext/index.js",
         "login/kcContext/index.js.map",
@@ -454,9 +442,7 @@
         "src/account/i18n/index.ts",
         "src/account/index.ts",
         "src/account/kcContext/KcContext.ts",
-        "src/account/kcContext/createGetKcContext.ts",
-        "src/account/kcContext/getKcContext.ts",
-        "src/account/kcContext/getKcContextFromWindow.ts",
+        "src/account/kcContext/getKcContextMock.ts",
         "src/account/kcContext/index.ts",
         "src/account/kcContext/kcContextMocks.ts",
         "src/account/lib/useGetClassName.ts",
@@ -581,9 +567,7 @@
         "src/login/i18n/index.ts",
         "src/login/index.ts",
         "src/login/kcContext/KcContext.ts",
-        "src/login/kcContext/createGetKcContext.ts",
-        "src/login/kcContext/getKcContext.ts",
-        "src/login/kcContext/getKcContextFromWindow.ts",
+        "src/login/kcContext/getKcContextMock.ts",
         "src/login/kcContext/index.ts",
         "src/login/kcContext/kcContextMocks.ts",
         "src/login/lib/useDownloadTerms.ts",
@@ -624,9 +608,9 @@
         "src/login/pages/WebauthnAuthenticate.tsx",
         "src/login/pages/WebauthnError.tsx",
         "src/login/pages/WebauthnRegister.tsx",
-        "src/tools/AndByDiscriminatingKey.ts",
         "src/tools/Array.prototype.every.ts",
         "src/tools/DeepPartial.ts",
+        "src/tools/ExtractAfterStartingWith.ts",
         "src/tools/HTMLElement.prototype.prepend.ts",
         "src/tools/LazyOrNot.ts",
         "src/tools/Markdown.ts",
@@ -636,32 +620,33 @@
         "src/tools/StatefulObservable/hooks/useObservable.ts",
         "src/tools/StatefulObservable/hooks/useRerenderOnChange.ts",
         "src/tools/StatefulObservable/index.ts",
+        "src/tools/ValueOf.ts",
         "src/tools/assert.ts",
         "src/tools/clsx.ts",
         "src/tools/deepAssign.ts",
-        "src/tools/deepClone.ts",
         "src/tools/emailRegExp.ts",
         "src/tools/formatNumber.ts",
-        "src/tools/memoize.ts",
         "src/tools/pathBasename.ts",
+        "src/tools/structuredCloneButFunctions.ts",
         "src/tools/useConst.ts",
         "src/tools/useConstCallback.ts",
         "src/tools/useInsertLinkTags.ts",
         "src/tools/useInsertScriptTags.ts",
+        "src/tools/useOnFirstMount.ts",
         "src/tools/useSetClassName.ts",
         "src/tsconfig.json",
         "src/vite-plugin/index.ts",
         "src/vite-plugin/tsconfig.json",
         "src/vite-plugin/vite-plugin.ts",
-        "tools/AndByDiscriminatingKey.d.ts",
-        "tools/AndByDiscriminatingKey.js",
-        "tools/AndByDiscriminatingKey.js.map",
         "tools/Array.prototype.every.d.ts",
         "tools/Array.prototype.every.js",
         "tools/Array.prototype.every.js.map",
         "tools/DeepPartial.d.ts",
         "tools/DeepPartial.js",
         "tools/DeepPartial.js.map",
+        "tools/ExtractAfterStartingWith.d.ts",
+        "tools/ExtractAfterStartingWith.js",
+        "tools/ExtractAfterStartingWith.js.map",
         "tools/HTMLElement.prototype.prepend.d.ts",
         "tools/HTMLElement.prototype.prepend.js",
         "tools/HTMLElement.prototype.prepend.js.map",
@@ -686,6 +671,9 @@
         "tools/StatefulObservable/index.d.ts",
         "tools/StatefulObservable/index.js",
         "tools/StatefulObservable/index.js.map",
+        "tools/ValueOf.d.ts",
+        "tools/ValueOf.js",
+        "tools/ValueOf.js.map",
         "tools/assert.d.ts",
         "tools/assert.js",
         "tools/assert.js.map",
@@ -695,21 +683,18 @@
         "tools/deepAssign.d.ts",
         "tools/deepAssign.js",
         "tools/deepAssign.js.map",
-        "tools/deepClone.d.ts",
-        "tools/deepClone.js",
-        "tools/deepClone.js.map",
         "tools/emailRegExp.d.ts",
         "tools/emailRegExp.js",
         "tools/emailRegExp.js.map",
         "tools/formatNumber.d.ts",
         "tools/formatNumber.js",
         "tools/formatNumber.js.map",
-        "tools/memoize.d.ts",
-        "tools/memoize.js",
-        "tools/memoize.js.map",
         "tools/pathBasename.d.ts",
         "tools/pathBasename.js",
         "tools/pathBasename.js.map",
+        "tools/structuredCloneButFunctions.d.ts",
+        "tools/structuredCloneButFunctions.js",
+        "tools/structuredCloneButFunctions.js.map",
         "tools/useConst.d.ts",
         "tools/useConst.js",
         "tools/useConst.js.map",
@@ -722,6 +707,9 @@
         "tools/useInsertScriptTags.d.ts",
         "tools/useInsertScriptTags.js",
         "tools/useInsertScriptTags.js.map",
+        "tools/useOnFirstMount.d.ts",
+        "tools/useOnFirstMount.js",
+        "tools/useOnFirstMount.js.map",
         "tools/useSetClassName.d.ts",
         "tools/useSetClassName.js",
         "tools/useSetClassName.js.map",
@@ -803,7 +791,7 @@
         "ts-node": "^10.9.2",
         "tsc-alias": "^1.8.10",
         "tss-react": "^4.9.10",
-        "typescript": "^5.4.5",
+        "typescript": "^4.9.1-beta",
         "vite": "^5.2.11",
         "vitest": "^0.29.8",
         "yauzl": "^2.10.0",

package/src/PUBLIC_URL.ts

@@ -5,7 +5,7 @@ import {
 import { assert } from "tsafe/assert";
 
 /**
- * This is an equivalent of process.env.PUBLIC_URL thay you can use in Webpack projects.
+ * This is an equivalent of process.env.PUBLIC_URL that you can use in Webpack projects.
  * This works both in your main app and in your Keycloak theme.
  */
 export const PUBLIC_URL = (() => {

package/src/account/Template.tsx

@@ -2,14 +2,12 @@ import { useEffect } from "react";
 import { clsx } from "keycloakify/tools/clsx";
 import { type TemplateProps } from "keycloakify/account/TemplateProps";
 import { useGetClassName } from "keycloakify/account/lib/useGetClassName";
-import { createUseInsertLinkTags } from "keycloakify/tools/useInsertLinkTags";
+import { useInsertLinkTags } from "keycloakify/tools/useInsertLinkTags";
 import { useSetClassName } from "keycloakify/tools/useSetClassName";
 import type { KcContext } from "./kcContext";
 import type { I18n } from "./i18n";
 import { assert } from "keycloakify/tools/assert";
 
-const { useInsertLinkTags } = createUseInsertLinkTags();
-
 export default function Template(props: TemplateProps<KcContext, I18n>) {
     const { kcContext, i18n, doUseDefaultCss, active, classes, children } = props;
 
@@ -46,6 +44,7 @@ export default function Template(props: TemplateProps<KcContext, I18n>) {
     }, []);
 
     const { areAllStyleSheetsLoaded } = useInsertLinkTags({
+        componentOrHookName: "Template",
         hrefs: !doUseDefaultCss
             ? []
             : [

package/src/account/index.ts

@@ -2,9 +2,9 @@ import Fallback from "keycloakify/account/Fallback";
 
 export default Fallback;
 
-export { getKcContext } from "keycloakify/account/kcContext/getKcContext";
-export { createGetKcContext } from "keycloakify/account/kcContext/createGetKcContext";
 export type { AccountThemePageId as PageId } from "keycloakify/bin/shared/constants";
 export { createUseI18n } from "keycloakify/account/i18n/i18n";
+export type { ExtendKcContext } from "keycloakify/account/kcContext";
+export { createGetKcContextMock } from "keycloakify/account/kcContext";
 
 export type { PageProps } from "keycloakify/account/pages/PageProps";

package/src/account/kcContext/KcContext.ts

@@ -1,6 +1,24 @@
+import type { ThemeType, AccountThemePageId } from "keycloakify/bin/shared/constants";
+import type { ValueOf } from "keycloakify/tools/ValueOf";
 import { assert } from "tsafe/assert";
 import type { Equals } from "tsafe";
-import type { ThemeType, AccountThemePageId } from "keycloakify/bin/shared/constants";
+
+export type ExtendKcContext<
+    KcContextExtraProperties extends { properties?: Record<string, string | undefined> },
+    KcContextExtraPropertiesPerPage extends Record<string, Record<string, unknown>>
+> = ValueOf<{
+    [PageId in keyof KcContextExtraPropertiesPerPage | KcContext["pageId"]]: Extract<
+        KcContext,
+        { pageId: PageId }
+    > extends never
+        ? KcContext.Common &
+              KcContextExtraProperties & {
+                  pageId: PageId;
+              } & KcContextExtraPropertiesPerPage[PageId]
+        : Extract<KcContext, { pageId: PageId }> &
+              KcContextExtraProperties &
+              KcContextExtraPropertiesPerPage[PageId];
+}>;
 
 export type KcContext =
     | KcContext.Password

package/src/account/kcContext/getKcContextMock.ts

@@ -0,0 +1,80 @@
+import type { ExtendKcContext, KcContext as KcContextBase } from "./KcContext";
+import type { AccountThemePageId } from "keycloakify/bin/shared/constants";
+import type { DeepPartial } from "keycloakify/tools/DeepPartial";
+import { deepAssign } from "keycloakify/tools/deepAssign";
+import { structuredCloneButFunctions } from "keycloakify/tools/structuredCloneButFunctions";
+import { kcContextMocks, kcContextCommonMock } from "./kcContextMocks";
+import { exclude } from "tsafe/exclude";
+
+export function createGetKcContextMock<
+    KcContextExtraProperties extends { properties?: Record<string, string | undefined> },
+    KcContextExtraPropertiesPerPage extends Record<
+        `${string}.ftl`,
+        Record<string, unknown>
+    >
+>(params: {
+    kcContextExtraProperties: KcContextExtraProperties;
+    kcContextExtraPropertiesPerPage: KcContextExtraPropertiesPerPage;
+    overrides?: DeepPartial<KcContextExtraProperties & KcContextBase.Common>;
+    overridesPerPage?: {
+        [PageId in
+            | AccountThemePageId
+            | keyof KcContextExtraPropertiesPerPage]?: DeepPartial<
+            Extract<
+                ExtendKcContext<
+                    KcContextExtraProperties,
+                    KcContextExtraPropertiesPerPage
+                >,
+                { pageId: PageId }
+            >
+        >;
+    };
+}) {
+    const {
+        kcContextExtraProperties,
+        kcContextExtraPropertiesPerPage,
+        overrides: overrides_global,
+        overridesPerPage: overridesPerPage_global
+    } = params;
+
+    type KcContext = ExtendKcContext<
+        KcContextExtraProperties,
+        KcContextExtraPropertiesPerPage
+    >;
+
+    function getKcContextMock<
+        PageId extends AccountThemePageId | keyof KcContextExtraPropertiesPerPage
+    >(params: {
+        pageId: PageId;
+        overrides?: DeepPartial<Extract<KcContext, { pageId: PageId }>>;
+    }): Extract<KcContext, { pageId: PageId }> {
+        const { pageId, overrides } = params;
+
+        const kcContextMock = structuredCloneButFunctions(
+            kcContextMocks.find(kcContextMock => kcContextMock.pageId === pageId) ?? {
+                ...kcContextCommonMock,
+                pageId
+            }
+        );
+
+        [
+            kcContextExtraProperties,
+            kcContextExtraPropertiesPerPage[pageId],
+            overrides_global,
+            overridesPerPage_global?.[pageId],
+            overrides
+        ]
+            .filter(exclude(undefined))
+            .forEach(overrides =>
+                deepAssign({
+                    target: kcContextMock,
+                    source: overrides
+                })
+            );
+
+        // @ts-expect-error
+        return kcContextMock;
+    }
+
+    return { getKcContextMock };
+}

package/src/account/kcContext/index.ts

@@ -1 +1,2 @@
-export type { KcContext } from "./KcContext";
+export type { ExtendKcContext, KcContext } from "./KcContext";
+export { createGetKcContextMock } from "./getKcContextMock";

package/src/account/kcContext/kcContextMocks.ts

@@ -40,98 +40,33 @@ export const kcContextCommonMock: KcContext.Common = {
     locale: {
         supported: [
             /* spell-checker: disable */
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=de",
-                label: "Deutsch",
-                languageTag: "de"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=no",
-                label: "Norsk",
-                languageTag: "no"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=ru",
-                label: "Русский",
-                languageTag: "ru"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=sv",
-                label: "Svenska",
-                languageTag: "sv"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=pt-BR",
-                label: "Português (Brasil)",
-                languageTag: "pt-BR"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=lt",
-                label: "Lietuvių",
-                languageTag: "lt"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=en",
-                label: "English",
-                languageTag: "en"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=it",
-                label: "Italiano",
-                languageTag: "it"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=fr",
-                label: "Français",
-                languageTag: "fr"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=zh-CN",
-                label: "中文简体",
-                languageTag: "zh-CN"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=es",
-                label: "Español",
-                languageTag: "es"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=cs",
-                label: "Čeština",
-                languageTag: "cs"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=ja",
-                label: "日本語",
-                languageTag: "ja"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=sk",
-                label: "Slovenčina",
-                languageTag: "sk"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=pl",
-                label: "Polski",
-                languageTag: "pl"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=ca",
-                label: "Català",
-                languageTag: "ca"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=nl",
-                label: "Nederlands",
-                languageTag: "nl"
-            },
-            {
-                url: "/auth/realms/myrealm/login-actions/authenticate?client_id=account&tab_id=HoAx28ja4xg&execution=ee6c2834-46a4-4a20-a1b6-f6d6f6451b36&kc_locale=tr",
-                label: "Türkçe",
-                languageTag: "tr"
-            }
+            ["de", "Deutsch"],
+            ["no", "Norsk"],
+            ["ru", "Русский"],
+            ["sv", "Svenska"],
+            ["pt-BR", "Português (Brasil)"],
+            ["lt", "Lietuvių"],
+            ["en", "English"],
+            ["it", "Italiano"],
+            ["fr", "Français"],
+            ["zh-CN", "中文简体"],
+            ["es", "Español"],
+            ["cs", "Čeština"],
+            ["ja", "日本語"],
+            ["sk", "Slovenčina"],
+            ["pl", "Polski"],
+            ["ca", "Català"],
+            ["nl", "Nederlands"],
+            ["tr", "Türkçe"]
             /* spell-checker: enable */
-        ],
+        ].map(
+            ([languageTag, label]) =>
+                ({
+                    languageTag,
+                    label,
+                    url: "https://gist.github.com/garronej/52baaca1bb925f2296ab32741e062b8e"
+                }) as const
+        ),
         currentLanguageTag: "en"
     },
     features: {

package/src/bin/copy-keycloak-resources-to-public.ts

@@ -8,9 +8,6 @@ export async function command(params: { cliCommandOptions: CliCommandOptions })
     const buildOptions = readBuildOptions({ cliCommandOptions });
 
     await copyKeycloakResourcesToPublic({
-        buildOptions: {
-            ...buildOptions,
-            publicDirPath: buildOptions.reactAppRootDirPath
-        }
+        buildOptions
     });
 }

package/src/bin/keycloakify/generateFtl/ftl_object_to_js_code_declaring_an_object.ftl

@@ -193,7 +193,7 @@ function decodeHtmlEntities(htmlStr){
         decodeHtmlEntities.element = element;
     }
     element.innerHTML = htmlStr;
-    return textarea.value;
+    return element.value;
 }
 
 })();
@@ -266,26 +266,34 @@ function decodeHtmlEntities(htmlStr){
                         !["name", "displayName", "displayNameHtml", "internationalizationEnabled", "registrationEmailAsUsername" ]?seq_contains(key)
                     ) || (
                         "applications.ftl" == pageId &&
-                        is_subpath(path, ["applications", "applications"]) &&
                         ( 
                             key == "realm" || 
                             key == "container" 
-                        )
+                        ) &&
+                        is_subpath(path, ["applications", "applications"])
                     ) || (
-                        are_same_path(path, ["user"]) &&
-                        key == "delegateForUpdate"
+                        key == "delegateForUpdate" &&
+                        are_same_path(path, ["user"])
                     ) || (
                         <#-- Security audit forwarded by Garth (Gmail) -->
-                        are_same_path(path, ["client", "attributes"]) &&
-                        key == "saml.signing.private.key"
+                        key == "saml.signing.private.key" &&
+                        are_same_path(path, ["client", "attributes"])
                     ) || (
                         <#-- See: https://github.com/keycloakify/keycloakify/issues/534 -->
-                        are_same_path(path, ["login"]) &&
-                        key == "password"
+                        key == "password" &&
+                        are_same_path(path, ["login"])
                     ) || (
                         <#-- Remove realmAttributes added by https://github.com/jcputney/keycloak-theme-additional-info-extension for peace of mind. -->
-                        are_same_path(path, []) &&
-                        key == "realmAttributes"
+                        key == "realmAttributes" &&
+                        are_same_path(path, [])
+                    ) || (
+                        <#-- attributesByName adds a lot of noise to the output and is not needed -->
+                        key == "attributes" &&
+                        are_same_path(path, ["profile"]) 
+                    ) || (
+                        <#-- We already have the attributes in profile speedup the rendering by filtering it out from the register object -->
+                        (key == "attributes" || key == "attributesByName") &&
+                        are_same_path(path, ["register"])
                     )
                 >
                     <#local out_seq += ["/*" + path?join(".") + "." + key + " excluded*/"]>

package/src/bin/start-keycloak/start-keycloak.ts

@@ -417,7 +417,7 @@ export async function command(params: { cliCommandOptions: CliCommandOptions })
                     `- password: ${chalk.cyan.bold("password123")}`,
                     "",
                     `Watching for changes in ${chalk.bold(
-                        `.${pathSep}${pathRelative(process.cwd(), srcDirPath)}`
+                        `.${pathSep}${pathRelative(process.cwd(), buildOptions.reactAppRootDirPath)}`
                     )}`
                 ].join("\n")
             );
@@ -455,10 +455,23 @@ export async function command(params: { cliCommandOptions: CliCommandOptions })
         const { waitForDebounce } = waitForDebounceFactory({ delay: 400 });
 
         chokidar
-            .watch([srcDirPath, pathJoin(getThisCodebaseRootDirPath(), "src")], {
-                ignoreInitial: true
-            })
-            .on("all", async () => {
+            .watch(
+                [
+                    srcDirPath,
+                    buildOptions.publicDirPath,
+                    pathJoin(buildOptions.reactAppRootDirPath, "package.json"),
+                    pathJoin(buildOptions.reactAppRootDirPath, "vite.config.ts"),
+                    pathJoin(buildOptions.reactAppRootDirPath, "vite.config.js"),
+                    pathJoin(buildOptions.reactAppRootDirPath, "index.html"),
+                    pathJoin(getThisCodebaseRootDirPath(), "src")
+                ],
+                {
+                    ignoreInitial: true
+                }
+            )
+            .on("all", async (...[, filePath]) => {
+                console.log(`Detected changes in ${filePath}`);
+
                 await waitForDebounce();
 
                 runFullBuild();

package/src/bin/tools/getNpmWorkspaceRootDirPath.ts

@@ -14,6 +14,8 @@ export function getNpmWorkspaceRootDirPath(params: {
             pathJoin(...[reactAppRootDirPath, ...Array(depth).fill("..")])
         );
 
+        assert(cwd !== pathSep, "NPM workspace not found");
+
         try {
             child_process.execSync("npm config get", {
                 cwd,
@@ -21,48 +23,46 @@ export function getNpmWorkspaceRootDirPath(params: {
             });
         } catch (error) {
             if (String(error).includes("ENOWORKSPACES")) {
-                assert(cwd !== pathSep, "NPM workspace not found");
-
                 return callee(depth + 1);
             }
 
             throw error;
         }
 
-        const { isExpectedDependencyFound } = (() => {
-            const packageJsonFilePath = pathJoin(cwd, "package.json");
+        const packageJsonFilePath = pathJoin(cwd, "package.json");
 
-            assert(fs.existsSync(packageJsonFilePath));
+        if (!fs.existsSync(packageJsonFilePath)) {
+            return callee(depth + 1);
+        }
 
-            const parsedPackageJson = JSON.parse(
-                fs.readFileSync(packageJsonFilePath).toString("utf8")
-            );
+        assert(fs.existsSync(packageJsonFilePath));
 
-            let isExpectedDependencyFound = false;
+        const parsedPackageJson = JSON.parse(
+            fs.readFileSync(packageJsonFilePath).toString("utf8")
+        );
 
-            for (const dependenciesOrDevDependencies of [
-                "dependencies",
-                "devDependencies"
-            ] as const) {
-                const dependencies = parsedPackageJson[dependenciesOrDevDependencies];
+        let isExpectedDependencyFound = false;
 
-                if (dependencies === undefined) {
-                    continue;
-                }
+        for (const dependenciesOrDevDependencies of [
+            "dependencies",
+            "devDependencies"
+        ] as const) {
+            const dependencies = parsedPackageJson[dependenciesOrDevDependencies];
 
-                assert(dependencies instanceof Object);
+            if (dependencies === undefined) {
+                continue;
+            }
 
-                if (dependencies[dependencyExpected] === undefined) {
-                    continue;
-                }
+            assert(dependencies instanceof Object);
 
-                isExpectedDependencyFound = true;
+            if (dependencies[dependencyExpected] === undefined) {
+                continue;
             }
 
-            return { isExpectedDependencyFound };
-        })();
+            isExpectedDependencyFound = true;
+        }
 
-        if (!isExpectedDependencyFound) {
+        if (!isExpectedDependencyFound && parsedPackageJson.name !== dependencyExpected) {
             return callee(depth + 1);
         }