@hrbolek/uoisfrontend-template 0.6.0

package/src/_Template/Mutations/Delete.jsx

@@ -0,0 +1,173 @@
+import { DeleteItemURI, ListURI, MediumContent, VectorItemsURI } from "../Components";
+import { DeleteAsyncAction } from "../Queries";
+import { 
+    DeleteBody as BaseDeleteBody, 
+    DeleteButton as BaseDeleteButton, 
+    DeleteDialog as BaseDeleteDialog, 
+    DeleteLink as BaseDeleteLink
+} from "../../../../_template/src/Base/Mutations/Delete";
+
+const DefaultContent = MediumContent
+const MutationAsyncAction = DeleteAsyncAction
+
+const permissions = {
+    oneOfRoles: ["superadmin"],
+    mode: "absolute",
+}
+
+/**
+ * Link na delete route pro konkrétní entitu.
+ *
+ * Wrapper nad `BaseDeleteLink`. Nastavuje výchozí `uriPattern` pro delete route a aplikuje RBAC
+ * přes `permissions`. Ostatní props přeposílá do Base komponenty.
+ *
+ * @param {Object} params
+ * @param {string} [params.uriPattern=DeleteItemURI]
+ *   URI pattern pro delete route (typicky obsahuje `:id` nebo odpovídá routování aplikace).
+ * @param {Object} params.props
+ *   Další props přeposílané do `BaseDeleteLink` (např. `children`, `className`,
+ *   `preserveSearch`, `preserveHash`, atd.).
+ *
+ * @returns {JSX.Element}
+ */
+export const DeleteLink = ({ 
+    uriPattern=DeleteItemURI,
+    ...props
+ }) => {
+    return (
+        <BaseDeleteLink 
+            {...props} 
+            uriPattern={uriPattern} 
+            {...permissions}
+        />
+    )
+};
+
+/**
+ * Tlačítko pro smazání entity (obvykle otevře confirm dialog a spustí delete mutaci).
+ *
+ * Wrapper nad `BaseDeleteButton`. Dodává výchozí `DefaultContent`, `mutationAsyncAction`
+ * a `vectorItemsURI` (kam se naviguje po úspěšném smazání, pokud není použit `onOk`).
+ *
+ * Chování navigace / callback:
+ * - Pokud je definované `onOk`, použije se pro “feedback”, že mazání proběhlo (tj. uživatel si
+ *   rozhodne, co dál).
+ * - Pokud `onOk` definované není, Base implementace typicky naviguje na `vectorItemsURI`.
+ *
+ * @param {Object} params
+ * @param {Function} [params.mutationAsyncAction=MutationAsyncAction]
+ *   Async action (thunk) pro delete operaci (např. DeleteAsyncAction).
+ *
+ * @param {React.ComponentType<Object>} [params.DefaultContent=MediumContent]
+ *   Komponenta pro zobrazení mazáné entity v confirm dialogu (read-only).
+ *
+ * @param {string} [params.vectorItemsURI=ListURI]
+ *   URI pro návrat po úspěšném smazání (typicky list stránka / kolekce).
+ *
+ * @param {Function} [params.onOk]
+ *   Callback po úspěšném smazání. Pokud není zadán, Base implementace typicky použije navigaci na `vectorItemsURI`.
+ *
+ * @param {Object}} params.props
+ *   Další props přeposílané do `BaseDeleteButton` (např. `children`, `title`, `className`,
+ *   `rbacitem`, `item`, `disabled`, atd. – podle Base/General implementace).
+ *
+ * @returns {JSX.Element}
+ */
+export const DeleteButton = ({
+    mutationAsyncAction=MutationAsyncAction,
+    DefaultContent:DefaultContent_=DefaultContent,
+    Dialog=DeleteDialog,
+    vectorItemsURI=ListURI,
+    onOk,
+    ...props 
+}) => {
+    return (
+        <BaseDeleteButton 
+            {...props} 
+            DefaultContent={DefaultContent_} 
+            Dialog={Dialog}
+            mutationAsyncAction={mutationAsyncAction}
+            vectorItemsURI={vectorItemsURI}
+            onOk={onOk}
+            {...permissions}
+        />
+    )
+}
+
+/**
+ * Confirm dialog pro smazání entity.
+ *
+ * Wrapper nad `BaseDeleteDialog`. Dodává výchozí `DefaultContent` (read-only zobrazení entity),
+ * `mutationAsyncAction` a `vectorItemsURI` pro návrat po úspěchu (dle Base/General implementace).
+ *
+ * @param {Object} params
+ * @param {Function} [params.mutationAsyncAction=MutationAsyncAction]
+ *   Async action (thunk) pro delete operaci (např. DeleteAsyncAction).
+ *
+ * @param {React.ComponentType<Object>} [params.DefaultContent=MediumContent]
+ *   Komponenta pro zobrazení mazáné entity (read-only).
+ *
+ * @param {string} [params.vectorItemsURI=ListURI]
+ *   URI pro návrat po úspěšném smazání (typicky list stránka / kolekce).
+ *
+ * @param {Object}} params.props
+ *   Další props přeposílané do `BaseDeleteDialog` (např. `title`, `oklabel`, `cancellabel`,
+ *   `item`, `onOk`, `onCancel`, atd.).
+ *
+ * @returns {JSX.Element}
+ */
+export const DeleteDialog = ({
+    mutationAsyncAction=MutationAsyncAction,
+    DefaultContent:DefaultContent_=DefaultContent,
+    vectorItemsURI=ListURI,
+    ...props 
+}) => {
+    return (
+        <BaseDeleteDialog 
+            {...props} 
+            DefaultContent={DefaultContent_} 
+            mutationAsyncAction={mutationAsyncAction}
+            vectorItemsURI={vectorItemsURI}
+            {...permissions}
+        />
+    )
+}
+
+/**
+ * “Page-level” delete workflow (mazání na celé stránce / v těle stránky).
+ *
+ * Wrapper nad `BaseDeleteBody`. Dodává výchozí `DefaultContent`, `mutationAsyncAction`
+ * a `vectorItemsURI` a aplikuje RBAC přes `permissions`.
+ *
+ * @param {Object} params
+ * @param {Function} [params.mutationAsyncAction=MutationAsyncAction]
+ *   Async action (thunk) pro delete operaci (např. DeleteAsyncAction).
+ *
+ * @param {React.ComponentType<Object>} [params.DefaultContent=MediumContent]
+ *   Komponenta pro zobrazení mazáné entity (read-only).
+ *
+ * @param {string} [params.vectorItemsURI=ListURI]
+ *   URI pro návrat po úspěšném smazání (typicky list stránka / kolekce).
+ *
+ * @param {Object}} params.props
+ *   Další props přeposílané do `BaseDeleteBody` (např. `title`, `oklabel`, `cancellabel`,
+ *   `item`, `onOk`, `onCancel`, atd.).
+ *
+ * @returns {JSX.Element}
+ */
+export const DeleteBody = ({ 
+    mutationAsyncAction=MutationAsyncAction,
+    DefaultContent:DefaultContent_=DefaultContent,
+    vectorItemsURI=ListURI,
+    ...props
+}) => {
+    return (
+        <BaseDeleteBody 
+            {...props} 
+            DefaultContent={DefaultContent_} 
+            mutationAsyncAction={mutationAsyncAction}
+            vectorItemsURI={vectorItemsURI}
+            {...permissions}
+        />
+    )
+}

