@hrbolek/uoisfrontend-template 0.6.0

package/src/RoleGQLModel/Pages/PageNavbar.jsx

@@ -0,0 +1,161 @@
+import Nav from 'react-bootstrap/Nav'
+import { ProxyLink, MyNavbar, useHash } from '@hrbolek/uoisfrontend-shared';
+
+import { LinkURI, VectorItemsURI } from '../Components'
+import { CreateLink } from '../Mutations/Create';
+import { UpdateLink } from '../Mutations/Update';
+import { NavDropdown } from 'react-bootstrap';
+import { AddRoleOnGroupButton } from '../Mutations/AddRoleonGroup';
+import { Link } from '../../../../_template/src/Base/Components';
+
+/**
+ * Allow to use HashContainer for determination which component at page will be rendered.
+ * That must be manually inserted at TemplatePageContent, usually this should be done 
+ * as children of TemplateLargeCard.
+ * <TemplateLargeCard>
+ *     <HashContainer>
+ *         <VectorA id="history"/>
+ *         <VectorB id="roles"/>
+ *         <VectorC id="graph"/>
+ *     </HashContainer>
+ * </TemplateLargeCard>
+ * it is usefull to define globally active "areas" like science, administration, teaching, ...
+ */
+const TemplatePageSegments = [
+    { segment: 'education', label: 'Výuka' },
+    { segment: 'reaserach', label: 'Tvůrčí činnost' },
+    { segment: 'administration', label: 'Organizační činnost' },
+    { segment: 'development', label: 'Rozvoj' },
+]
+
+/**
+ * A navigation button component that generates a URL based on the template's ID and a specific segment.
+ * The button uses a `ProxyLink` to navigate while preserving hash and query parameters.
+ *
+ * ### Features:
+ * - Dynamically constructs the URL with a hash fragment pointing to the specified segment.
+ * - Displays a label for the navigation link.
+ * - Integrates seamlessly with `ProxyLink` for enhanced navigation.
+ *
+ * @component
+ * @param {Object} props - The properties for the TitleNavButton component.
+ * @param {Object} props.template - The template object containing details about the template.
+ * @param {string|number} props.template.id - The unique identifier for the template.
+ * @param {string} props.segment - The segment to append as a hash fragment in the URL.
+ * @param {string} props.label - The text to display as the label for the navigation button.
+ *
+ * @returns {JSX.Element} A styled navigation button linking to the constructed URL.
+ *
+ * @example
+ * // Example 1: Basic usage with a template and segment
+ * const template = { id: 123 };
+ * const segment = "details";
+ * const label = "View Details";
+ *
+ * <TitleNavButton template={template} segment={segment} label={label} />
+ * // Resulting URL: `/ug/template/view/123#details`
+ *
+ * @example
+ * // Example 2: Different segment and label
+ * <TitleNavButton template={{ id: 456 }} segment="settings" label="Template Settings" />
+ * // Resulting URL: `/ug/template/view/456#settings`
+ */
+const TitleNavButton = ({ item, segment, label, ...props }) => {
+    // const urlbase = (segment) => `/templates/template/${segment}/${template?.id}`;
+    const urlbase = (segment) => `${LinkURI}${item?.id}#${segment}`;
+    return (
+        <Nav.Link as={"span"} {...props}>
+            {/* <ProxyLink to={urlbase(segment)}>{label}</ProxyLink> */}
+        </Nav.Link>
+    );
+};
+
+/**
+ * Renders the navigation bar for an Template page.
+ *
+ * This component uses a custom hook, `useHash()`, to determine the current hash
+ * and highlights the active segment. It displays a navigation bar (using MyNavbar)
+ * with several segments (e.g. "history", "roles", "graph"), each rendered as a 
+ * TitleNavButton. The segments are hardcoded in this component and only rendered 
+ * if an `template` object is provided.
+ *
+ * @component
+ * @param {Object} props - The component properties.
+ * @param {Object} props.template - The template entity object that provides context for the page.
+ * @param {string|number} props.template.id - The unique identifier for the template.
+ * @param {Function} props.onSearchChange - Callback function to handle changes in the search input.
+ *
+ * @returns {JSX.Element} The rendered TemplatePageNavbar component.
+ *
+ * @example
+ * // Example usage:
+ * const template = { id: 123, ... };
+ * <TemplatePageNavbar template={template} onSearchChange={handleSearchChange} />
+ */
+export const PageNavbar = ({ item, children, onSearchChange }) => {
+    // const [currentHash, setHash] = useHash(); // Use the custom hook to manage hash
+    const currentHash = "da"
+    return (
+        <div className='screen-only'>
+            <MyNavbar onSearchChange={onSearchChange} >
+                {item && TemplatePageSegments.map(({ segment, label }) => (
+                    <Nav.Item key={segment} >
+                        <TitleNavButton
+                            template={item}
+                            segment={segment}
+                            label={label}
+                            className={segment === currentHash ? "active" : ""} aria-current={segment === currentHash ? "page" : undefined}
+                        />
+                    </Nav.Item>
+                ))}
+                {children}
+            </MyNavbar>
+        </div>
+    );
+};
+
+export const MyNavDropdown = ({ item }) => {
+    const { __typename } = item || {}
+    const hasProperType = __typename === "RoleGQLModel"
+    return (
+        <NavDropdown title="Oprávnění">
+            <NavDropdown.Item as={ProxyLink} to={VectorItemsURI}>
+                Seznam všech oprávnění
+            </NavDropdown.Item>
+            
+            <NavDropdown.Divider />
+            
+            <NavDropdown.Item 
+                as={UpdateLink} 
+                item={item} 
+                disabled={!hasProperType}
+            >
+                Upravit aktuální
+            </NavDropdown.Item>
+            <NavDropdown.Item 
+                as={CreateLink} 
+                item={item} 
+                item={{
+                    name: "Nové oprávnění",
+                }}
+                disabled={!hasProperType}
+            >
+                Nové oprávnění
+            </NavDropdown.Item>
+            
+            <NavDropdown.Item 
+                as={AddRoleOnGroupButton} 
+                item={item} 
+                rbacitem={item}
+                item={{
+                    group: item,
+                    groupId: item?.id,
+                }}
+                disabled={(item?.__typename !== "GroupGQLModel")}
+            >
+                Nové oprávnění na <br/><Link item={item} />
+            </NavDropdown.Item>
+            
+        </NavDropdown>
+    )
+}

