jopijs 0.0.1

package/dist/@ui/cssModules.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+export type HandlerBundleExternalCss = (importMeta: any, cssFilePath: string) => void;
+export declare function setHandler_bundleExternalCss(listener: HandlerBundleExternalCss): void;
+export declare const CssModule: React.FC<{
+    module: any;
+}>;
+export interface UseCssModuleContextProps {
+    jopiUseCssModule?: Record<string, any>;
+}
+export declare function getCssModuleStyle(cssModule: undefined | Record<string, string>): string;
+export declare function mustBundleExternalCss(importMeta: any, cssFilePath: string): void;

package/dist/@ui/cssModules.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// noinspection JSUnusedGlobalSymbols
+import React from "react";
+export function setHandler_bundleExternalCss(listener) {
+    gHandler_bundleExternalCss = listener;
+}
+export const CssModule = ({ module }) => {
+    return _jsx("style", { children: module.__CSS__ });
+};
+export function getCssModuleStyle(cssModule) {
+    return cssModule ? cssModule.__CSS__ : "";
+}
+export function mustBundleExternalCss(importMeta, cssFilePath) {
+    gHandler_bundleExternalCss(importMeta, cssFilePath);
+}
+let gHandler_bundleExternalCss = () => { };
+//# sourceMappingURL=cssModules.js.map

package/dist/@ui/cssModules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssModules.js","sourceRoot":"","sources":["../../src/@ui/cssModules.tsx"],"names":[],"mappings":";AAAA,qCAAqC;AAErC,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,4BAA4B,CAAC,QAAkC;IAC3E,0BAA0B,GAAG,QAAQ,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAA4B,CAAC,EAAC,MAAM,EAAC,EAAE,EAAE;IAC3D,OAAO,0BAAQ,MAAM,CAAC,OAAO,GAAS,CAAC;AAC3C,CAAC,CAAC;AAMF,MAAM,UAAU,iBAAiB,CAAC,SAA6C;IAC3E,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAe,EAAE,WAAmB;IACtE,0BAA0B,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,0BAA0B,GAA6B,GAAG,EAAE,GAAE,CAAC,CAAC"}

package/dist/@ui/hooks.d.ts

@@ -0,0 +1,31 @@
+import { PageController } from "./pageController.ts";
+/**
+ * Allow getting a reference to the PageController.
+ * **USING IT MUST BE AVOIDED** since it's a technical item.
+ * It's the reason of the underscore.
+ */
+export declare function _usePage<T = any>(): PageController<T>;
+/**
+ * Allows setting the page title.
+ * @param title
+ */
+export declare function usePageTitle(title: string): void;
+export declare function useCssModule(cssModule: undefined | Record<string, string>): void;
+/**
+ * Is a subset of JopiRequest, with only browser-side compatible items.
+ */
+export interface ServerRequestInstance {
+    urlParts?: Record<string, any>;
+    urlInfos: URL;
+    customData: any;
+    user_getJwtToken(): string | undefined;
+    headers: Headers;
+    cookie_reqHasCookie(name: string, value?: string): boolean;
+    cookie_getReqCookie(name: string): string | undefined;
+}
+export declare function useServerRequest(): ServerRequestInstance;
+/**
+ * Allows listening to an event, and automatically
+ * unregister when the component unmount.
+ */
+export declare function useEvent(evenName: string | string[], listener: (data: any) => void): void;