package/src/_Template/Mutations/InteractiveMutations.jsx

@@ -0,0 +1,30 @@
+import { CardCapsule, VectorItemsURI } from "../Components"
+import { CreateButton, CreateLink } from "./Create"
+import { UpdateButton, UpdateLink } from "./Update"
+import { ProxyLink } from "../../../../_template/src/Base/Components/ProxyLink"
+import { DeleteButton } from "./Delete"
+
+export const PageLink = ({ children, preserveHash = true, preserveSearch = true, ...props }) => {
+    return (
+        <ProxyLink
+            to={VectorItemsURI}
+            preserveHash={preserveHash}
+            preserveSearch={preserveSearch}
+            {...props}
+        >
+            {children}
+        </ProxyLink>
+    );
+};
+
+export const InteractiveMutations = ({ item }) => {
+    return (
+        <CardCapsule item={item} title="Nástroje">
+            <PageLink className="btn btn-outline-success">Stránka</PageLink>
+            <UpdateLink className="btn btn-outline-success" item={item}>Upravit</UpdateLink>
+            <UpdateButton className="btn btn-outline-success" item={item}>Upravit Dialog</UpdateButton>
+            <CreateButton className="btn btn-outline-success" rbacitem={{}}>Vytvořit nový</CreateButton>
+            <DeleteButton className="btn btn-outline-danger" item={item}>Odstranit</DeleteButton>
+        </CardCapsule>
+    )
+}