package/src/RoleGQLModel/Pages/PageReadItem.jsx

@@ -0,0 +1,28 @@
+import { useGQLEntityContext } from "../../../../_template/src/Base/Helpers/GQLEntityProvider"
+import { MediumCardScalars } from "../../../../_template/src/Base/Scalars/ScalarAttribute"
+import { MediumCardVectors } from "../../../../_template/src/Base/Vectors/VectorAttribute"
+import { LargeCard, LinkURI } from "../Components"
+import { ReadAsyncAction } from "../Queries"
+import { PageBase, PageItemBase } from "./PageBase"
+
+export const ReadItemURI = `${LinkURI}:id`
+
+export const PageReadItem = ({ children, queryAsyncAction=ReadAsyncAction, ...props }) => {
+    return (
+        <PageItemBase queryAsyncAction={queryAsyncAction}>
+            PageReadItem
+            <Read {...props} />
+        </PageItemBase>
+    )
+}
+
+const Read = ({...props}) => {
+    const { item } = useGQLEntityContext()
+    if (!item) return null
+    return (
+        <LargeCard item={item} {...props} >
+            <MediumCardScalars item={item} />
+            <MediumCardVectors item={item} />
+        </LargeCard>        
+    )    
+}

package/src/RoleGQLModel/Pages/PageUpdateItem.jsx

