@ebrains/components 0.2.0-alpha.0 → 0.3.0-alpha.0

package/dist/esm/eds-card-desc_3.entry.js

@@ -0,0 +1,111 @@
+import { r as registerInstance, h } from './index-e96badea.js';
+import { c as cva } from './index-39c58238.js';
+
+const edsCardDescCss = ".f-ui-02-light{font-family:var(--f-ui-02-light-fontFamily);font-weight:var(--f-ui-02-light-fontWeight);font-size:var(--f-ui-02-light-fontSize);line-height:var(--f-ui-02-light-lineHeight);letter-spacing:var(--f-ui-02-light-letterSpacing)}.f-ui-03-light{font-family:var(--f-ui-03-light-fontFamily);font-weight:var(--f-ui-03-light-fontWeight);font-size:var(--f-ui-03-light-fontSize);line-height:var(--f-ui-03-light-lineHeight);letter-spacing:var(--f-ui-03-light-letterSpacing)}.text-light{color:var(--grey-700)}.line-clamp-1{overflow:hidden;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:1}.line-clamp-2{overflow:hidden;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2}.line-clamp-3{overflow:hidden;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:3}.line-clamp-4{overflow:hidden;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:4}";
+const EdsCardDescStyle0 = edsCardDescCss;
+
+const EdsCardDesc = class {
+    constructor(hostRef) {
+        registerInstance(this, hostRef);
+        this.description = undefined;
+        this.descClass = 'f-ui-03-light';
+        this.truncate = true;
+        this.truncateLines = '3';
+    }
+    getTruncateClass() {
+        return this.truncate && this.truncateLines ? `line-clamp-${this.truncateLines}` : '';
+    }
+    render() {
+        return (h("p", { key: '017c115ebff999c74cff1eaeb5c63f97e0f6554d', class: `text-light ${this.descClass}` }, h("span", { key: 'f87b9b3d593e417ef351882f426d24c0b206ccab', class: this.getTruncateClass() }, this.description)));
+    }
+};
+EdsCardDesc.style = EdsCardDescStyle0;
+
+const edsCardTitleCss = "a{all:unset;display:inline;color:inherit;text-decoration:none;cursor:pointer}h1,h2,h3,h4,h5,h6{margin:0}.f-heading-01{font-family:var(--f-heading-01-fontFamily);font-weight:var(--f-heading-01-fontWeight);font-size:var(--f-heading-01-fontSize);line-height:var(--f-heading-01-lineHeight);letter-spacing:var(--f-heading-01-letterSpacing)}.f-heading-02{font-family:var(--f-heading-02-fontFamily);font-weight:var(--f-heading-02-fontWeight);font-size:var(--f-heading-02-fontSize);line-height:var(--f-heading-02-lineHeight);letter-spacing:var(--f-heading-02-letterSpacing)}.f-heading-03{font-family:var(--f-heading-03-fontFamily);font-weight:var(--f-heading-03-fontWeight);font-size:var(--f-heading-03-fontSize);line-height:var(--f-heading-03-lineHeight);letter-spacing:var(--f-heading-03-letterSpacing)}.f-heading-04{font-family:var(--f-heading-04-fontFamily);font-weight:var(--f-heading-04-fontWeight);font-size:var(--f-heading-04-fontSize);line-height:var(--f-heading-04-lineHeight);letter-spacing:var(--f-heading-04-letterSpacing)}.f-heading-05{font-family:var(--f-heading-05-fontFamily);font-weight:var(--f-heading-05-fontWeight);font-size:var(--f-heading-05-fontSize);line-height:var(--f-heading-05-lineHeight);letter-spacing:var(--f-heading-05-letterSpacing)}.f-heading-06{font-family:var(--f-heading-06-fontFamily);font-weight:var(--f-heading-06-fontWeight);font-size:var(--f-heading-06-fontSize);line-height:var(--f-heading-06-lineHeight);letter-spacing:var(--f-heading-06-letterSpacing)}.break-words{overflow-wrap:break-word}.after\\:absolute::after{position:absolute}.after\\:inset-0::after{inset:0rem}.after\\:z-10::after{z-index:10}.after\\:content-\\[\\'\\'\\]::after{--tw-content:'';content:var(--tw-content)}.focus\\:outline-none:focus{outline:2px solid transparent;outline-offset:2px}";
+const EdsCardTitleStyle0 = edsCardTitleCss;
+
+const EdsCardTitle = class {
+    constructor(hostRef) {
+        registerInstance(this, hostRef);
+        this.url = undefined;
+        this.titleClass = undefined;
+        this.headingLevel = 'h3';
+        this.externalLink = false;
+        this.cardTitle = undefined;
+        this.hierarchy = true;
+    }
+    /**
+     * Dynamically generate the title class based on the heading level.
+     */
+    getTitleClass() {
+        const levelMap = this.hierarchy
+            ? {
+                h1: '05',
+                h2: '05',
+                h3: '05',
+                h4: '05',
+                h5: '05',
+                h6: '06'
+            }
+            : {
+                h1: '01',
+                h2: '02',
+                h3: '03',
+                h4: '04',
+                h5: '05',
+                h6: '06'
+            };
+        return `f-heading-${levelMap[this.headingLevel]}`;
+    }
+    /*private getTag() {
+      if (this.url) {
+        return 'a';
+      }
+      return 'span';
+    }*/
+    render() {
+        //const Tag = this.getTag();
+        const Heading = this.headingLevel;
+        return (h(Heading, { key: '8aee3bcb0e04508dd21a03ea0f695e040f37c767', class: this.getTitleClass() }, h("a", { key: 'c5fa27fe86037ed6b039c156aecdf1acc9c7c8bc', class: "break-words after:absolute after:inset-0 after:z-10 after:content-[''] focus:outline-none", href: this.url, target: this.externalLink ? '_blank' : undefined, rel: this.externalLink ? 'noopener noreferrer' : undefined }, this.cardTitle)));
+    }
+};
+EdsCardTitle.style = EdsCardTitleStyle0;
+
+const edsTagCss = ".f-ui-05{font-family:var(--f-ui-05-fontFamily);font-weight:var(--f-ui-05-fontWeight);font-size:var(--f-ui-05-fontSize);line-height:var(--f-ui-05-lineHeight);letter-spacing:var(--f-ui-05-letterSpacing)}.py-1{padding-top:0.0625rem;padding-bottom:0.0625rem}.px-4{padding-left:0.25rem;padding-right:0.25rem}.border-2{border-width:2px}.rounded-pill{border-radius:100px}.border-default{border:2px solid var(--black)}.text-inverse{color:var(--white)}.bg-strongest{background-color:var(--black)}.text-\\[\\#0034CB\\]{--tw-text-opacity:1;color:rgb(0 52 203 / var(--tw-text-opacity))}.border-\\[\\#0034CB\\]{--tw-border-opacity:1;border:2px solid rgb(0 52 203 / var(--tw-border-opacity))}.text-light{color:var(--grey-700)}.bg-strongest-soft{background-color:rgba(0, 0, 0, .05)}.border-transparent{border-color:var(--transparent)}.border-inverse{border-color:var(--white)}.bg-inverse{background-color:var(--white)}.text-lighter{color:var(--grey-600)}";
+const EdsTagStyle0 = edsTagCss;
+
+// Define the CVA for the tag styles
+const tagStyles = cva(['f-ui-05 py-1 px-4 border-2 rounded-pill'], // Base classes
+{
+    variants: {
+        intent: {
+            default: 'border-default',
+            strong: 'text-inverse bg-strongest border-default',
+            accent: 'text-[#0034CB] border-[#0034CB]',
+            weak: 'text-light bg-strongest-soft border-transparent',
+            inverse: 'border-inverse text-inverse',
+            'inverse-strong': 'bg-inverse border-inverse text-lighter'
+        }
+    },
+    defaultVariants: {
+        intent: 'default'
+    }
+});
+const EdsTag = class {
+    constructor(hostRef) {
+        registerInstance(this, hostRef);
+        this.label = undefined;
+        this.intent = 'default';
+    }
+    /**
+     * Render the component.
+     * @returns The rendered HTML for the tag component with the applied styles and label.
+     */
+    render() {
+        const classes = tagStyles({ intent: this.intent });
+        return h("span", { key: '546bd7eb2c78760edc12cd7bb3ede5f6ab9099f3', class: classes }, this.label);
+    }
+};
+EdsTag.style = EdsTagStyle0;
+
+export { EdsCardDesc as eds_card_desc, EdsCardTitle as eds_card_title, EdsTag as eds_tag };