package/src/_Template/Mutations/Update.jsx

@@ -0,0 +1,147 @@
+import {
+    UpdateBody as BaseUpdateBody,
+    UpdateButton as BaseUpdateButton,
+    UpdateDialog as BaseUpdateDialog,
+    UpdateLink as BaseUpdateLink
+} from "../../../../_template/src/Base/Mutations/Update";
+
+import { MediumEditableContent, UpdateItemURI } from "../Components";
+import { UpdateAsyncAction } from "../Queries";
+
+const DefaultContent = (props) => <MediumEditableContent {...props} />
+const mutationAsyncAction = UpdateAsyncAction
+
+const permissions = {
+    oneOfRoles: ["superadmin"],
+    mode: "absolute",
+}
+
+// ALTERNATIVE, CHECK GQLENDPOINT
+// const permissions = {
+//     oneOfRoles: ["administrátor", "personalista"],
+//     mode: "item",
+// }
+
+/**
+ * Link na update stránku / update route pro konkrétní entitu.
+ *
+ * Wrapper nad `BaseUpdateLink`. Nastavuje výchozí `uriPattern` a aplikuje RBAC
+ * přes `permissions`. Vše ostatní přeposílá do Base komponenty.
+ *
+ * @param {Object} params
+ * @param {string} [params.uriPattern=UpdateItemURI]
+ *   URI pattern pro update route (typicky obsahuje `:id` nebo je již konkrétní URL dle routování).
+ * @param {Object} params.props
+ *   Další props přeposílané do `BaseUpdateLink` (např. `children`, `className`,
+ *   `preserveSearch`, `preserveHash`, atd.).
+ * @returns {JSX.Element}
+ */
+export const UpdateLink = ({
+    uriPattern = UpdateItemURI,
+    ...props
+}) => {
+    return <BaseUpdateLink
+        {...props}
+        uriPattern={uriPattern}
+        {...permissions}
+    />
+}
+
+/**
+ * Dialog pro editaci entity.
+ *
+ * Wrapper nad `BaseUpdateDialog`. Dodává výchozí editovatelný obsah (`DefaultContent`)
+ * a výchozí mutační akci (`mutationAsyncAction`) pro uložení změn. Aplikuje RBAC
+ * přes `permissions`.
+ *
+ * @param {Object} params
+ * @param {React.ComponentType<Object>} [params.DefaultContent=DefaultContent]
+ *   Komponenta, která vykreslí editovatelný obsah dialogu (typicky MediumEditableContent).
+ * @param {Function} [params.mutationAsyncAction=mutationAsyncAction]
+ *   Async action (thunk) pro uložení změn (např. UpdateAsyncAction). Použije se podle Base/General implementace.
+ * @param {Object} params.props
+ *   Další props přeposílané do `BaseUpdateDialog` (např. `title`, `oklabel`, `cancellabel`,
+ *   `item`, `onOk`, `onCancel`, atd.).
+ * @returns {JSX.Element}
+ */
+export const UpdateDialog = ({
+    DefaultContent: DefaultContent_ = DefaultContent,
+    mutationAsyncAction: mutationAsyncAction_ = mutationAsyncAction,
+    ...props
+}) => {
+    return (
+        <BaseUpdateDialog
+            {...props}
+            DefaultContent={DefaultContent_}
+            mutationAsyncAction={mutationAsyncAction_}
+            {...permissions}
+        />
+    );
+};
+
+/**
+ * Tlačítko, které otevře update dialog a provede uložení.
+ *
+ * Wrapper nad `BaseUpdateButton`. Dodává výchozí `DefaultContent`, výchozí `Dialog`,
+ * a výchozí `mutationAsyncAction`. Aplikuje RBAC přes `permissions`.
+ *
+ * @param {Object} params
+ * @param {React.ComponentType<Object>} [params.DefaultContent=DefaultContent]
+ *   Komponenta editovatelného obsahu (typicky MediumEditableContent).
+ * @param {React.ComponentType<Object>} [params.Dialog=UpdateDialog]
+ *   Dialog komponenta použitá pro editaci (volá `onOk(draft)` / `onCancel()`).
+ * @param {Function} [params.mutationAsyncAction=mutationAsyncAction]
+ *   Async action (thunk) pro uložení změn (např. UpdateAsyncAction).
+ * @param {Object} params.props
+ *   Další props přeposílané do `BaseUpdateButton` (např. `children`, `className`, `title`,
+ *   `item`, `uriPattern`, `onOk`, `onCancel`, atd.).
+ * @returns {JSX.Element}
+ */
+export const UpdateButton = ({
+    DefaultContent: DefaultContent_ = DefaultContent,
+    Dialog = UpdateDialog,
+    mutationAsyncAction: mutationAsyncAction_ = mutationAsyncAction,
+    ...props
+}) => {
+    return (
+        <BaseUpdateButton
+            {...props}
+            DefaultContent={DefaultContent_}
+            Dialog={Dialog}
+            mutationAsyncAction={mutationAsyncAction_}
+            {...permissions}
+        />
+    );
+};
+
+/**
+ * “Page-level” update workflow (inline edit / celá stránka editace).
+ *
+ * Wrapper nad `BaseUpdateBody`. Typicky vykreslí editovatelný obsah (`DefaultContent`)
+ * a zajistí uložení přes `mutationAsyncAction` (dle Base/General implementace).
+ * Aplikuje RBAC přes `permissions`.
+ *
+ * @param {Object} params
+ * @param {React.ComponentType<Object>} [params.DefaultContent=DefaultContent]
+ *   Komponenta editovatelného obsahu (typicky MediumEditableContent).
+ * @param {Function} [params.mutationAsyncAction=mutationAsyncAction]
+ *   Async action (thunk) pro uložení změn (např. UpdateAsyncAction).
+ * @param {Object} params.props
+ *   Další props přeposílané do `BaseUpdateBody` (např. `title`, `oklabel`, `cancellabel`,
+ *   `item`, `onOk`, `onCancel`, `className`, atd.).
+ * @returns {JSX.Element}
+ */
+export const UpdateBody = ({
+    DefaultContent: DefaultContent_ = DefaultContent,
+    mutationAsyncAction: mutationAsyncAction_ = mutationAsyncAction,
+    ...props
+}) => {
+    return (
+        <BaseUpdateBody
+            {...props}
+            DefaultContent={DefaultContent_}
+            mutationAsyncAction={mutationAsyncAction_}
+            {...permissions}
+        />
+    );
+};