@@ -0,0 +1,25 @@
+import { LargeCard, LinkURI } from "../Components"
+import { ReadAsyncAction } from "../Queries"
+import { PageItemBase } from "./PageBase"
+import { UpdateBody } from "../Mutations/Update"
+import { useGQLEntityContext } from "../../../../_template/src/Base/Helpers/GQLEntityProvider"
+
+export const UpdateItemURI = `${LinkURI.replace('view', 'edit')}:id`
+
+export const PageUpdateItem = ({ children, queryAsyncAction=ReadAsyncAction, ...props }) => {
+    return (
+        <PageItemBase queryAsyncAction={queryAsyncAction}>
+            PageUpdateItem
+            <LargeCardFromContext {...props}/>
+        </PageItemBase>
+    )
+}
+
+const LargeCardFromContext = ({...props}) => {
+    const { item } = useGQLEntityContext()
+    return (
+        <LargeCard item={item}>
+            <UpdateBody {...props} />
+        </LargeCard>
+    )
+}

package/src/RoleGQLModel/Pages/PageVector.jsx

@@ -0,0 +1,83 @@
+
+import { ReadPageAsyncAction } from "../Queries"
+import { useInfiniteScroll } from "../../../../dynamic/src/Hooks/useInfiniteScroll"
+import { LinkURI } from "../Components"
+import { PageBase } from "./PageBase"
+import { Table } from "../Components/Table"
+import { Filter } from "../Components/Filter"
+import { FilterButton, ResetFilterButton } from "../../../../_template/src/Base/FormControls/Filter"
+import { useSearchParams } from "react-router"
+import { useEffect } from "react"
+import { useMemo } from "react"
+import { AsyncStateIndicator } from "../../../../_template/src/Base/Helpers/AsyncStateIndicator"
+import { Collapsible } from "../../../../_template/src/Base/FormControls/Collapsible"
+
+
+export const VectorItemsURI = LinkURI.replace('view', 'list')
+
+function safeParseWhere(sp, paramName = "where") {
+    const raw = sp.get(paramName);
+    if (!raw) return null;
+    try {
+        const obj = JSON.parse(raw);
+        return obj && typeof obj === "object" ? obj : null;
+    } catch {
+        return null;
+    }
+}
+
+// 
+const filterParameterName = "where"
+export const PageVector = ({ children, queryAsyncAction = ReadPageAsyncAction }) => {
+    
+    const [sp] = useSearchParams();
+
+    const whereFromUrl = useMemo(() => safeParseWhere(sp, filterParameterName), [sp.toString()]);
+
+    const { items, loading, error, hasMore, sentinelRef, loadMore, restart } = useInfiniteScroll(
+        {
+            asyncAction: queryAsyncAction,
+            actionParams: { skip: 0, limit: 30, where: whereFromUrl },
+            // reset: whereFromUrl
+        }
+    )
+
+    useEffect(() => {
+        const params = {skip: 0, limit: 30, where: whereFromUrl} 
+        restart(params)
+    }, [whereFromUrl]);
+
+    
+    return (
+        <PageBase>
+            <Collapsible 
+                className="form-control btn btn-outline-primary"
+                buttonLabelCollapsed="Zobrazit filtr"
+                buttonLabelExpanded="Skrýt filtr"
+            >
+                <Filter>
+                    <FilterButton 
+                        className="form-control btn btn-outline-success"
+                        paramName={filterParameterName}
+                    >
+                        Filtrovat
+                    </FilterButton>
+                    <ResetFilterButton 
+                        className="form-control btn btn-warning"
+                        paramName={filterParameterName}
+                    >
+                        Vymazat filtr
+                    </ResetFilterButton>
+                </Filter>
+            </Collapsible>
+
+            <Table data={items} />
+
+            <AsyncStateIndicator error={error}  loading={loading} text="Nahrávám další..." />
+
+            {hasMore && <div ref={sentinelRef} style={{ height: 80, backgroundColor: "lightgray" }} />}
+            {hasMore && <button className="btn btn-success form-control" onClick={() => loadMore()}>Více</button>}
+        </PageBase>
+    )
+}
+

package/src/RoleGQLModel/Pages/RouterSegment.jsx