package/dist/@ui/hooks.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// noinspection JSUnusedGlobalSymbols
+import React, { useEffect } from "react";
+import { PageContext, PageController, PageController_ExposePrivate } from "./pageController.js";
+import { CssModule } from "./cssModules.js";
+import * as jk_events from "jopi-toolkit/jk_events";
+/**
+ * Allow getting a reference to the PageController.
+ * **USING IT MUST BE AVOIDED** since it's a technical item.
+ * It's the reason of the underscore.
+ */
+export function _usePage() {
+    let res = React.useContext(PageContext);
+    // Not wrapped inside a PageContext?
+    if (!res) {
+        res = new PageController(true);
+    }
+    return res;
+}
+/**
+ * Allows setting the page title.
+ * @param title
+ */
+export function usePageTitle(title) {
+    const page = React.useContext(PageContext);
+    if (page)
+        page.setPageTitle(title);
+}
+export function useCssModule(cssModule) {
+    if (!cssModule)
+        return;
+    // Not a real CSS Module?
+    const fileHash = cssModule.__FILE_HASH__;
+    if (!fileHash)
+        return;
+    const ctx = _usePage();
+    // Will allow knowing if the module is already inserted for this page.
+    if (!ctx.data.jopiUseCssModule)
+        ctx.data.jopiUseCssModule = {};
+    // Not already added? Then add it.
+    if (fileHash && !ctx.data.jopiUseCssModule[fileHash]) {
+        ctx.data.jopiUseCssModule[fileHash] = true;
+        // Will allow inlining the style inside the page.
+        ctx.addToBodyBegin(fileHash, _jsx(CssModule, { module: cssModule }, fileHash));
+    }
+}
+export function useServerRequest() {
+    let page = _usePage();
+    return page.getServerRequest();
+}
+/**
+ * Allows listening to an event, and automatically
+ * unregister when the component unmount.
+ */
+export function useEvent(evenName, listener) {
+    useEffect(() => {
+        if (evenName instanceof Array) {
+            evenName.forEach(e => {
+                jk_events.addListener(e, listener);
+            });
+            return () => {
+                evenName.forEach(e => {
+                    jk_events.removeListener(e, listener);
+                });
+            };
+        }
+        jk_events.addListener(evenName, listener);
+        return () => { jk_events.removeListener(evenName, listener); };
+    }, [evenName, listener]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/@ui/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/@ui/hooks.tsx"],"names":[],"mappings":";AAAA,qCAAqC;AAErC,OAAO,KAAK,EAAE,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACvC,OAAO,EAAC,WAAW,EAAE,cAAc,EAAE,4BAA4B,EAAC,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAC,SAAS,EAAgC,MAAM,iBAAkB,CAAC;AAC1E,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACpB,IAAI,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAsB,CAAC;IAE7D,oCAAoC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,GAAG,GAAG,IAAI,cAAc,CAAI,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAmB,CAAC;IAC7D,IAAI,IAAI;QAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAA6C;IACtE,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,yBAAyB;IACzB,MAAM,QAAQ,GAAG,SAAS,CAAC,aAAa,CAAC;IACzC,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,MAAM,GAAG,GAAG,QAAQ,EAA4B,CAAC;IAEjD,sEAAsE;IACtE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB;QAAE,GAAG,CAAC,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;IAE/D,kCAAkC;IAClC,IAAI,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,gBAAiB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAE5C,iDAAiD;QACjD,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAC,SAAS,IAAgB,MAAM,EAAE,SAAS,IAA3B,QAAQ,CAAsB,CAAC,CAAC;IACjF,CAAC;AACL,CAAC;AAiBD,MAAM,UAAU,gBAAgB;IAC5B,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;IACtB,OAAQ,IAAqC,CAAC,gBAAgB,EAAE,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAyB,EAAE,QAA6B;IAC7E,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,QAAQ,YAAY,KAAK,EAAE,CAAC;YAC5B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBACjB,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACR,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;oBACjB,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAC1C,CAAC,CAAC,CAAC;YACP,CAAC,CAAA;QACL,CAAC;QAED,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAC;IAClE,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/@ui/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./tools.ts";
+export * from "./pageController.ts";
+export * from "./cssModules.tsx";
+export * from "./components.tsx";
+export * from "./hooks.tsx";
+export * from "./modules.ts";
+export * from "./objectRegistry.ts";
+export declare const isBrowserSide = false;
+export declare const isServerSide = true;

package/dist/@ui/index.js

@@ -0,0 +1,11 @@
+import { isBrowser } from "jopi-toolkit/jk_what";
+export * from "./tools.js";
+export * from "./pageController.js";
+export * from "./cssModules.js";
+export * from "./components.js";
+export * from "./hooks.js";
+export * from "./modules.js";
+export * from "./objectRegistry.js";
+export const isBrowserSide = isBrowser;
+export const isServerSide = !isBrowser;
+//# sourceMappingURL=index.js.map

package/dist/@ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/@ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAE/C,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAkB,CAAC;AAEjC,cAAc,iBAAkB,CAAC;AACjC,cAAc,YAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,CAAC"}

package/dist/@ui/internal.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentAliasDef } from "./modules.ts";
+import { PageController } from "./pageController.ts";
+export declare const gComponentAlias: Record<string, ComponentAliasDef>;
+export declare function getDefaultPageController(): PageController;

package/dist/@ui/internal.js

@@ -0,0 +1,10 @@
+import { PageContext, PageController } from "./pageController.js";
+import React from "react";
+export const gComponentAlias = {};
+export function getDefaultPageController() {
+    if (!gDefaultPageController)
+        gDefaultPageController = new PageController();
+    return gDefaultPageController;
+}
+let gDefaultPageController;
+//# sourceMappingURL=internal.js.map

package/dist/@ui/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/@ui/internal.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,eAAe,GAAsC,EAAE,CAAC;AAErE,MAAM,UAAU,wBAAwB;IACpC,IAAI,CAAC,sBAAsB;QAAE,sBAAsB,GAAG,IAAI,cAAc,EAAE,CAAC;IAC3E,OAAO,sBAAuB,CAAC;AACnC,CAAC;AAED,IAAI,sBAAgD,CAAC"}

package/dist/@ui/modules.d.ts

@@ -0,0 +1,41 @@
+import * as jk_events from "jopi-toolkit/jk_events";
+import { type UiUserInfos } from "./tools.ts";
+import React from "react";
+import { type IsObjectRegistry } from "./objectRegistry.ts";
+export interface ModuleInitContext_Host {
+    objectRegistry: IsObjectRegistry;
+    getCurrentURL(): URL;
+    getUserInfos(): UiUserInfos | undefined;
+    mustRemoveTrailingSlashs: boolean;
+    events: jk_events.EventGroup;
+}
+export interface ComponentAliasDef {
+    alias: string;
+    component: React.ComponentType<any>;
+}
+type UiInitializer = () => void;
+/**
+ * This class is what is sent as the default export function
+ * of your module `uiInit.tsx`. It allows configuring things
+ * allowing your plugin to initialize your UI.
+ *
+ * * On the server side, it's executed for each page.
+ * * On the browser side, it's executed for each browser refresh.
+ */
+export declare class ModuleInitContext {
+    readonly objectRegistry: IsObjectRegistry;
+    readonly events: jk_events.EventGroup;
+    readonly isBrowserSide: boolean;
+    protected readonly host: ModuleInitContext_Host;
+    constructor(host?: ModuleInitContext_Host);
+    protected initialize(): void;
+    getCurrentURL(): URL;
+    addUiInitializer(priority: UiInitializer | jk_events.EventPriority, initializer?: UiInitializer | undefined): void;
+    getUserInfos(): UiUserInfos | undefined;
+    getUserRoles(): string[];
+    userHasRoles(roles: string[]): boolean;
+    ifUserHasRoles(roles: string[], f: (userInfos: UiUserInfos) => void): void;
+    ifUserLoggedIn(f: (userInfos: UiUserInfos) => void): void;
+    ifNotUserLoggedIn(f: () => Promise<void>): void;
+}
+export {};

package/dist/@ui/modules.js

@@ -0,0 +1,74 @@
+// noinspection JSUnusedGlobalSymbols
+import * as jk_events from "jopi-toolkit/jk_events";
+import {} from "./tools.js";
+import React from "react";
+import { isServerSide } from "jopi-toolkit/jk_what";
+import {} from "./objectRegistry.js";
+import { getDefaultPageController } from "./internal.js";
+/**
+ * This class is what is sent as the default export function
+ * of your module `uiInit.tsx`. It allows configuring things
+ * allowing your plugin to initialize your UI.
+ *
+ * * On the server side, it's executed for each page.
+ * * On the browser side, it's executed for each browser refresh.
+ */
+export class ModuleInitContext {
+    objectRegistry;
+    events;
+    isBrowserSide = !isServerSide;
+    host;
+    constructor(host) {
+        if (!host)
+            host = getDefaultPageController();
+        this.host = host;
+        this.objectRegistry = host.objectRegistry;
+        this.events = host.events;
+        this.initialize();
+    }
+    initialize() {
+        // Will be overridden.
+    }
+    getCurrentURL() {
+        return this.host.getCurrentURL();
+    }
+    addUiInitializer(priority, initializer) {
+        this.events.addListener("app.init.ui", priority, initializer);
+    }
+    getUserInfos() {
+        return this.host.getUserInfos();
+    }
+    getUserRoles() {
+        let userInfos = this.getUserInfos();
+        if (!userInfos)
+            return [];
+        return userInfos.roles || [];
+    }
+    userHasRoles(roles) {
+        if (roles.length === 0)
+            return true;
+        let userInfos = this.getUserInfos();
+        if (!userInfos)
+            return false;
+        let userRoles = userInfos.roles;
+        if (!userRoles)
+            return false;
+        return !!roles.every(role => userRoles.includes(role));
+    }
+    ifUserHasRoles(roles, f) {
+        if (this.userHasRoles(roles)) {
+            f(this.getUserInfos());
+        }
+    }
+    ifUserLoggedIn(f) {
+        let userInfos = this.getUserInfos();
+        if (!userInfos)
+            return;
+        return f(userInfos);
+    }
+    ifNotUserLoggedIn(f) {
+        if (!this.getUserInfos())
+            f();
+    }
+}
+//# sourceMappingURL=modules.js.map

package/dist/@ui/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/@ui/modules.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAkB,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAC,wBAAwB,EAAC,MAAM,eAAe,CAAC;AAmBvD;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACV,cAAc,CAAmB;IACjC,MAAM,CAAuB;IAC7B,aAAa,GAAY,CAAC,YAAY,CAAC;IACpC,IAAI,CAAyB;IAEhD,YAAY,IAA6B;QACrC,IAAI,CAAC,IAAI;YAAE,IAAI,GAAG,wBAAwB,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE1B,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAES,UAAU;QAChB,sBAAsB;IAC1B,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,gBAAgB,CAAC,QAA+C,EAAE,WAAqC;QACnG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClE,CAAC;IAED,YAAY;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED,YAAY;QACR,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,YAAY,CAAC,KAAe;QACxB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAE7B,IAAI,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC;QAChC,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAE7B,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,cAAc,CAAC,KAAe,EAAE,CAAmC;QAC/D,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC,YAAY,EAAG,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,cAAc,CAAC,CAAmC;QAC9C,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,CAAsB;QACpC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YAAE,CAAC,EAAE,CAAC;IAClC,CAAC;CACJ"}

package/dist/@ui/objectRegistry.d.ts

@@ -0,0 +1,12 @@
+export interface IsObjectRegistry {
+    getObject<T>(name: string): T | undefined;
+    registerObject(name: string, instance: any): void;
+    addObjectBuilder<T>(name: string, builder: () => T): void;
+}
+export declare class ObjectRegistry implements IsObjectRegistry {
+    private readonly r;
+    getObject<T>(name: string): T | undefined;
+    registerObject(name: string, instance: any): void;
+    addObjectBuilder<T>(name: string, builder: () => T): void;
+}
+export declare function getDefaultObjectRegistry(): IsObjectRegistry;

package/dist/@ui/objectRegistry.js

@@ -0,0 +1,35 @@
+export class ObjectRegistry {
+    r = {};
+    getObject(name) {
+        let entry = this.r[name];
+        if (!entry)
+            return undefined;
+        if (entry.instance !== undefined)
+            return entry.instance;
+        if (entry.builder) {
+            entry.instance = entry.builder();
+            return entry.instance;
+        }
+        return undefined;
+    }
+    registerObject(name, instance) {
+        let entry = this.r[name];
+        if (!entry)
+            this.r[name] = entry = {};
+        entry.instance = instance;
+    }
+    addObjectBuilder(name, builder) {
+        let entry = this.r[name];
+        if (!entry)
+            this.r[name] = entry = {};
+        entry.builder = builder;
+    }
+}
+export function getDefaultObjectRegistry() {
+    if (!gObjectRegistry) {
+        return gObjectRegistry = new ObjectRegistry();
+    }
+    return gObjectRegistry;
+}
+let gObjectRegistry;
+//# sourceMappingURL=objectRegistry.js.map

package/dist/@ui/objectRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectRegistry.js","sourceRoot":"","sources":["../../src/@ui/objectRegistry.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,cAAc;IACN,CAAC,GAAwC,EAAE,CAAC;IAE7D,SAAS,CAAI,IAAY;QACrB,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,KAAK,CAAC,QAAQ,KAAG,SAAS;YAAE,OAAO,KAAK,CAAC,QAAa,CAAC;QAE3D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,QAAa,CAAC;QAC/B,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,QAAa;QACtC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACtC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,gBAAgB,CAAI,IAAY,EAAE,OAAgB;QAC9C,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACtC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAC5B,CAAC;CACJ;AAED,MAAM,UAAU,wBAAwB;IACpC,IAAI,CAAC,eAAe,EAAE,CAAC;QACnB,OAAO,eAAe,GAAG,IAAI,cAAc,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED,IAAI,eAAyC,CAAC"}

package/dist/@ui/pageController.d.ts

@@ -0,0 +1,61 @@
+import React from "react";
+import { type ServerRequestInstance } from "./hooks.tsx";
+import { type UiUserInfos } from "./tools.ts";
+import * as jk_events from "jopi-toolkit/jk_events";
+import type { ModuleInitContext_Host } from "./modules.ts";
+import { type IsObjectRegistry } from "./objectRegistry.ts";
+export interface PageOptions {
+    pageTitle?: string;
+    head?: React.ReactNode[];
+    bodyBegin?: React.ReactNode[];
+    bodyEnd?: React.ReactNode[];
+    htmlProps?: Record<string, any>;
+    bodyProps?: Record<string, any>;
+    headProps?: Record<string, any>;
+}
+/**
+ * Page controller is an object that can be accessed
+ * from any React component from the `_usePage`hook.
+ */
+export declare class PageController<T = any> implements ModuleInitContext_Host {
+    readonly isDetached: boolean;
+    readonly mustRemoveTrailingSlashs: boolean;
+    private readonly isServerSide;
+    private readonly usedKeys;
+    protected state: PageOptions;
+    protected serverRequest?: ServerRequestInstance;
+    protected userInfos?: UiUserInfos;
+    readonly events: jk_events.EventGroup;
+    readonly objectRegistry: IsObjectRegistry;
+    constructor(isDetached?: boolean, mustRemoveTrailingSlashs?: boolean, options?: PageOptions);
+    /**
+     * Allow storing custom data inside the page context.
+     */
+    data: T;
+    /**
+     * Return the current page url.
+     * For server-side: correspond to the url of the request.
+     * For browser-side: is the navigateur url.
+     */
+    getCurrentURL(): URL;
+    getUserInfos(): UiUserInfos | undefined;
+    addToHeader(key: string, entry: React.ReactNode): this;
+    addToBodyBegin(key: string, entry: React.ReactNode): this;
+    addToBodyEnd(key: string, entry: React.ReactNode): this;
+    setHeadTagProps(key: string, value: any): this;
+    setHtmlTagProps(key: string, value: any): this;
+    setBodyTagProps(key: string, value: any): this;
+    setPageTitle(title: string): this;
+    private checkKey;
+    refreshUserInfos(): void;
+    logOutUser(): void;
+    onStateUpdated(_state: PageOptions): void;
+    onRequireRefresh(): void;
+}
+export declare class PageController_ExposePrivate<T = any> extends PageController<T> {
+    getOptions(): PageOptions;
+    setServerRequest(serverRequest: ServerRequestInstance): void;
+    getServerRequest(): ServerRequestInstance;
+}
+export type PageHook = (controller: PageController_ExposePrivate<unknown>) => void;
+export declare const PageContext: React.Context<PageController<unknown> | undefined>;

package/dist/@ui/pageController.js

@@ -0,0 +1,166 @@
+// noinspection JSUnusedGlobalSymbols
+import React from "react";
+import {} from "./hooks.js";
+import { decodeJwtToken, decodeUserInfosFromCookie, isUserInfoCookieUpdated, deleteCookie } from "./tools.js";
+import * as jk_events from "jopi-toolkit/jk_events";
+import { isServerSide } from "jopi-toolkit/jk_what";
+import { getDefaultObjectRegistry, ObjectRegistry } from "./objectRegistry.js";
+/**
+ * Page controller is an object that can be accessed
+ * from any React component from the `_usePage`hook.
+ */
+export class PageController {
+    isDetached;
+    mustRemoveTrailingSlashs;
+    isServerSide = isServerSide;
+    usedKeys = new Set();
+    state;
+    serverRequest;
+    userInfos;
+    events = isServerSide ? jk_events.newEventGroup() : jk_events.defaultEventGroup;
+    objectRegistry = isServerSide ? new ObjectRegistry() : getDefaultObjectRegistry();
+    constructor(isDetached = false, mustRemoveTrailingSlashs = false, options) {
+        this.isDetached = isDetached;
+        this.mustRemoveTrailingSlashs = mustRemoveTrailingSlashs;
+        options = options || {};
+        this.state = { ...options };
+    }
+    /**
+     * Allow storing custom data inside the page context.
+     */
+    data = {};
+    //region ModuleInitContext_Host
+    /**
+     * Return the current page url.
+     * For server-side: correspond to the url of the request.
+     * For browser-side: is the navigateur url.
+     */
+    getCurrentURL() {
+        if (this.serverRequest) {
+            return this.serverRequest.urlInfos;
+        }
+        return new URL(window.location.href);
+    }
+    getUserInfos() {
+        if (isServerSide)
+            return this.userInfos;
+        if (!this.userInfos) {
+            this.userInfos = decodeUserInfosFromCookie();
+        }
+        return this.userInfos;
+    }
+    //endregion
+    //region Page options (header/props/...)
+    addToHeader(key, entry) {
+        if (this.isServerSide) {
+            if (!this.checkKey("h" + key))
+                return this;
+            if (!this.state.head)
+                this.state.head = [entry];
+            else
+                this.state.head.push(entry);
+        }
+        else {
+            // No browser-side support.
+            // Why? Because React router only replaces the body.
+        }
+        return this;
+    }
+    addToBodyBegin(key, entry) {
+        if (!this.checkKey("b" + key))
+            return this;
+        if (!this.state.bodyBegin)
+            this.state.bodyBegin = [entry];
+        else
+            this.state.bodyBegin.push(entry);
+        // Required to trigger a browser-side refresh of the body.
+        this.onStateUpdated(this.state);
+        return this;
+    }
+    addToBodyEnd(key, entry) {
+        if (!this.checkKey("e" + key))
+            return this;
+        if (!this.state.bodyEnd)
+            this.state.bodyEnd = [entry];
+        else
+            this.state.bodyEnd.push(entry);
+        // Required to trigger a browser-side refresh of the body.
+        this.onStateUpdated(this.state);
+        return this;
+    }
+    setHeadTagProps(key, value) {
+        if (this.isServerSide) {
+            if (!this.state.headProps)
+                this.state.headProps = {};
+            this.state.headProps[key] = value;
+        }
+        return this;
+    }
+    setHtmlTagProps(key, value) {
+        if (this.isServerSide) {
+            if (!this.state.htmlProps)
+                this.state.htmlProps = {};
+            this.state.htmlProps[key] = value;
+        }
+        return this;
+    }
+    setBodyTagProps(key, value) {
+        if (this.isServerSide) {
+            if (!this.state.bodyProps)
+                this.state.bodyProps = {};
+            this.state.bodyProps[key] = value;
+        }
+        return this;
+    }
+    setPageTitle(title) {
+        if (this.isServerSide) {
+            this.state.pageTitle = title;
+        }
+        else {
+            document.title = title;
+        }
+        return this;
+    }
+    checkKey(key) {
+        if (this.usedKeys.has(key)) {
+            return false;
+        }
+        this.usedKeys.add(key);
+        return true;
+    }
+    //endregion
+    refreshUserInfos() {
+        if (!isServerSide && isUserInfoCookieUpdated()) {
+            this.userInfos = decodeUserInfosFromCookie();
+            jk_events.sendEvent("user.infosUpdated");
+        }
+    }
+    logOutUser() {
+        if (!isServerSide) {
+            deleteCookie("authorization");
+        }
+        this.refreshUserInfos();
+    }
+    onStateUpdated(_state) {
+        // Will be dynamically replaced.
+    }
+    onRequireRefresh() {
+        // Will be dynamically replaced.
+    }
+}
+export class PageController_ExposePrivate extends PageController {
+    getOptions() {
+        return this.state;
+    }
+    setServerRequest(serverRequest) {
+        this.objectRegistry.registerObject("jopi.serverRequest", serverRequest);
+        this.serverRequest = serverRequest;
+        this.userInfos = decodeJwtToken(serverRequest.user_getJwtToken());
+    }
+    getServerRequest() {
+        return this.serverRequest;
+    }
+}
+// Use undefined, otherwise the value is common for all requests when doing SSR.
+export const PageContext = React.createContext(undefined);
+//# sourceMappingURL=pageController.js.map

package/dist/@ui/pageController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageController.js","sourceRoot":"","sources":["../../src/@ui/pageController.ts"],"names":[],"mappings":"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"}

package/dist/@ui/tools.d.ts

@@ -0,0 +1,24 @@
+export interface UiUserInfos {
+    id: string;
+    roles?: string[];
+    email?: string;
+    fullName?: string;
+    nickName?: string;
+    firstName?: string;
+    lastName?: string;
+    avatarUrl?: string;
+    [key: string]: any;
+}
+export declare function decodeJwtToken(jwtToken: string | undefined): UiUserInfos | undefined;
+export declare function isUserInfoCookieUpdated(): boolean;
+export declare function decodeUserInfosFromCookie(): UiUserInfos | undefined;
+export declare function setCookie(name: string, value: string, maxAge?: number): void;
+export declare function deleteCookie(name: string): void;
+/**
+ * Returns the value of the cookie.
+ * Works browser side and server side.
+ *
+ * @param name
+ *      The name of the cookie we want.
+ */
+export declare function decodeNavigatorCookie(name: string): string;