package/src/_Template/Mutations/helpers.jsx

@@ -0,0 +1,7 @@
+export const makeMutationURI = (linkURI, action, { withId = false } = {}) => {
+    const viewSegmentRe = /\/view(\/|$)/;
+    if (!viewSegmentRe.test(linkURI)) throw new Error(`LinkURI must contain '/view'. Got: ${linkURI}`);
+
+    const base = linkURI.replace(viewSegmentRe, `/${action}$1`).replace(/\/?$/, "/");
+    return withId ? `${base}:id` : base.replace(/\/$/, "");
+};

package/src/_Template/Pages/PageBase.jsx

@@ -0,0 +1,56 @@
+import { ReadAsyncAction } from "../Queries"
+import { PageItemBase as PageItemBase_} from "../../../../_template/src/Base/Pages/Page"
+import { LargeCard } from "../Components"
+
+
+/**
+ * Base wrapper pro stránky pracující s jedním entity itemem podle `:id` z routy.
+ *
+ * Komponenta:
+ * - načte `id` z URL přes `useParams()`
+ * - sestaví minimální `item` objekt `{ id }`
+ * - poskytne jej přes `AsyncActionProvider`, který zajistí načtení entity pomocí `queryAsyncAction`
+ * - vloží do stránky navbar přes `PlaceChild Component={PageNavbar}`
+ * - vyrenderuje `children` uvnitř provideru (tj. až v kontextu načtené entity)
+ *
+ * Typické použití je jako obálka routy typu `/.../:id`, kde vnořené komponenty
+ * (detail, editace, akce) používají kontext z `AsyncActionProvider`.
+ *
+ * @component
+ * @param {object} props
+ * @param {import("react").ReactNode} props.children
+ *   Obsah stránky, který se má vyrenderovat uvnitř `AsyncActionProvider`.
+ * @param {Function} [props.queryAsyncAction=ReadAsyncAction]
+ *   Async action (např. thunk) použitá pro načtení entity z GraphQL endpointu.
+ *   Dostane `item` s `id` (a případně další parametry podle implementace provideru).
+ *
+ * @returns {import("react").JSX.Element}
+ *   Provider s navigací (`PageNavbar`) a obsahem stránky (`children`).
+ */
+export const PageItemBase = ({ 
+    queryAsyncAction=ReadAsyncAction,
+    PageNavbar=()=>null,
+    ItemLayout=LargeCard,
+    SubPage=null,
+    ...props
+}) => {
+    return (
+        <PageItemBase_ 
+            queryAsyncAction={queryAsyncAction} 
+            PageNavbar={PageNavbar}
+            ItemLayout={ItemLayout}
+            SubPage={SubPage}
+            {...props} 
+        />  
+    )
+}
+
+
+export const PageBase = ({ children, PageNavbar=()=>null }) => {
+    return (
+        <>
+            <PageNavbar />
+            {children}
+        </>
+    )
+}

