@htmlbricks/hb-sidebar-desktop 0.71.24 → 0.71.26

package/manifest.json

@@ -7,6 +7,19 @@
         "Events": {
           "additionalProperties": false,
           "properties": {
+            "languageChange": {
+              "additionalProperties": false,
+              "description": "Host updates `i18nlang` on `hb-layout` (or equivalent) and reloads copy.",
+              "properties": {
+                "code": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "code"
+              ],
+              "type": "object"
+            },
             "pageChange": {
               "additionalProperties": false,
               "properties": {
@@ -35,7 +48,8 @@
           },
           "required": [
             "pageChange",
-            "themeChange"
+            "themeChange",
+            "languageChange"
           ],
           "type": "object"
         },
@@ -125,6 +139,34 @@
               },
               "type": "array"
             },
+            "i18nlang": {
+              "description": "BCP-47 / app language code; should match one of `i18nlanguages[].code` when set.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "i18nlanguages": {
+              "anyOf": [
+                {
+                  "items": {
+                    "$ref": "#/definitions/I18nLanguageOption"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                },
+                {
+                  "const": "",
+                  "type": "string"
+                }
+              ],
+              "description": "Available UI languages (JSON string or array)."
+            },
             "id": {
               "type": "string"
             },
@@ -170,6 +212,23 @@
           },
           "type": "object"
         },
+        "I18nLanguageOption": {
+          "additionalProperties": false,
+          "description": "Entry for the sidebar language menu (from `hb-layout` → layouts → sidebar).",
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "label"
+          ],
+          "type": "object"
+        },
         "INavLink": {
           "additionalProperties": false,
           "properties": {
@@ -233,7 +292,7 @@
       }
     }
   },