package/dist/esm/eds-card-generic.entry.js

@@ -0,0 +1,101 @@
+import { r as registerInstance, h, g as getElement } from './index-e96badea.js';
+import { s as sendAnalytics } from './color-0ba8ed56.js';
+import './index-39c58238.js';
+
+const edsCardGenericCss = ".h-auto{height:auto}.h-full{height:100%}.\\!min-h-20{min-height:1.25rem !important}.min-h-120{min-height:120px}.min-h-156{min-height:156px}.bg-default{background-color:var(--grey-200)}.bg-inverse{background-color:var(--white)}.effect-shadow{transition-property:box-shadow;transition-timing-function:cubic-bezier(0.4, 0, 0.2, 1);transition-duration:300ms;transition-timing-function:cubic-bezier(0, 0, 0.2, 1)}.hover\\:shadow-hover:hover{--tw-shadow:0px 0px 16px rgba(0, 0, 0, 0.2);--tw-shadow-colored:0px 0px 16px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)}.cursor-pointer{cursor:pointer}.border-soft{border-color:rgba(0, 0, 0, .15 )}.border-softer{border:2px solid rgba(0, 0, 0, .1 )}.effect-focus-within{outline-width:3px;outline-offset:2px;outline-color:var(--green-500)}.effect-focus-within:focus-within{outline-style:solid}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inline{display:inline}.flex{display:flex}.inline-flex{display:inline-flex}.grow{flex-grow:1}.flex-col{flex-direction:column}.rounded-lg{border-radius:16px}.border-2{border-width:2px}.p-12{padding:0.75rem}.p-16{padding:1rem}.mt-6{margin-top:0.375rem}.mt-8{margin-top:0.5rem}.gap-y-4{row-gap:0.25rem}.order-first{order:-9999}.mb-10{margin-bottom:0.625rem}.mb-12{margin-bottom:0.75rem}";
+const EdsCardGenericStyle0 = edsCardGenericCss;
+
+const EdsCardGeneric = class {
+    constructor(hostRef) {
+        registerInstance(this, hostRef);
+        this.parentContext = null; // Accepts the entire event detail or null
+        this.cardTitle = undefined;
+        this.url = undefined;
+        this.description = undefined;
+        this.image = undefined;
+        this.avatar = undefined;
+        this.shortAbbreviation = undefined;
+        this.headingLevel = 'h3';
+        this.tags = '';
+        this.tiny = false;
+        this.bg = true;
+        this.withHover = true;
+        this.hierarchy = true;
+        this.parsedImage = null;
+    }
+    componentWillLoad() {
+        if (this.image) {
+            try {
+                if (typeof this.image === 'object') {
+                    // If image is already an object, assign it directly
+                    this.parsedImage = this.image;
+                }
+                else if (typeof this.image === 'string') {
+                    // If image is a string, try to parse it
+                    this.parsedImage = JSON.parse(this.image);
+                }
+            }
+            catch (error) {
+                // eslint-disable-next-line
+                console.error('Error parsing image prop:', error);
+                this.parsedImage = {}; // Assign a fallback empty object in case of an error
+            }
+        }
+    }
+    handleParentContext(event) {
+        if (event.target !== this.el) {
+            // Ignore the event if it's not targeted at this specific instance
+            return;
+        }
+        //console.log(event.detail);
+        this.parentContext = event.detail;
+        event.stopPropagation();
+    }
+    /**
+     * Parses the `tags` prop into an array of link objects.
+     * Returns an empty array if parsing fails or if `tags` is not a valid JSON string or object.
+     *
+     * @returns {any[]} Array of parsed link objects
+     */
+    get parsedTags() {
+        if (typeof this.tags === 'object') {
+            return this.tags;
+        }
+        else if (typeof this.tags === 'string') {
+            try {
+                return JSON.parse(this.tags);
+            }
+            catch (e) {
+                // eslint-disable-next-line
+                console.error('Error parsing tags prop:', e);
+                return [];
+            }
+        }
+        return [];
+    }
+    articleClasses() {
+        return [
+            this.description ? (this.tiny ? 'min-h-120' : 'min-h-156') : 'h-auto',
+            this.bg ? 'bg-inverse' : 'bg-default',
+            this.withHover ? 'effect-shadow hover:shadow-hover cursor-pointer' : '',
+            'border-softer effect-focus-within relative flex grow flex-col rounded-lg border-2 p-16'
+        ].join(' ');
+    }
+    handleClick() {
+        var _a;
+        sendAnalytics({
+            category: 'ui-component',
+            parentContext: this.parentContext,
+            tag: this.el.tagName.toLowerCase(),
+            name: ((_a = this.cardTitle) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || '',
+            action: 'click'
+        });
+    }
+    render() {
+        return (h("article", { key: '17d1f00f232a4436756fa3846684bbae8c716036', class: this.articleClasses(), onClick: () => this.handleClick() }, h("eds-card-title", { key: 'd99ee1716c4e308a3ea446f0f7cedfaeac30f2ed', "heading-level": this.headingLevel, titleClass: this.image ? 'f-ui-01' : undefined, "card-title": this.cardTitle, url: this.url, hierarchy: this.hierarchy }), this.description && (h("eds-card-desc", { key: 'c5bdc76e68a8d660609630aa8184ec3a9508ab61', class: "mt-8", "truncate-lines": "3", description: this.description })), this.parsedImage ? (h("eds-img", Object.assign({ class: "mt-8" }, this.parsedImage))) : this.avatar || this.shortAbbreviation ? (h("eds-avatar", { class: "order-first mb-12", picture: this.avatar, initials: this.shortAbbreviation })) : null, h("div", { key: 'fa993e3c60d357eb0d9a63e612bdd2bf026e7a85', class: "flex flex-wrap gap-y-4" }, this.parsedTags.map((tag, index) => (h("eds-tag", { key: index, intent: tag.style, label: tag.label })))), ' '));
+    }
+    get el() { return getElement(this); }
+};
+EdsCardGeneric.style = EdsCardGenericStyle0;
+
+export { EdsCardGeneric as eds_card_generic };

package/dist/esm/eds-card-section.entry.js

@@ -16,13 +16,24 @@ const EdsCardSection = class {
      * @returns {any[]} An array of parsed card objects.
      */
     get parsedCards() {
-        try {
-            return JSON.parse(this.cards);
+        // If it's already an array, return it immediately.
+        if (Array.isArray(this.cards)) {
+            return this.cards;
         }
-        catch (e) {
-            //console.error('Error parsing links JSON', e);
-            return [];
+        if (typeof this.cards === 'object') {
+            return this.cards;
         }
+        else if (typeof this.cards === 'string') {
+            try {
+                return JSON.parse(this.cards);
+            }
+            catch (e) {
+                // eslint-disable-next-line
+                console.error('Error parsing links prop:', e);
+                return [];
+            }
+        }
+        return [];
     }
     /**
      * Renders the card section as a grid layout.
@@ -32,7 +43,7 @@ const EdsCardSection = class {
      * @returns {JSX.Element} The rendered section containing a list of cards.
      */
     render() {
-        return (h("section", { key: 'f8e6a03e37677623fad3c53327f6260920a5e914', class: "w-full" }, h("ul", { key: '1da1bc3a5aecadd52b4d025d7d02dc252e47b34a', class: "grid-layout gap-y-8 md:gap-y-12 lg:gap-y-16" }, this.parsedCards.map((card) => (h("li", { class: `grid-col-span-12 md:grid-col-span-${this.cols} flex flex-col` }, h("eds-card-generic", { cardTitle: card.title, description: card.description, avatar: card.avatar, headingLevel: card.headingLevel, tags: card.tags, url: card.url, bg: card.bg, tiny: card.tiny, image: card.image, withHover: card.withHover })))))));
+        return (h("section", { key: 'c02b0e71ae4658e2f568e9428a9c61455aeb8ccd', class: "w-full" }, h("ul", { key: '7f5d952d5cc5044c2ec23ca6b6b627901c40ab81', class: "grid-layout gap-y-8 md:gap-y-12 lg:gap-y-16" }, this.parsedCards.map((card) => (h("li", { class: `grid-col-span-12 md:grid-col-span-${this.cols} flex flex-col` }, h("eds-card-generic", { cardTitle: card.title, description: card.description, avatar: card.avatar, headingLevel: card.headingLevel, tags: card.tags, url: card.url, bg: card.bg, tiny: card.tiny, image: card.image, withHover: card.withHover })))))));
     }
 };
 EdsCardSection.style = EdsCardSectionStyle0;

package/dist/esm/eds-components-section.entry.js

@@ -1,54 +1,76 @@
 import { h, r as registerInstance } from './index-e96badea.js';
 
 const EdsComponentsOverview = () => (h("div", { class: "static-content container" },
-    h("eds-alert", { message: "EBRAINS Design System makes it easy to implement and use its components across any framework or no framework at all. We\n      accomplish this by using standardized web platform APIs and Web Components.", intent: "default" }),
     h("h2", null, "Load the module"),
     h("p", null,
         "Integrating EDSs components to a project without a JavaScript framework is straight forward. If you\u2019re working on a simple HTML page, you can start using the components immediately by adding the tags below to the",
         ' ',
         h("code", null, "head"),
         "."),
-    h("eds-code-block", { code: '<script type="module" href="https://unpkg.com/@ebrains/components@0.0.1/loader"/></script>', language: "javascript", "copy-label": "Copy Code" }),
+    h("eds-code-block", { code: "<script type='module'>\n  import { defineCustomElements } from 'https://unpkg.com/@ebrains/components@latest/loader/index.js'; \n  // Define custom elements\n  defineCustomElements(window);\n</script>", language: "javascript", "copy-label": "Copy Code" }),
     h("h2", null, "Load the styles"),
     h("p", null,
         "To directly use the produced css framework with a few predefined custom utility classes, add the tag below to the",
         ' ',
         h("code", null, "head")),
-    h("eds-code-block", { code: '<link rel="stylesheet" href="https://unpkg.com/@ebrains/assets@0.0.1/styles/output.css"/>', language: "css", "copy-label": "Copy Code" }),
+    h("eds-code-block", { code: '<link rel="stylesheet" href="https://unpkg.com/@ebrains/assets@latest/styles/output.css"/>', language: "css", "copy-label": "Copy Code" }),
+    h("div", { class: "my-4" },
+        h("eds-alert", { message: "Note that, loading the predefined CSS framework above, automatically loads the fonts so you can skip loading them separately.", intent: "warning" })),
     h("h2", null, "Load the fonts"),
     h("p", null,
-        "To load the correct webfonts as well, add either one of these tags to the ",
+        "To load the webfonts, add the tag below to the ",
         h("code", null, "head")),
     h("eds-code-block", { code: '<link rel="stylesheet" href="https://unpkg.com/@ebrains/assets@0.0.1/styles/base/fonts.css"/>', language: "css", "copy-label": "Copy Code" }),
     h("h2", null, "Component Usage"),
     h("p", null, "Once included, components can be used in your markup like any other regular HTML elements:"),
-    h("eds-code-block", { code: '<eds-button label="my bytton" intent="primary"></eds-button>', language: "html", "copy-label": "Copy Code" })));
+    h("eds-code-block", { code: '<eds-button \n  label="my bytton" \n  intent="primary">\n</eds-button>', language: "html", "copy-label": "Copy Code" })));
 
 const EdsDocsInstallation = () => (h("div", null,
-    h("p", null, "To start using the EBRAINS Design System, include the following scripts and styles in your project. You can also install it via npm for use with modern build tools."),
-    h("eds-code-block", { code: "npm install @ebrains/components", language: "html", "copy-label": "Copy Code" }),
-    h("p", null, "TBD")));
-
-const EdsDocsUsage = () => (h("div", null,
-    h("h1", null, "Usage with basic HTML "),
-    h("p", null, "TBD")));
+    h("p", null, "Before proceeding, ensure that Node.js is installed on your machine\u2014you can download the latest version from the official website. If your project doesn\u2019t already use npm and you plan to integrate EBRAINS Components, you'll need to create a package.json file by running npm init and following the on-screen instructions."),
+    h("div", { class: "my-8" },
+        h("eds-code-block", { code: "npm install @ebrains/components", language: "html", "copy-label": "Copy Code" })),
+    h("div", { class: "my-8" },
+        h("eds-code-block", { code: "npm install @ebrains/assets", language: "html", "copy-label": "Copy Code" })),
+    h("div", { class: "my-8" },
+        h("eds-code-block", { code: "npm install @ebrains/react", language: "html", "copy-label": "Copy Code" }))));
 
 const EdsDocsReact = () => (h("div", null,
     h("h2", null, "React Wrappers"),
-    h("p", null, "Learn how to use our components in a React Application."),
-    "Simple install the package below and check out the examples",
-    h("eds-code-block", { code: "npm install @ebrains/react", language: "javascript", "copy-label": "Copy Code" }),
+    h("p", null, "Learn how to use our components in a React Application.Simple install the package below and check out the examples"),
+    h("div", { class: "my-8" },
+        h("eds-code-block", { code: "npm install @ebrains/react", language: "javascript", "copy-label": "Copy Code" })),
     h("eds-section-core", { "section-title": "Example React App", "heading-level": "h3" },
-        h("eds-code-block", { code: '\nimport { EdsHeader } from "@ebrains/react";\n\ninterface User {\n  firstname: string;\n  lastname: string;\n  // Add any other properties your user object might have\n}\n\ninterface AuthStatus {\n  authenticated: boolean;\n  user: User | null;\n}\n\nimport { useEffect, useState } from "react";\n\nexport function App() {\n\n  const [authStatus, setAuthStatus] = useState<AuthStatus>({\n    authenticated: false,\n    user: null,\n  });\n  \n  const [activeTabIndex, setActiveTabIndex] = useState<number>(0);\n\n  // Use useEffect to render Stencil components dynamically after the component mounts\n  useEffect(() => {\n    \n    const handleAuthStatusChange = (event: CustomEvent) => {\n      console.log(event.detail);\n      setAuthStatus(event.detail); // Set the entire object\n    };\n\n    const handleTabChange = (\n      event: CustomEvent<{ index: number; name: string }>,\n    ) => {\n      console.log(event.detail);\n      setActiveTabIndex(event.detail.index);\n    };\n\n    document.addEventListener(\n      "authStatusChanged",\n      handleAuthStatusChange as EventListener,\n    );\n    document.addEventListener("tabChange", handleTabChange as EventListener);\n\n    return () => {\n      document.removeEventListener(\n        "authStatusChanged",\n        handleAuthStatusChange as EventListener,\n      );\n      document.removeEventListener(\n        "tabChange",\n        handleTabChange as EventListener,\n      );\n    };\n  }, []); // Empty dependency array ensures this runs only once after mounting\n\n  return (\n    <div id="main">\n      <EdsHeader\n        home-url="/"\n        user-feature={false}\n        keycloak-url="http://localhost:8080"\n        keycloak-realm="nigeor-realm"\n        keycloak-client-id="stencil-app"\n        links="[\n            { "label": "About", "url": "/about" },\n            { "label": "Focus Areas", "url": "/focus-areas" },\n            { "label": "News & Events", "url": "/news-and-events" },\n            { "label": "Contact", "url": "/contact" }\n          ]"\n      ></EdsHeader>\n\n      <div> \n        User is{" "} {authStatus.authenticated ? "authenticated" : "not authenticated"}\n      </div>\n      {authStatus.user && <div>Welcome, {authStatus.user.firstname}</div>}\n      </div>\n    </div>\n  );\n}\n\nexport default App;\n', language: "javascript", "copy-label": "Copy Code" }))));
+        h("eds-code-block", { code: '\nimport { EdsHeader } from "@ebrains/react";\n\ninterface User {\n  firstname: string;\n  lastname: string;\n}\n\ninterface AuthStatus {\n  authenticated: boolean;\n  user: User | null;\n}\n\nimport { useEffect, useState } from "react";\n\nexport function App() {\n\n  const [authStatus, setAuthStatus] = useState<AuthStatus>({\n    authenticated: false,\n    user: null,\n  });\n  \n  const [activeTabIndex, setActiveTabIndex] = useState<number>(0);\n\n  // Use useEffect to render Stencil components dynamically after the component mounts\n  useEffect(() => {\n    \n    const handleAuthStatusChange = (event: CustomEvent) => {\n      console.log(event.detail);\n      setAuthStatus(event.detail); // Set the entire object\n    };\n\n    const handleTabChange = (\n      event: CustomEvent<{ index: number; name: string }>,\n    ) => {\n      console.log(event.detail);\n      setActiveTabIndex(event.detail.index);\n    };\n\n    document.addEventListener(\n      "authStatusChanged",\n      handleAuthStatusChange as EventListener,\n    );\n    document.addEventListener("tabChange", handleTabChange as EventListener);\n\n    return () => {\n      document.removeEventListener(\n        "authStatusChanged",\n        handleAuthStatusChange as EventListener,\n      );\n      document.removeEventListener(\n        "tabChange",\n        handleTabChange as EventListener,\n      );\n    };\n  }, []); // Empty dependency array ensures this runs only once after mounting\n\n  return (\n    <div id="main">\n      <EdsHeader\n        home-url="/"\n        user-feature={false}\n        keycloak-url="http://localhost:8080"\n        keycloak-realm="nigeor-realm"\n        keycloak-client-id="stencil-app"\n        links="[\n            { "label": "About", "url": "/about" },\n            { "label": "Focus Areas", "url": "/focus-areas" },\n            { "label": "News & Events", "url": "/news-and-events" },\n            { "label": "Contact", "url": "/contact" }\n          ]"\n      ></EdsHeader>\n\n      <div> \n        User is{" "} {authStatus.authenticated ? "authenticated" : "not authenticated"}\n      </div>\n      {authStatus.user && <div>Welcome, {authStatus.user.firstname}</div>}\n      </div>\n    </div>\n  );\n}\n\nexport default App;\n', language: "javascript", "copy-label": "Copy Code" }))));
 
 const EdsDocsVue = () => (h("div", null,
     h("h2", null, "Vue Wrappers"),
     h("p", null, "Learn how to use our components in a Vue Application."),
+    h("p", null, "Simply install the latest version of our NPM package."),
     h("eds-code-block", { code: "npm install @ebrains/vue", language: "javascript", "copy-label": "Copy Code" }),
-    h("p", null, "Define the custom elements"),
+    h("p", null, "Our NPM package already includes the custom elements definitions. However, you can use the components as they are by simply importing and executing the initialization command in your \"main.ts\" file."),
     h("eds-code-block", { code: "import { defineCustomElements } from '@ebrains/components/loader';\ndefineCustomElements();", language: "javascript", "copy-label": "Copy Code" }),
+    h("h2", null,
+        "Passing Properties to Custom Elements Using the ",
+        h("b", null, ".prop"),
+        " Modifier in Vue Wrappers"),
+    h("p", null, "When using Vue wrappers for Stencil components (or any custom elements), you might encounter issues with property names being altered due to HTML\u2019s attribute handling. By default, Vue binds values as HTML attributes, and HTML attributes are case-insensitive. This means that camelCase property names can be transformed into lowercase strings, which can prevent your component from receiving the correct data."),
+    h("h3", null,
+        "How to Use the ",
+        h("b", null, ".prop"),
+        " Modifier"),
+    h("p", null, "When using Vue wrappers, you can pass properties with the .prop modifier by adding it to your binding expression. Here\u2019s an example of how to do it:"),
+    h("div", { class: "mt-8" },
+        h("eds-alert", { message: "This may lead to issues because Vue binds these as attributes .", intent: "error" })),
+    h("eds-code-block", { code: '<EdsAlert\n  message="This is a default informational alert."\n  intent="default"\n  :pressableLabel="Press Me"\n  :pressableUrl="https://ebrains.eu"\n></EdsAlert>', language: "javascript", "copy-label": "Copy Code" }),
+    h("div", { class: "mt-8" },
+        h("eds-alert", { message: "Use the .prop modifier to ensure properties are passed correctly.", intent: "success" })),
+    h("eds-code-block", { code: '<EdsAlert\n  message="This is a default informational alert."\n  intent="default"\n  :pressableLabel.prop="Press Me"\n  :pressableUrl.prop="https://ebrains.eu"\n></EdsAlert>', language: "javascript", "copy-label": "Copy Code" }),
+    h("p", null,
+        "Using the ",
+        h("b", null, ".prop"),
+        " modifier in Vue ensures that the data you pass to your custom elements is received as intended. It prevents Vue (and the browser) from transforming camelCase property names into lowercase attributes, thereby maintaining the correct data mapping in your Stencil components."),
     h("eds-section-core", { "section-title": "Example Vue App", "heading-level": "h3" },
-        h("eds-code-block", { code: '\n<template>\n  <h1 className="f-heading-02">Vue App</h1>\n\n  <EdsHeader \n    home-url="/" \n    user-feature=false \n    keycloak-url="http://localhost:8080" \n    keycloak-realm="nigeor-realm"\n    keycloak-client-id="stencil-app" \n    links="[\n      { "label": "About", "url": "/about" },\n      { "label": "Focus Areas", "url": "/focus-areas" },\n      { "label": "News & Events", "url": "/news-and-events" },\n      { "label": "Contact", "url": "/contact" }\n    ]">\n  </EdsHeader>\n\n</template>\n\n<script>\n\nimport { EdsHeader } from "@ebrains/vue";\n\nexport default {\n  name: "App",\n  components: {\n    EdsHeader,\n  }\n};\n</script>\n', language: "javascript", "copy-label": "Copy Code" }))));
+        h("eds-code-block", { code: '\n<template>\n  <EdsHeader \n    :inverseHeader.prop="true"\n    :menuEnabled.prop="true">\n  </EdsHeader>\n</template>\n\n<script>\n\nimport { EdsHeader } from "@ebrains/vue";\n\nexport default {\n  name: "App",\n  components: {\n    EdsHeader,\n  }\n};\n</script>\n', language: "javascript", "copy-label": "Copy Code" }))));
 
 const EdsDocsAngular = () => (h("div", null,
     h("h2", null, "Angular Wrappers"),
@@ -59,7 +81,7 @@ const EdsDocsAngular = () => (h("div", null,
     h("p", null, "Angular Custom Elements Schema"),
     h("eds-code-block", { code: 'import { CUSTOM_ELEMENTS_SCHEMA } from "@angular/core";', language: "javascript", "copy-label": "Copy Code" }),
     h("eds-section-core", { "section-title": "Example Angular App", "heading-level": "h3" },
-        h("eds-code-block", { code: '\n<div class="container">\n  <h1 class="f-heading-01">{{ title }}</h1>\n  <eds-breadcrumb\n    intent="tertiary"\n    items="[\n      { "label": "Home", "url": "#" },\n      { "label": "Products", "url": "#" },\n    ]">\n  </eds-breadcrumb>\n  <eds-footer></eds-footer>\n</div>', language: "javascript", "copy-label": "Copy Code" }))));
+        h("eds-code-block", { code: '\n<div class="container">\n  <eds-breadcrumb\n    intent="tertiary"\n    items="[\n      { "label": "Home", "url": "#" },\n      { "label": "Products", "url": "#" },\n    ]">\n  </eds-breadcrumb>\n  <eds-footer></eds-footer>\n</div>', language: "javascript", "copy-label": "Copy Code" }))));
 
 const EdsComponentsSection = class {
     constructor(hostRef) {
@@ -73,19 +95,17 @@ const EdsComponentsSection = class {
             case 1:
                 return h(EdsDocsInstallation, null);
             case 2:
-                return h(EdsDocsUsage, null);
-            case 3:
                 return h(EdsDocsReact, null);
-            case 4:
+            case 3:
                 return h(EdsDocsVue, null);
-            case 5:
+            case 4:
                 return h(EdsDocsAngular, null);
             default:
                 return h("p", null, "Content not available.");
         }
     }
     render() {
-        return h("div", { key: 'faa14dc7bb5d966ea1328f60d8ca88b3c406ad51', class: "container" }, this.renderContent());
+        return h("div", { key: 'ce34514ab73daa5baa011bda56a13d6197f8bfd0', class: "container" }, this.renderContent());
     }
 };
 

package/dist/esm/eds-docs-palettes.entry.js

@@ -16,7 +16,7 @@ const EdsDocsPalettes = class {
         }
     }
     render() {
-        return h("div", { key: 'c11e0de66c41770e7ebca46d3fb7ab11b454511e', class: "container" }, this.renderContent());
+        return h("div", { key: '42f0a4598c64661d98054522e88366ec591a2cb3', class: "container" }, this.renderContent());
     }
 };
 

package/dist/esm/eds-docs-tokens.entry.js

@@ -24,7 +24,7 @@ const EdsDocsContent = class {
         }
     }
     render() {
-        return h("div", { key: 'ef9cf093af7bc730b73f3561b36187f70aea29a7', class: "container" }, this.renderContent());
+        return h("div", { key: '10708d591c4077e4e1fe94073322f01121253bdb', class: "container" }, this.renderContent());
     }
 };