package/src/_Template/Pages/PageCreateItem.jsx

@@ -0,0 +1,28 @@
+import { ReadAsyncAction } from "../Queries"
+import { Row } from "../../../../_template/src/Base/Components/Row";
+import { CreateBody } from "../Mutations/Create";
+import { LeftColumn, MiddleColumn } from "@hrbolek/uoisfrontend-shared";
+import { PageItemBase } from "./PageBase";
+
+
+
+const PageBody = ({...props}) => (
+    <Row>
+        <LeftColumn />
+        <MiddleColumn>
+            <CreateBody {...props} />
+        </MiddleColumn>
+    </Row>
+)
+
+export const PageCreateItem = ({ 
+    SubPage=PageBody,
+    ...props
+}) => {
+    return (
+        <PageItemBase 
+            SubPage={SubPage}
+            {...props}
+        />
+    )
+}

package/src/_Template/Pages/PageDeleteItem.jsx

@@ -0,0 +1,16 @@
+import { PageItemBase } from "./PageBase";
+import { DeleteBody } from "../Mutations/Delete";
+
+export const PageDeleteItem = ({ 
+    SubPage=DeleteBody,
+    ...props
+}) => {
+    return (
+        <PageItemBase
+            SubPage={SubPage}
+            {...props}
+        />
+         
+    )
+}
+

package/src/_Template/Pages/PageNavbar.jsx