@@ -0,0 +1,69 @@
+import { PageVector } from "./PageVector"
+import { PageUpdateItem } from "./PageUpdateItem"
+import { PageCreateItem } from "./PageCreateItem"
+import { PageReadItem } from "./PageReadItem"
+import { PageDeleteItem } from "./PageDeleteItem"
+
+import { CreateURI, DeleteURI, ListURI, ReadItemURI, UpdateURI, VectorItemsURI } from "../Components"
+
+/**
+ * Definice segmentů rout pro Template stránky.
+ *
+ * Každý objekt v tomto poli popisuje jednu trasu (route) v aplikaci:
+ *  - `path`: Stringová URL s parametrem `:id`, která identifikuje konkrétní instanci template entity.
+ *  - `element`: React komponenta, která se má renderovat při shodě s cestou.
+ *
+ * Pokud komponenta stránky podporuje children jako render funkci,
+ * všechny children předané přes router budou dostávat objekt:
+ *   - `template` — načtená entita podle `:id`
+ *   - `onChange` — callback pro změnu hodnoty pole
+ *   - `onBlur` — callback pro blur event (například při opuštění pole)
+ *
+ * @constant
+ * @type {Array<{ path: string, element: JSX.Element }>}
+ *
+ * @example
+ * // Tato route reaguje na URL jako "/template/123"
+ * {
+ *   path: "/template/:id",
+ *   element: <TemplatePage />
+ * }
+ *
+ * // Editační route: "/template/edit/123"
+ * {
+ *   path: "/template/edit/:id",
+ *   element: <TemplateEditPage />
+ * }
+ */
+export const RoleRouterSegments = [
+    {
+        path: CreateURI,
+        element: (<PageCreateItem />),
+    },
+    {
+        path: VectorItemsURI,
+        element: (<PageVector />),
+    },
+    {
+        path: ReadItemURI,
+        element: (<PageReadItem />),
+    },
+    {
+        path: UpdateURI,
+        element: (<PageUpdateItem />),
+    },   
+    {
+        path: DeleteURI,
+        element: (<PageDeleteItem />),
+    },   
+    
+    {
+        path: VectorItemsURI.replace("list", ":any"),
+        element: (<PageVector />),
+    },
+    {
+        path: ReadItemURI.replace("view", ":any"),
+        element: (<PageReadItem />),
+    }
+
+]

package/src/RoleGQLModel/Pages/index.js

@@ -0,0 +1,10 @@
+export * from './Page'
+export * from './PageBase'
+export * from './PageVector'
+
+export * from './PageCreateItem'
+export * from './PageUpdateItem'
+
+export * from './PageNavbar'
+export * from './RouterSegment'
+

package/src/RoleGQLModel/Queries/DeleteAsyncAction.jsx

@@ -0,0 +1,22 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared";
+import { LargeFragment } from "./Fragments";
+import { createAsyncGraphQLAction2 } from "../../../../dynamic/src/Core/createAsyncGraphQLAction2";
+
+const DeleteMutationStr = `
+mutation DeleteMutation($id: UUID!, $lastchange: DateTime!) {
+  result: roleDelete(
+    item : {id: $id, lastchange: $lastchange}
+  ) {
+    ... on RoleGQLModelDeleteError {
+      failed
+      msg
+      input
+      Entity {
+        ...Large
+      }
+    }
+  }
+}
+`
+const DeleteMutation = createQueryStrLazy(`${DeleteMutationStr}`, LargeFragment)
+export const DeleteAsyncAction = createAsyncGraphQLAction2(DeleteMutation)

package/src/RoleGQLModel/Queries/Fragments.jsx