-  "description": "Fixed-width desktop sidebar: optional company logo and title, header/footer slots, Bulma theme switch (light / dark / system), and a nav list built from hb-sidenav-link entries with optional JSON groups (Bulma layout, menu labels, light background). Parses navlinks and groups from strings; emits pageChange when a link selects a page and themeChange when the user picks a theme (host applies document hooks such as data-theme on html/body).",
+  "description": "Fixed-width desktop sidebar: optional company logo and title, header/footer slots, optional language menu (i18nlanguages + i18nlang) beside the Bulma theme switch (light / dark / system), and a nav list built from hb-sidenav-link entries with optional JSON groups (Bulma layout, menu labels, light background). Parses navlinks and groups from strings; emits pageChange when a link selects a page, themeChange when the user picks a theme (host applies document hooks such as data-theme on html/body), and languageChange { code } when a language is chosen (host updates i18nlang on hb-layout or equivalent).",
   "storybookArgs": {
     "companylogouri": {
       "control": {
@@ -283,6 +342,19 @@
     "themeChange": {
       "action": "themeChangeEvent"
     },
+    "languageChange": {
+      "action": "languageChangeEvent"
+    },
+    "i18nlang": {
+      "control": {
+        "type": "text"
+      }
+    },
+    "i18nlanguages": {
+      "control": {
+        "type": "text"
+      }
+    },
     "navpage": {
       "control": {
         "type": "text"
@@ -680,9 +752,59 @@
         "navpage": "settings",
         "enablefooter": "yes"
       }
+    },
+    {
+      "name": "sidebarWithLanguages",
+      "description": "Language dropdown (from i18nlanguages) next to the theme switch; emits languageChange with { code }. Host should set i18nlang when a language is picked.",
+      "data": {
+        "navlinks": [
+          {
+            "label": "Home",
+            "key": "home",
+            "icon": "house-door"
+          },
+          {
+            "label": "Dashboard",
+            "key": "dashboard",
+            "icon": "speedometer"
+          },
+          {
+            "label": "Settings",
+            "key": "settings",
+            "icon": "gear"
+          },
+          {
+            "label": "Users",
+            "key": "users",
+            "icon": "people-fill"
+          },
+          {
+            "label": "Stats",
+            "key": "stats",
+            "icon": "graph-up"
+          }
+        ],
+        "navpage": "home",
+        "enablethemeswitch": "yes",
+        "i18nlang": "it",
+        "i18nlanguages": [
+          {
+            "code": "it",
+            "label": "Italiano"
+          },
+          {
+            "code": "en",
+            "label": "English"
+          },
+          {
+            "code": "de",
+            "label": "Deutsch"
+          }
+        ]
+      }
     }
   ],
-  "iifeIntegrity": "sha384-wBLuiZuNMVVfCs4Nl3ia+01WI27TTH1hRju0R/3Q6CUuxJqv7XkXglApISSuYwvJ",
+  "iifeIntegrity": "sha384-3aEATj4LxlQ9ld2QfW78fppO018ZTJ2dkha224Ovq7+l1VldaabbuMlx8kficMUL",
   "dependencies": [
     {
       "name": "hb-sidenav-link",
@@ -708,5 +830,5 @@
   "size": {},
   "iifePath": "main.iife.js",
   "repoName": "@htmlbricks/hb-sidebar-desktop",
-  "version": "0.71.24"
+  "version": "0.71.26"
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@htmlbricks/hb-sidebar-desktop",
-  "version": "0.71.24",
+  "version": "0.71.26",
   "contributors": [],
-  "description": "Fixed-width desktop sidebar: optional company logo and title, header/footer slots, Bulma theme switch (light / dark / system), and a nav list built from hb-sidenav-link entries with optional JSON groups (Bulma layout, menu labels, light background). Parses navlinks and groups from strings; emits pageChange when a link selects a page and themeChange when the user picks a theme (host applies document hooks such as data-theme on html/body).",
+  "description": "Fixed-width desktop sidebar: optional company logo and title, header/footer slots, optional language menu (i18nlanguages + i18nlang) beside the Bulma theme switch (light / dark / system), and a nav list built from hb-sidenav-link entries with optional JSON groups (Bulma layout, menu labels, light background). Parses navlinks and groups from strings; emits pageChange when a link selects a page, themeChange when the user picks a theme (host applies document hooks such as data-theme on html/body), and languageChange { code } when a language is chosen (host updates i18nlang on hb-layout or equivalent).",
   "licenses": [
     {
       "type": "Apache-2.0",

package/types/webcomponent.type.d.json

@@ -74,6 +74,34 @@
           },
           "type": "array"
         },
+        "i18nlang": {
+          "description": "BCP-47 / app language code; should match one of `i18nlanguages[].code` when set.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "i18nlanguages": {
+          "anyOf": [
+            {
+              "items": {
+                "$ref": "#/definitions/I18nLanguageOption"
+              },
+              "type": "array"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            },
+            {
+              "const": "",
+              "type": "string"
+            }
+          ],
+          "description": "Available UI languages (JSON string or array)."
+        },
         "id": {
           "type": "string"
         },
@@ -119,6 +147,23 @@
       },
       "type": "object"
     },
+    "I18nLanguageOption": {
+      "additionalProperties": false,
+      "description": "Entry for the sidebar language menu (from `hb-layout` → layouts → sidebar).",
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "label"
+      ],
+      "type": "object"
+    },
     "INavLink": {
       "additionalProperties": false,
       "properties": {

package/types/webcomponent.type.d.ts

@@ -2,6 +2,9 @@ import type { INavLink } from "../../sidenav-link/types/webcomponent.type";
 
 export type ThemePreference = "light" | "dark" | "auto";
 
+/** Entry for the sidebar language menu (from `hb-layout` → layouts → sidebar). */
+export type I18nLanguageOption = { code: string; label: string };
+
 export type Component = {
   id?: string;
   style?: string;
@@ -15,6 +18,10 @@ export type Component = {
   enablethemeswitch?: "yes" | "no" | null | "" | undefined;
   /** Optional controlled value from the host (e.g. after persisting `themeChange`). */
   themepreference?: ThemePreference | null | "" | undefined;
+  /** BCP-47 / app language code; should match one of `i18nlanguages[].code` when set. */
+  i18nlang?: string | null | "" | undefined;
+  /** Available UI languages (JSON string or array). */
+  i18nlanguages?: I18nLanguageOption[] | string | null | "" | undefined;
   cookielawallowdecline?: "yes" | "no" | null | "" | undefined;
   cookielawlanguage?: string;
   cookielawuri4more?: string;
@@ -25,4 +32,6 @@ export type Events = {
   pageChange: { page: string };
   /** Host applies Bulma/document hooks (`data-theme` / `theme-*` on `html`/`body`) or ignores. */
   themeChange: { mode: ThemePreference };
+  /** Host updates `i18nlang` on `hb-layout` (or equivalent) and reloads copy. */
+  languageChange: { code: string };
 };

package/types/webcomponent_events.type.d.json

@@ -5,6 +5,19 @@
     "Events": {
       "additionalProperties": false,
       "properties": {
+        "languageChange": {
+          "additionalProperties": false,
+          "description": "Host updates `i18nlang` on `hb-layout` (or equivalent) and reloads copy.",
+          "properties": {
+            "code": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code"
+          ],
+          "type": "object"
+        },
         "pageChange": {
           "additionalProperties": false,
           "properties": {
@@ -33,7 +46,8 @@
       },
       "required": [
         "pageChange",
-        "themeChange"
+        "themeChange",
+        "languageChange"
       ],
       "type": "object"
     },