Enabling shorter import paths [automatic]

CHANGELOG.md

@@ -1,3 +1,11 @@
+### **0.0.13** (2021-02-23)  
+  
+- bump version    
+  
+### **0.0.12** (2021-02-23)  
+  
+- update readme    
+  
 ### **0.0.11** (2021-02-23)  
   
 - Add documentation    

README.md

@@ -18,10 +18,10 @@ The problem:
 ![keycloak_before](https://user-images.githubusercontent.com/6702424/108838381-dbbbcf80-75d3-11eb-8ae8-db41563ef9db.gif)
 
 When we redirected to Keycloak the user suffers from a harsh context switch.
-The language is set back to default and the theme is different, 
+The language is set back to default and the theme is different.  
 
-Keycloak does offer a way to customize the theme of theses pages but it will require a lot of raw HTML/CSS hacking
-to reproduce the look and feel of your app. Not mentioning the maintenance cost of such an endeavour.
+Keycloak does offer a way to customize theses pages but it requires a lot of raw HTML/CSS hacking
+to reproduce the look and feel of a specific app. Not mentioning the maintenance cost of such an endeavour.  
 
 Wouldn't it be great if we could just design the login and register pages as if they where part of our app while
 still letting Keycloak handle the heavy lifting of actually authenticating the users? 

bin/build-keycloak-theme/generateKeycloakThemeResources.d.ts

@@ -1,3 +1,4 @@
+export declare const ftlValuesGlobalName = "keycloakPagesContext";
 export declare function generateKeycloakThemeResources(params: {
     themeName: string;
     reactAppBuildDirPath: string;

bin/build-keycloak-theme/generateKeycloakThemeResources.js

@@ -30,13 +30,13 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateKeycloakThemeResources = void 0;
+exports.generateKeycloakThemeResources = exports.ftlValuesGlobalName = void 0;
 var transformCodebase_1 = require("../../tools/transformCodebase");
 var fs = __importStar(require("fs"));
 var path_1 = require("path");
 var replaceImportFromStatic_1 = require("./replaceImportFromStatic");
 var generateFtl_1 = require("./generateFtl");
-var ftlValuesGlobalName = "keycloakFtlValues";
+exports.ftlValuesGlobalName = "keycloakPagesContext";
 function generateKeycloakThemeResources(params) {
     var themeName = params.themeName, reactAppBuildDirPath = params.reactAppBuildDirPath, keycloakThemeBuildingDirPath = params.keycloakThemeBuildingDirPath;
     var themeDirPath = path_1.join(keycloakThemeBuildingDirPath, "src", "main", "resources", "theme", themeName, "login");
@@ -54,7 +54,7 @@ function generateKeycloakThemeResources(params) {
             if (/\.js?$/i.test(filePath)) {
                 var fixedJsCode = replaceImportFromStatic_1.replaceImportFromStaticInJsCode({
                     "jsCode": sourceCode.toString("utf8"),
-                    ftlValuesGlobalName: ftlValuesGlobalName
+                    ftlValuesGlobalName: exports.ftlValuesGlobalName
                 }).fixedJsCode;
                 return { "modifiedSourceCode": Buffer.from(fixedJsCode, "utf8") };
             }
@@ -63,7 +63,7 @@ function generateKeycloakThemeResources(params) {
     });
     var generateFtlFilesCode = generateFtl_1.generateFtlFilesCodeFactory({
         "cssGlobalsToDefine": allCssGlobalsToDefine,
-        ftlValuesGlobalName: ftlValuesGlobalName,
+        ftlValuesGlobalName: exports.ftlValuesGlobalName,
         "indexHtmlCode": fs.readFileSync(path_1.join(reactAppBuildDirPath, "index.html")).toString("utf8")
     }).generateFtlFilesCode;
     ["login.ftl", "register.ftl"].forEach(function (pageBasename) {

bin/build-keycloak-theme/generateKeycloakThemeResources.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateKeycloakThemeResources.js","sourceRoot":"","sources":["../../src/bin/build-keycloak-theme/generateKeycloakThemeResources.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mEAAkE;AAClE,qCAAyB;AACzB,6BAAwC;AACxC,qEAGmC;AACnC,6CAA4D;AAE5D,IAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD,SAAgB,8BAA8B,CAC1C,MAIC;IAGO,IAAA,SAAS,GAAyD,MAAM,UAA/D,EAAE,oBAAoB,GAAmC,MAAM,qBAAzC,EAAE,4BAA4B,GAAK,MAAM,6BAAX,CAAY;IAEjF,IAAM,YAAY,GAAG,WAAQ,CAAC,4BAA4B,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAErH,IAAI,qBAAqB,GAA2B,EAAE,CAAC;IAEvD,qCAAiB,CAAC;QACd,aAAa,EAAE,WAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;QAClD,YAAY,EAAE,oBAAoB;QAClC,2BAA2B,EAAE,UAAC,EAAwB;gBAAtB,QAAQ,cAAA,EAAE,UAAU,gBAAA;YAEhD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAErB,IAAA,KAAuC,0DAAgC,CACzE,EAAE,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAC7C,EAFO,kBAAkB,wBAAA,EAAE,YAAY,kBAEvC,CAAC;gBAEF,qBAAqB,yBACd,qBAAqB,GACrB,kBAAkB,CACxB,CAAC;gBAEF,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;aAEtE;YAED,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAElB,IAAA,WAAW,GAAK,yDAA+B,CAAC;oBACpD,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACrC,mBAAmB,qBAAA;iBACtB,CAAC,YAHiB,CAGhB;gBAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;aAErE;YAED,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC;QAEhD,CAAC;KACJ,CAAC,CAAC;IAEK,IAAA,oBAAoB,GAAK,yCAA2B,CAAC;QACzD,oBAAoB,EAAE,qBAAqB;QAC3C,mBAAmB,qBAAA;QACnB,eAAe,EAAE,EAAE,CAAC,YAAY,CAC5B,WAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAC/C,CAAC,QAAQ,CAAC,MAAM,CAAC;KACrB,CAAC,qBAN0B,CAMzB;IAEF,CAAC,WAAW,EAAE,cAAc,CAAW,CAAC,OAAO,CAAC,UAAA,YAAY;QAEjD,IAAA,OAAO,GAAK,oBAAoB,CAAC,EAAE,YAAY,cAAA,EAAE,CAAC,QAA3C,CAA4C;QAE3D,EAAE,CAAC,aAAa,CACZ,WAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,EACpC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAC/B,CAAA;IAEL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,aAAa,CACZ,WAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC,EAC1C,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CACvC,CAAC;AAEN,CAAC;AA1ED,wEA0EC"}
+{"version":3,"file":"generateKeycloakThemeResources.js","sourceRoot":"","sources":["../../src/bin/build-keycloak-theme/generateKeycloakThemeResources.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mEAAkE;AAClE,qCAAyB;AACzB,6BAAwC;AACxC,qEAGmC;AACnC,6CAA4D;AAE/C,QAAA,mBAAmB,GAAG,sBAAsB,CAAC;AAE1D,SAAgB,8BAA8B,CAC1C,MAIC;IAGO,IAAA,SAAS,GAAyD,MAAM,UAA/D,EAAE,oBAAoB,GAAmC,MAAM,qBAAzC,EAAE,4BAA4B,GAAK,MAAM,6BAAX,CAAY;IAEjF,IAAM,YAAY,GAAG,WAAQ,CAAC,4BAA4B,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAErH,IAAI,qBAAqB,GAA2B,EAAE,CAAC;IAEvD,qCAAiB,CAAC;QACd,aAAa,EAAE,WAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;QAClD,YAAY,EAAE,oBAAoB;QAClC,2BAA2B,EAAE,UAAC,EAAwB;gBAAtB,QAAQ,cAAA,EAAE,UAAU,gBAAA;YAEhD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAErB,IAAA,KAAuC,0DAAgC,CACzE,EAAE,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAC7C,EAFO,kBAAkB,wBAAA,EAAE,YAAY,kBAEvC,CAAC;gBAEF,qBAAqB,yBACd,qBAAqB,GACrB,kBAAkB,CACxB,CAAC;gBAEF,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;aAEtE;YAED,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAElB,IAAA,WAAW,GAAK,yDAA+B,CAAC;oBACpD,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACrC,mBAAmB,6BAAA;iBACtB,CAAC,YAHiB,CAGhB;gBAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;aAErE;YAED,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC;QAEhD,CAAC;KACJ,CAAC,CAAC;IAEK,IAAA,oBAAoB,GAAK,yCAA2B,CAAC;QACzD,oBAAoB,EAAE,qBAAqB;QAC3C,mBAAmB,6BAAA;QACnB,eAAe,EAAE,EAAE,CAAC,YAAY,CAC5B,WAAQ,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAC/C,CAAC,QAAQ,CAAC,MAAM,CAAC;KACrB,CAAC,qBAN0B,CAMzB;IAEF,CAAC,WAAW,EAAE,cAAc,CAAW,CAAC,OAAO,CAAC,UAAA,YAAY;QAEjD,IAAA,OAAO,GAAK,oBAAoB,CAAC,EAAE,YAAY,cAAA,EAAE,CAAC,QAA3C,CAA4C;QAE3D,EAAE,CAAC,aAAa,CACZ,WAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,EACpC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAC/B,CAAA;IAEL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,aAAa,CACZ,WAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC,EAC1C,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CACvC,CAAC;AAEN,CAAC;AA1ED,wEA0EC"}

bin/build-keycloak-theme/index.js

@@ -70,11 +70,17 @@ if (require.main === module) {
         '            - name: extensions',
         '              mountPath: /opt/jboss/keycloak/standalone/deployments',
         '',
-        "To enable the theme within keycloak log into the admin console, go to your realm settings, click on the theme tab then select " + parsedPackageJson.name + " ",
         '',
-        'To test your theme locally you can spin up a Keycloak container image with the theme loaded by running:',
+        'To test your theme locally, with hot reloading, you can spin up a Keycloak container image with the theme loaded by running:',
+        '',
+        "$ ./" + path_1.relative(reactProjectDirPath, path_1.join(exports.keycloakThemeBuildingDirPath, generateDebugFiles_1.containerLaunchScriptBasename)),
+        '',
+        'To enable the theme within keycloak log into the admin console, create a realm (called "myrealm" for example),',
+        "go to your realm settings, click on the theme tab then select " + parsedPackageJson.name + ".",
+        "More details: https://www.keycloak.org/getting-started/getting-started-docker",
+        '',
+        'Once your container is up and configured 👉 http://localhost:8080/auth/realms/myrealm/account',
         '',
-        "$ ./" + path_1.relative(reactProjectDirPath, path_1.join(exports.keycloakThemeBuildingDirPath, generateDebugFiles_1.containerLaunchScriptBasename))
     ].join("\n"));
 }
 //# sourceMappingURL=index.js.map

bin/build-keycloak-theme/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bin/build-keycloak-theme/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAEA,mFAAkF;AAClF,mEAAkE;AAElE,6BAA4F;AAC5F,2DAA+C;AAC/C,2DAAyF;AAGzF,IAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE1C,IAAM,iBAAiB,GAAsB,OAAO,CAAC,WAAQ,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;AAEvF,QAAA,4BAA4B,GAAG,WAAQ,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;AAG5F,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAElD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE;IAEzB,+DAA8B,CAAC;QAC3B,4BAA4B,sCAAA;QAC5B,sBAAsB,EAAE,WAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;QAC9D,WAAW,EAAE,iBAAiB,CAAC,IAAI;KACtC,CAAC,CAAC;IAEK,IAAA,WAAW,GAAK,+CAAsB,CAAC;QAC3C,iBAAiB,mBAAA;QACjB,4BAA4B,sCAAA;KAC/B,CAAC,YAHiB,CAGhB;IAEH,aAAa,CAAC,QAAQ,CAClB,aAAa,EACb,EAAE,KAAK,EAAE,oCAA4B,EAAE,CAC1C,CAAC;IAEF,uCAAkB,CAAC;QACf,4BAA4B,sCAAA;QAC5B,iBAAiB,EAAE,iBAAiB,CAAC,IAAI;KAC5C,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC;QACR,EAAE;QACF,sEAA+D,eAAY,CAAC,mBAAmB,EAAE,WAAW,CAAC,kBAAK;QAClH,mJAAiJ;QACjJ,EAAE;QACF,2EAA2E;QAC3E,EAAE;QACF,cAAc;QACd,4BAA4B;QAC5B,oCAAoC;QACpC,kCAAkC;QAClC,yCAAyC;QACzC,oBAAoB;QACpB,kBAAkB;QAClB,iBAAiB;QACjB,kBAAkB;QAClB,gDAA8C,eAAY,CAAC,WAAW,CAAC,4BAAuB,eAAY,CAAC,WAAW,CAAG;QACzH,yBAAyB;QACzB,gCAAgC;QAChC,sCAAsC;QACtC,UAAU;QACV,8BAA8B;QAC9B,gCAAgC;QAChC,qEAAqE;QACrE,EAAE;QACF,mIAAiI,iBAAiB,CAAC,IAAI,MAAG;QAC1J,EAAE;QACF,yGAAyG;QACzG,EAAE;QACF,SAAO,eAAY,CAAC,mBAAmB,EAAE,WAAQ,CAAC,oCAA4B,EAAE,kDAA6B,CAAC,CAAG;KACpH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;CAEjB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bin/build-keycloak-theme/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAEA,mFAAkF;AAClF,mEAAkE;AAElE,6BAA4F;AAC5F,2DAA+C;AAC/C,2DAAyF;AAGzF,IAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE1C,IAAM,iBAAiB,GAAsB,OAAO,CAAC,WAAQ,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;AAEvF,QAAA,4BAA4B,GAAG,WAAQ,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;AAG5F,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAElD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE;IAEzB,+DAA8B,CAAC;QAC3B,4BAA4B,sCAAA;QAC5B,sBAAsB,EAAE,WAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;QAC9D,WAAW,EAAE,iBAAiB,CAAC,IAAI;KACtC,CAAC,CAAC;IAEK,IAAA,WAAW,GAAK,+CAAsB,CAAC;QAC3C,iBAAiB,mBAAA;QACjB,4BAA4B,sCAAA;KAC/B,CAAC,YAHiB,CAGhB;IAEH,aAAa,CAAC,QAAQ,CAClB,aAAa,EACb,EAAE,KAAK,EAAE,oCAA4B,EAAE,CAC1C,CAAC;IAEF,uCAAkB,CAAC;QACf,4BAA4B,sCAAA;QAC5B,iBAAiB,EAAE,iBAAiB,CAAC,IAAI;KAC5C,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC;QACR,EAAE;QACF,sEAA+D,eAAY,CAAC,mBAAmB,EAAE,WAAW,CAAC,kBAAK;QAClH,mJAAiJ;QACjJ,EAAE;QACF,2EAA2E;QAC3E,EAAE;QACF,cAAc;QACd,4BAA4B;QAC5B,oCAAoC;QACpC,kCAAkC;QAClC,yCAAyC;QACzC,oBAAoB;QACpB,kBAAkB;QAClB,iBAAiB;QACjB,kBAAkB;QAClB,gDAA8C,eAAY,CAAC,WAAW,CAAC,4BAAuB,eAAY,CAAC,WAAW,CAAG;QACzH,yBAAyB;QACzB,gCAAgC;QAChC,sCAAsC;QACtC,UAAU;QACV,8BAA8B;QAC9B,gCAAgC;QAChC,qEAAqE;QACrE,EAAE;QACF,EAAE;QACF,8HAA8H;QAC9H,EAAE;QACF,SAAO,eAAY,CAAC,mBAAmB,EAAE,WAAQ,CAAC,oCAA4B,EAAE,kDAA6B,CAAC,CAAG;QACjH,EAAE;QACF,gHAAgH;QAChH,mEAAiE,iBAAiB,CAAC,IAAI,MAAG;QAC1F,+EAA+E;QAC/E,EAAE;QACF,+FAA+F;QAC/F,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;CAEjB"}

lib/index.d.ts

@@ -0,0 +1 @@
+export * from "./keycloakFtlValues";

lib/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./keycloakFtlValues"), exports);
+//# sourceMappingURL=index.js.map

lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sDAAoC"}

lib/inex.d.ts

@@ -1 +0,0 @@
-export {};

lib/inex.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=inex.js.map

lib/inex.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inex.js","sourceRoot":"","sources":["../src/lib/inex.ts"],"names":[],"mappings":""}

lib/keycloakFtlValues.d.ts

@@ -0,0 +1,9 @@
+import type { generateFtlFilesCodeFactory } from "../bin/build-keycloak-theme/generateFtl";
+export declare type KeycloakFtlValues = {
+    pageBasename: Parameters<ReturnType<typeof generateFtlFilesCodeFactory>["generateFtlFilesCode"]>[0]["pageBasename"];
+    url: {
+        loginAction: string;
+        resourcesPath: string;
+    };
+};
+export declare const keycloakPagesContext: KeycloakFtlValues | undefined;

lib/keycloakFtlValues.js

@@ -0,0 +1,9 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keycloakPagesContext = void 0;
+var generateKeycloakThemeResources_1 = require("../bin/build-keycloak-theme/generateKeycloakThemeResources");
+var id_1 = require("evt/tools/typeSafety/id");
+exports.keycloakPagesContext = (_a = {}, _a[generateKeycloakThemeResources_1.ftlValuesGlobalName] = id_1.id(window[generateKeycloakThemeResources_1.ftlValuesGlobalName]), _a).keycloakPagesContext;
+;
+//# sourceMappingURL=keycloakFtlValues.js.map

lib/keycloakFtlValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keycloakFtlValues.js","sourceRoot":"","sources":["../src/lib/keycloakFtlValues.ts"],"names":[],"mappings":";;;;AAGA,6GAAiG;AAEjG,8CAA6C;AAW9B,QAAA,oBAAoB,aAC7B,GAAC,oDAAmB,IAAG,OAAE,CAAiC,MAAc,CAAC,oDAAmB,CAAC,CAAC,2BAAG;AACvG,CAAC"}

package-lock.json

@@ -1,14 +1,15 @@
 {
     "name": "keycloak-react-theming",
-    "version": "0.0.11",
+    "version": "0.0.13",
     "lockfileVersion": 2,
     "requires": true,
     "packages": {
         "": {
-            "version": "0.0.11",
+            "version": "0.0.13",
             "license": "MIT",
             "dependencies": {
-                "cheerio": "^1.0.0-rc.5"
+                "cheerio": "^1.0.0-rc.5",
+                "evt": "^1.9.12"
             },
             "bin": {
                 "build-keycloak-theme": "dist/bin/build-keycloak-theme/index.js",
@@ -482,7 +483,6 @@
             "version": "1.9.12",
             "resolved": "https://registry.npmjs.org/evt/-/evt-1.9.12.tgz",
             "integrity": "sha512-u8wC4Xif2pcDJ9cEm0wzWCIQb+Y214m1eUgsgm2hVIuXuvC6LToryA0Ecl1O8Slii2E9l6USLsyxXWntjlnIbw==",
-            "dev": true,
             "dependencies": {
                 "minimal-polyfills": "^2.1.5",
                 "run-exclusive": "^2.2.14"
@@ -612,8 +612,7 @@
         "node_modules/minimal-polyfills": {
             "version": "2.1.6",
             "resolved": "https://registry.npmjs.org/minimal-polyfills/-/minimal-polyfills-2.1.6.tgz",
-            "integrity": "sha512-vqoxj7eMzsqX0M6/dkgoNFPw6Mztgn5qjSl0bWGboQeU7Y4UPLeyoqQw6JI+0qmBcJYdkr3nK7dqY8u/fgRp5g==",
-            "dev": true
+            "integrity": "sha512-vqoxj7eMzsqX0M6/dkgoNFPw6Mztgn5qjSl0bWGboQeU7Y4UPLeyoqQw6JI+0qmBcJYdkr3nK7dqY8u/fgRp5g=="
         },
         "node_modules/minimatch": {
             "version": "3.0.4",
@@ -749,7 +748,6 @@
             "version": "2.2.14",
             "resolved": "https://registry.npmjs.org/run-exclusive/-/run-exclusive-2.2.14.tgz",
             "integrity": "sha512-NHaQfB3zPJFx7p4M06AcmoK8xz/h8YDMCdy3jxfyoC9VqIbl1U+DiVjUuAYZBRMwvj5qkQnOUGfsmyUC4k46dg==",
-            "dev": true,
             "dependencies": {
                 "minimal-polyfills": "^2.1.5"
             }
@@ -1327,7 +1325,6 @@
             "version": "1.9.12",
             "resolved": "https://registry.npmjs.org/evt/-/evt-1.9.12.tgz",
             "integrity": "sha512-u8wC4Xif2pcDJ9cEm0wzWCIQb+Y214m1eUgsgm2hVIuXuvC6LToryA0Ecl1O8Slii2E9l6USLsyxXWntjlnIbw==",
-            "dev": true,
             "requires": {
                 "minimal-polyfills": "^2.1.5",
                 "run-exclusive": "^2.2.14"
@@ -1429,8 +1426,7 @@
         "minimal-polyfills": {
             "version": "2.1.6",
             "resolved": "https://registry.npmjs.org/minimal-polyfills/-/minimal-polyfills-2.1.6.tgz",
-            "integrity": "sha512-vqoxj7eMzsqX0M6/dkgoNFPw6Mztgn5qjSl0bWGboQeU7Y4UPLeyoqQw6JI+0qmBcJYdkr3nK7dqY8u/fgRp5g==",
-            "dev": true
+            "integrity": "sha512-vqoxj7eMzsqX0M6/dkgoNFPw6Mztgn5qjSl0bWGboQeU7Y4UPLeyoqQw6JI+0qmBcJYdkr3nK7dqY8u/fgRp5g=="
         },
         "minimatch": {
             "version": "3.0.4",
@@ -1539,7 +1535,6 @@
             "version": "2.2.14",
             "resolved": "https://registry.npmjs.org/run-exclusive/-/run-exclusive-2.2.14.tgz",
             "integrity": "sha512-NHaQfB3zPJFx7p4M06AcmoK8xz/h8YDMCdy3jxfyoC9VqIbl1U+DiVjUuAYZBRMwvj5qkQnOUGfsmyUC4k46dg==",
-            "dev": true,
             "requires": {
                 "minimal-polyfills": "^2.1.5"
             }

package.json

@@ -1,13 +1,13 @@
 {
     "name": "keycloak-react-theming",
-    "version": "0.0.11",
+    "version": "0.0.13",
     "description": "Keycloak theme generator for Reacts app",
     "repository": {
         "type": "git",
         "url": "git://github.com/garronej/keycloak-react-theming.git"
     },
-    "main": "dist/lib/index.js",
-    "types": "dist/lib/index.d.ts",
+    "main": "lib/index.js",
+    "types": "lib/index.d.ts",
     "bin": {
         "build-keycloak-theme": "bin/build-keycloak-theme/index.js",
         "download-sample-keycloak-themes": "bin/download-sample-keycloak-themes.js"
@@ -23,7 +23,8 @@
         "src/bin/build-keycloak-theme/index.ts",
         "src/bin/build-keycloak-theme/replaceImportFromStatic.ts",
         "src/bin/download-sample-keycloak-themes.ts",
-        "src/lib/inex.ts",
+        "src/lib/index.ts",
+        "src/lib/keycloakFtlValues.ts",
         "src/tools/crawl.ts",
         "src/tools/transformCodebase.ts",
         "bin/build-keycloak-theme/generateDebugFiles/index.d.ts",
@@ -48,9 +49,12 @@
         "bin/download-sample-keycloak-themes.d.ts",
         "bin/download-sample-keycloak-themes.js",
         "bin/download-sample-keycloak-themes.js.map",
-        "lib/inex.d.ts",
-        "lib/inex.js",
-        "lib/inex.js.map",
+        "lib/index.d.ts",
+        "lib/index.js",
+        "lib/index.js.map",
+        "lib/keycloakFtlValues.d.ts",
+        "lib/keycloakFtlValues.js",
+        "lib/keycloakFtlValues.js.map",
         "tools/crawl.d.ts",
         "tools/crawl.js",
         "tools/crawl.js.map",
@@ -72,6 +76,7 @@
         "typescript": "^4.1.5"
     },
     "dependencies": {
-        "cheerio": "^1.0.0-rc.5"
+        "cheerio": "^1.0.0-rc.5",
+        "evt": "^1.9.12"
     }
 }

src/bin/build-keycloak-theme/generateKeycloakThemeResources.ts

@@ -8,7 +8,7 @@ import {
 } from "./replaceImportFromStatic";
 import { generateFtlFilesCodeFactory } from "./generateFtl";
 
-const ftlValuesGlobalName = "keycloakFtlValues";
+export const ftlValuesGlobalName = "keycloakPagesContext";
 
 export function generateKeycloakThemeResources(
     params: {

src/bin/build-keycloak-theme/index.ts

@@ -65,11 +65,17 @@ if (require.main === module) {
         '            - name: extensions',
         '              mountPath: /opt/jboss/keycloak/standalone/deployments',
         '',
-        `To enable the theme within keycloak log into the admin console, go to your realm settings, click on the theme tab then select ${parsedPackageJson.name} `,
         '',
-        'To test your theme locally you can spin up a Keycloak container image with the theme loaded by running:',
+        'To test your theme locally, with hot reloading, you can spin up a Keycloak container image with the theme loaded by running:',
+        '',
+        `$ ./${pathRelative(reactProjectDirPath, pathJoin(keycloakThemeBuildingDirPath, containerLaunchScriptBasename))}`,
+        '',
+        'To enable the theme within keycloak log into the admin console, create a realm (called "myrealm" for example),',
+        `go to your realm settings, click on the theme tab then select ${parsedPackageJson.name}.`,
+        `More details: https://www.keycloak.org/getting-started/getting-started-docker`,
+        '',
+        'Once your container is up and configured 👉 http://localhost:8080/auth/realms/myrealm/account',
         '',
-        `$ ./${pathRelative(reactProjectDirPath, pathJoin(keycloakThemeBuildingDirPath, containerLaunchScriptBasename))}`
     ].join("\n"));
 
 }

src/lib/index.ts

@@ -0,0 +1 @@
+export * from "./keycloakFtlValues";

src/lib/inex.ts

@@ -1,3 +0,0 @@
-
-
-export { };

src/lib/keycloakFtlValues.ts

@@ -0,0 +1,19 @@
+
+
+
+import { ftlValuesGlobalName } from "../bin/build-keycloak-theme/generateKeycloakThemeResources";
+import type { generateFtlFilesCodeFactory } from "../bin/build-keycloak-theme/generateFtl";
+import { id } from "evt/tools/typeSafety/id";
+
+
+export type KeycloakFtlValues = {
+    pageBasename: Parameters<ReturnType<typeof generateFtlFilesCodeFactory>["generateFtlFilesCode"]>[0]["pageBasename"];
+    url: {
+        loginAction: string,
+        resourcesPath: string
+    }
+};
+
+export const { keycloakPagesContext } = 
+    { [ftlValuesGlobalName]: id<KeycloakFtlValues | undefined>((window as any)[ftlValuesGlobalName]) };
+;

tsconfig.tsbuildinfo

@@ -247,8 +247,8 @@
         "affectsGlobalScope": false
       },
       "../src/bin/build-keycloak-theme/generateKeycloakThemeResources.ts": {
-        "version": "b69ff16755d22c4ce24702ab0dc334d7c386643a72e42e7b9183429b28e23f2e",
-        "signature": "c53e9172d81232fc2b183d2105ce6b33db0803cdb01c188755460b66b9e7bf35",
+        "version": "fa036a62fb59eb4f9c98070852ba0de9789bacdc38c049a015649439edd74edc",
+        "signature": "91ea17958f25db390b27717b63af5395e85d44a75b1fcaf57ff05c0a46dcacae",
         "affectsGlobalScope": false
       },
       "../src/bin/build-keycloak-theme/generateJavaStackFiles.ts": {
@@ -262,7 +262,7 @@
         "affectsGlobalScope": false
       },
       "../src/bin/build-keycloak-theme/index.ts": {
-        "version": "cf001b5b3246db48ec014aa295bbdcdf8d4134308f9bf5d9167c4ca0fb73296b",
+        "version": "324a1c0c8c3cfa50dbc213fa4f2650551a3e5537e53635b8d4225acad9c83dc3",
         "signature": "cc0e708e12dd472472902f20c879f10b9352d52e6823ac341bc0941ef15b9618",
         "affectsGlobalScope": false
       },
@@ -271,9 +271,19 @@
         "signature": "43e818adf60173644896298637f47b01d5819b17eda46eaa32d0c7d64724d012",
         "affectsGlobalScope": false
       },
-      "../src/lib/inex.ts": {
-        "version": "f5f88f79d2709a1ebf75743bef209380b3dd79f3b6f83e61f1ffdbabc4dcc903",
-        "signature": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881",
+      "../node_modules/evt/tools/typeSafety/id.d.ts": {
+        "version": "9b4cbbc5d76a0e78a053503ed153a83f48799f1519e3aef593cb0987700704b8",
+        "signature": "9b4cbbc5d76a0e78a053503ed153a83f48799f1519e3aef593cb0987700704b8",
+        "affectsGlobalScope": false
+      },
+      "../src/lib/keycloakFtlValues.ts": {
+        "version": "8855aa745f2916ae3bc7161b4ef9784c21f595070e177e2a201a5d8ffc672a64",
+        "signature": "47f69685f9207ddeb9e876a0b9545efbd8a73a6b3b123c9b685165bde9d408df",
+        "affectsGlobalScope": false
+      },
+      "../src/lib/index.ts": {
+        "version": "982f8546cf41fe3912d92c4b9f338c57b55bebe8dacd5002bb11449d1a273ed5",
+        "signature": "988e58c5be2a660857f23895090b1b6cafe4fe6d36ce4f9e74754ac6d8bfd787",
         "affectsGlobalScope": false
       },
       "../node_modules/@types/node/globals.d.ts": {
@@ -796,6 +806,14 @@
         "../node_modules/@types/node/path.d.ts",
         "../src/bin/build-keycloak-theme/index.ts"
       ],
+      "../src/lib/index.ts": [
+        "../src/lib/keycloakFtlValues.ts"
+      ],
+      "../src/lib/keycloakFtlValues.ts": [
+        "../node_modules/evt/tools/typeSafety/id.d.ts",
+        "../src/bin/build-keycloak-theme/generateFtl.ts",
+        "../src/bin/build-keycloak-theme/generateKeycloakThemeResources.ts"
+      ],
       "../src/test/build-keycloak-theme.ts": [
         "../node_modules/@types/node/path.d.ts",
         "../node_modules/scripting-tools/dist/lib/index.d.ts",
@@ -1034,6 +1052,12 @@
         "../node_modules/@types/node/child_process.d.ts",
         "../node_modules/@types/node/index.d.ts",
         "../node_modules/scripting-tools/dist/lib/get_caller_file_path.d.ts"
+      ],
+      "../src/lib/index.ts": [
+        "../src/lib/keycloakFtlValues.ts"
+      ],
+      "../src/lib/keycloakFtlValues.ts": [
+        "../src/bin/build-keycloak-theme/generateFtl.ts"
       ]
     },
     "semanticDiagnosticsPerFile": [
@@ -1094,6 +1118,7 @@
       "../node_modules/domutils/lib/stringify.d.ts",
       "../node_modules/domutils/lib/tagtypes.d.ts",
       "../node_modules/domutils/lib/traversal.d.ts",
+      "../node_modules/evt/tools/typeSafety/id.d.ts",
       "../node_modules/htmlparser2/lib/FeedHandler.d.ts",
       "../node_modules/htmlparser2/lib/Parser.d.ts",
       "../node_modules/htmlparser2/lib/Tokenizer.d.ts",
@@ -1135,7 +1160,8 @@
       "../src/bin/build-keycloak-theme/index.ts",
       "../src/bin/build-keycloak-theme/replaceImportFromStatic.ts",
       "../src/bin/download-sample-keycloak-themes.ts",
-      "../src/lib/inex.ts",
+      "../src/lib/index.ts",
+      "../src/lib/keycloakFtlValues.ts",
       "../src/test/build-keycloak-theme.ts",
       "../src/test/download-sample-keycloak-themes.ts",
       "../src/test/generateKeycloakThemeResources.ts",