@@ -0,0 +1,123 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared"
+
+const LinkFragmentStr = `
+fragment Link on RoleGQLModel {
+  __typename
+  id
+    lastchange
+    created
+    createdbyId
+    changedbyId
+    rbacobjectId
+    valid
+    deputy
+    startdate
+    enddate
+    roletypeId
+    userId
+    groupId
+    roletype { __typename id name }
+}
+`
+
+const MediumFragmentStr = `
+fragment Medium on RoleGQLModel {
+  ...Link
+
+    createdby { id __typename }
+    changedby { id __typename }
+    rbacobject { id __typename }
+
+    user { __typename id fullname }
+    group { __typename id name }
+
+  rbacobject {
+    ...RBRoles
+  }
+}
+`
+
+const LargeFragmentStr = `
+fragment Large on RoleGQLModel {
+  ...Medium
+  group {
+    __typename id name
+    roles {
+        __typename
+        id
+        created
+        lastchange
+        roletypeId
+        roletype { __typename id name }
+        userId
+        user { __typename id fullname }
+        groupId
+        group { __typename id name }
+        changedby { __typename id fullname }
+        createdby { __typename id fullname }
+    }
+  }
+}
+`
+
+const RoleFragmentStr = `
+fragment Role on RoleGQLModel {
+    __typename
+    id
+    lastchange
+    created
+    createdbyId
+    changedbyId
+    rbacobjectId
+    createdby { id __typename fullname}
+    changedby { id __typename fullname}
+    rbacobject { id __typename }
+    valid
+    deputy
+    startdate
+    enddate
+    roletypeId
+    userId
+    groupId
+    roletype { __typename id name }
+    user { __typename id fullname }
+    group { __typename id name }
+  }
+`
+
+const RBACFragmentStr = `
+fragment RBRoles on RBACObjectGQLModel {
+  __typename
+  id
+  currentUserRoles {
+    __typename
+    id
+    lastchange
+    valid
+    startdate
+    enddate
+    roletype {
+      __typename
+      id
+      name
+    }
+    group {
+      __typename
+      id
+      name
+      grouptype {
+        __typename
+        id
+        name
+      }
+    }
+  }
+}`
+
+export const RoleFragment = createQueryStrLazy(`${RoleFragmentStr}`)
+export const RBACFragment = createQueryStrLazy(`${RBACFragmentStr}`)
+
+export const LinkFragment = createQueryStrLazy(`${LinkFragmentStr}`)
+export const MediumFragment = createQueryStrLazy(`${MediumFragmentStr}`, LinkFragment, RBACFragment)
+export const LargeFragment = createQueryStrLazy(`${LargeFragmentStr}`, MediumFragment )
+  

package/src/RoleGQLModel/Queries/InsertAsyncAction.jsx

@@ -0,0 +1,45 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared";
+import { LargeFragment } from "./Fragments";
+import { createAsyncGraphQLAction2 } from "../../../../dynamic/src/Core/createAsyncGraphQLAction2";
+
+
+const InsertMutationStr = `
+mutation roleInsert(
+	$userId: UUID! # null, 
+	$groupId: UUID! # null, 
+	$roletypeId: UUID! # null, 
+	$id: UUID # null, 
+	$deputy: Boolean # null, 
+	$startdate: DateTime # null, 
+	$enddate: DateTime # null
+) {
+  roleInsert(
+	role: {
+	userId: $userId, 
+	groupId: $groupId, 
+	roletypeId: $roletypeId, 
+	id: $id, 
+	deputy: $deputy, 
+	startdate: $startdate, 
+	enddate: $enddate}
+  ) {
+    ... on RoleGQLModel { ...Large }
+    ... on RoleGQLModelInsertError { ...RoleGQLModelInsertError }
+  }
+}
+
+fragment RoleGQLModelInsertError on RoleGQLModelInsertError {
+  __typename
+  Entity {
+  ...Large
+}
+  msg
+  failed
+  code
+  location
+  input
+  }
+`
+
+const InsertMutation = createQueryStrLazy(`${InsertMutationStr}`, LargeFragment)
+export const InsertAsyncAction = createAsyncGraphQLAction2(InsertMutation)

package/src/RoleGQLModel/Queries/ReadAsyncAction.jsx