@@ -0,0 +1,160 @@
+import Nav from 'react-bootstrap/Nav'
+import { Link, LinkURI } from '../Components'
+import { ProxyLink } from '../../../../_template/src/Base/Components/ProxyLink';
+import { NavDropdown } from 'react-bootstrap';
+import { UpdateLink } from '../Mutations/Update';
+import { CreateButton } from '../Mutations/Create';
+
+/**
+ * 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 === "TemplateGQLModel"
+    return (
+        <NavDropdown title="Skupiny">
+            <NavDropdown.Item as={ProxyLink} to={VectorItemsURI}>
+                Seznam všech 
+            </NavDropdown.Item>
+            
+            <NavDropdown.Item as={Link} item={item} action="roles" disabled={!hasProperType}>
+                Role<br/><Link item={item} />
+            </NavDropdown.Item>
+            <NavDropdown.Item as={Link} item={item} action="subgroups" disabled={!hasProperType}>
+                Podskupiny<br/><Link item={item} />
+            </NavDropdown.Item>
+            <NavDropdown.Item as={Link} item={item} action="memberships" disabled={!hasProperType}>
+                Členové<br/><Link item={item} />
+            </NavDropdown.Item>
+        
+        
+            <NavDropdown.Divider />
+            
+            <NavDropdown.Item 
+                as={UpdateLink} 
+                item={item}
+                disabled={!hasProperType} 
+            >
+                Upravit<br/><Link item={item} />
+            </NavDropdown.Item>
+            <NavDropdown.Item 
+                as={CreateButton} 
+                item={item} 
+                disabled={!hasProperType} 
+                item={{
+                    group: item,
+                    groupId: item?.groupId
+                }}
+            >
+                Nové<br/><Link item={item} />
+            </NavDropdown.Item>
+            
+            <NavDropdown.Divider />
+            <NavDropdown.Item as={ProxyLink} to={`/generic/${item?.__typename}/__def/${item?.id}`} reloadDocument={false}>Definice</NavDropdown.Item >
+        </NavDropdown>
+    )
+}

package/src/_Template/Pages/PageReadItem.jsx

@@ -0,0 +1,11 @@
+import { GeneratedContentBase } from "../../../../_template/src/Base/Pages/Page"
+import { PageItemBase } from "./PageBase"
+
+export const PageReadItem = ({ 
+    SubPage=GeneratedContentBase,
+    ...props
+}) => {
+    return (
+        <PageItemBase SubPage={SubPage} {...props}/>
+    )
+}

package/src/_Template/Pages/PageReadItemEx.jsx

@@ -0,0 +1,42 @@
+import { GeneratedContentBase } from "../../../../_template/src/Base/Pages/Page"
+import { ReadItemURI } from "../Components"
+import { ReadAsyncAction } from "../Queries"
+import { PageReadItem } from "./PageReadItem"
+
+export const RolesOnURI = ReadItemURI.replace("view", "roleson")
+
+
+/**
+ * Základní obálka pro „read“ stránku entity podle `:id` z routy.
+ *
+ * Využívá `PageItemBase`, který zajistí:
+ * - získání `id` z URL (`useParams`)
+ * - načtení entity přes `AsyncActionProvider` pomocí `queryAsyncAction`
+ * - vložení navigace (`PageNavbar`)
+ *
+ * Uvnitř provideru vykreslí `ReadWithComponent`, který si vezme načtený `item`
+ * z `useGQLEntityContext()` a zobrazí ho v zadané komponentě (defaultně `LargeCard`).
+ *
+ * @component
+ * @param {object} props
+ * @param {Function} [props.queryAsyncAction=ReadAsyncAction]
+ *   Async action (např. thunk) pro načtení entity z backendu/GraphQL dle `id`.
+ * @param {Object<string, any>} [props]
+ *   Další props předané do `ReadWithComponent` (např. `Component`, layout props).
+ *
+ * @returns {import("react").JSX.Element}
+ */
+export const PageReadItemRolesOn = ({ 
+    queryAsyncAction=ReadAsyncAction, 
+    children, 
+    ...props 
+}) => {
+    return (
+        <PageReadItem 
+            queryAsyncAction={queryAsyncAction}
+            SubPage={GeneratedContentBase} 
+            {...props}
+        />
+    )
+}
+