@@ -0,0 +1,45 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared";
+import { LargeFragment } from "./Fragments";
+import { createAsyncGraphQLAction2 } from "../../../../dynamic/src/Core/createAsyncGraphQLAction2";
+import { reduceToFirstEntity } from "../../../../dynamic/src/Store";
+
+const ReadQueryStr = `
+query roleById($id: UUID!) {
+  roleById(id: $id) {
+  ...Large
+}
+}
+`
+
+const ReadQuery = createQueryStrLazy(`${ReadQueryStr}`, LargeFragment)
+
+/**
+ * An async action for executing a GraphQL query to read  entities.
+ *
+ * This action is created using `createAsyncGraphQLAction` with a predefined `QueryRead` query.
+ * It can be dispatched with query variables to fetch data related to  entities from the GraphQL API.
+ *
+ * @constant
+ * @type {Function}
+ *
+ * @param {Object} query_variables - The variables for the GraphQL query.
+ * @param {string|number} query_variables.id - The unique identifier for the  entity to fetch.
+ *
+ * @returns {Function} A dispatchable async action that performs the GraphQL query, applies middleware, and dispatches the result.
+ *
+ * @throws {Error} If `query_variables` is not a valid JSON object.
+ *
+ * @example
+ * // Example usage:
+ * const queryVariables = { id: "12345" };
+ *
+ * dispatch(ReadAsyncAction(queryVariables))
+ *   .then((result) => {
+ *     console.log("Fetched data:", result);
+ *   })
+ *   .catch((error) => {
+ *     console.error("Error fetching data:", error);
+ *   });
+ */
+// export const ReadAsyncAction = createAsyncGraphQLAction2(ReadQuery, reduceToFirstEntity("result"))
+export const ReadAsyncAction = createAsyncGraphQLAction2(ReadQuery)

package/src/RoleGQLModel/Queries/ReadPageAsyncAction.jsx

@@ -0,0 +1,13 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared";
+import { LargeFragment } from "./Fragments";
+import { createAsyncGraphQLAction2 } from "../../../../dynamic/src/Core/createAsyncGraphQLAction2";
+
+const ReadPageQueryStr = `
+query ReadPageQuery($skip: Int, $limit: Int, $where: RoleInputWhereFilter) {
+  result: rolePage(skip: $skip, limit: $limit, where: $where) {
+    ...Large
+  }
+}
+`
+const ReadPageQuery = createQueryStrLazy(`${ReadPageQueryStr}`, LargeFragment)
+export const ReadPageAsyncAction = createAsyncGraphQLAction2(ReadPageQuery)

package/src/RoleGQLModel/Queries/UpdateAsyncAction.jsx

@@ -0,0 +1,35 @@
+import { createQueryStrLazy } from "@hrbolek/uoisfrontend-gql-shared";
+import { LargeFragment } from "./Fragments";
+import { createAsyncGraphQLAction2 } from "../../../../dynamic/src/Core/createAsyncGraphQLAction2";
+import { reduceToFirstEntity, updateItemsFromGraphQLResult } from "../../../../dynamic/src/Store";
+
+const UpdateMutationStr = `
+mutation userUpdate($id: UUID!, $lastchange: DateTime!) {
+  roleUpdate(
+    role: {id: $id, lastchange: $lastchange}
+  ) {
+    ... on RoleGQLModel {
+      ...Large
+    }
+    ... on RoleGQLModelUpdateError {
+      ...Error
+    }
+  }
+}
+
+fragment Error on UserGQLModelUpdateError {
+  __typename
+  Entity {
+    ...Large
+  }
+  msg
+  failed
+  code
+  location
+  input
+}
+`
+
+const UpdateMutation = createQueryStrLazy(`${UpdateMutationStr}`, LargeFragment)
+export const UpdateAsyncAction = createAsyncGraphQLAction2(UpdateMutation, 
+    updateItemsFromGraphQLResult, reduceToFirstEntity)

package/src/RoleGQLModel/Queries/index.js

@@ -0,0 +1,6 @@
+
+export { InsertAsyncAction } from './InsertAsyncAction'
+export { UpdateAsyncAction } from './UpdateAsyncAction'
+export { DeleteAsyncAction } from './DeleteAsyncAction'
+export { ReadAsyncAction } from './ReadAsyncAction'
+export { ReadPageAsyncAction } from './ReadPageAsyncAction'