@qld-gov-au/qgds-bootstrap5 2.1.9 → 2.1.11

package/dist/components/bs5/directionLinks/directionLinks.hbs

@@ -5,6 +5,5 @@
     {{~#if target}} target="{{target}}"{{/if~}}
     {{~#if arialabel}} aria-label="{{arialabel}}" {{/if~}}>
   {{{label}}}
-  {{!-- <span class="icon" aria-hidden="true"></span> --}}
   <span class="qld-icon qld-icon-md qld-icon-arrow-{{class}}" aria-hidden="true"></span>
 </a>

package/dist/components/bs5/head/head.hbs

@@ -1,5 +1,5 @@
 
-<!-- VERSION_DETAILS={"project_id":"@qld-gov-au/qgds-bootstrap5","version":"2.1.9","branch":"HEAD","tag":"v2.1.9","commit":"228f45b9dea4dd6674147c93a086038ac167746f","majorVersion":"v2"} -->
+<!-- VERSION_DETAILS={"project_id":"@qld-gov-au/qgds-bootstrap5","version":"2.1.11","branch":"HEAD","tag":"v2.1.11","commit":"5a3e313339341709791de452b0963964578103a8","majorVersion":"v2"} -->
 
 {{! Select environment, used verbatium if not using predefind key
 cdn := PROD|STAGING|BETA|TEST|DEV|???

package/dist/components/bs5/pagination/pagination.hbs

@@ -1,10 +1,3 @@
-{{!
-Component Name: QGDS QOL Pagination
-Component Version: 1.0
-Framework: Bootstrap 5.3
-Reference: https://getbootstrap.com/docs/5.0/components/pagination/
-}}
-
 <nav aria-label="{{ arialabel }}">
 
     <ul class="pagination">

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qld-gov-au/qgds-bootstrap5",
-  "version": "2.1.9",
+  "version": "2.1.11",
   "description": "",
   "repository": {
     "type": "git",
@@ -55,10 +55,11 @@
     "bootstrap": "^5.3.8"
   },
   "devDependencies": {
-    "@chromatic-com/storybook": "^4.1.3",
+    "@chromatic-com/storybook": "^5.0.0",
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/json": "^0.14.0",
+    "@eslint/json": "^1.0.0",
     "@qld-gov-au/qgds-tokens": "^1.2.1",
+    "@vitejs/plugin-react": "^5.1.2",
     "@storybook/addon-a11y": "^10.1.10",
     "@storybook/addon-docs": "^10.1.10",
     "@storybook/addon-links": "^10.1.10",
@@ -70,19 +71,19 @@
     "chai": "^6.2.1",
     "chalk": "^5.6.2",
     "chromatic": "^13.3.3",
-    "esbuild": "0.27.2",
+    "esbuild": "0.27.3",
     "esbuild-plugin-copy": "^2.1.1",
     "esbuild-plugin-eslint": "^0.3.12",
     "esbuild-plugin-handlebars": "1.0.3",
     "esbuild-sass-plugin": "3.6.0",
-    "eslint": "9.39.1",
+    "eslint": "9.39.2",
     "eslint-plugin-json": "^4.0.1",
     "eslint-plugin-storybook": "^10.1.10",
-    "globals": "16.5.0",
+    "globals": "17.3.0",
     "handlebars": "4.7.8",
     "http-server": "^14.1.1",
     "husky": "^9.1.7",
-    "jsdom": "^27.2.0",
+    "jsdom": "^28.0.0",
     "mini-svg-data-uri": "^1.4.4",
     "minimist": "^1.2.8",
     "mocha": "^11.7.5",

package/dist/sample-data/sidenav/sidenav.data.json

@@ -6,7 +6,6 @@
     {
       "link": "https://www.qld.gov.au/transport/registration/register/heavy",
       "label": "Sibling page",
-      "class": "",
       "target": "",
       "children": [
         {
@@ -17,25 +16,21 @@
         },
         {
           "link": "#",
-          "class": "active",
           "label": "Child page",
           "children": []
         },
         {
           "link": "#",
-          "class": "",
-
           "label": "Child page",
           "children": [
             {
               "link": "#",
-              "class": "",
+              "class": "active",
               "label": "Grandchild page",
               "children": []
             },
             {
               "link": "#",
-              "class": "active",
               "label": "Grandchild page",
               "children": []
             }
@@ -52,7 +47,6 @@
     {
       "link": "#",
       "label": "Sibling page",
-      "class": "active",
       "children": []
     },
     {

package/esbuild.js

@@ -5,6 +5,7 @@ import path from "path";
 
 //Local ESBUILD PLUGINS
 import QGDSupdateHandlebarsPartialsPlugin from "./.esbuild/plugins/qgds-plugin-handlebar-partial-builder.js";
+import QGDSStoryListBuilderPlugin from "./.esbuild/plugins/qgds-plugin-story-list-builder.js";
 import QGDSrawLoader from "./.esbuild/plugins/qgds-plugin-raw-loader.js";
 import QDGScleanFolders from "./.esbuild/plugins/qgds-plugin-clean-output-folders.js";
 import QDGSbuildLog from "./.esbuild/plugins/qgds-plugin-build-log.js";
@@ -79,6 +80,7 @@ const buildConfig = {
 
   plugins: [
     QGDSupdateHandlebarsPartialsPlugin(),
+    QGDSStoryListBuilderPlugin(),
     ...(argv.icons ? [QGDSgenerateIconAssetsPlugin()] : []), // Generate icons assets when --icons flag is set
     QDGScopy(),
     QGDSrawLoader(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qld-gov-au/qgds-bootstrap5",
-  "version": "2.1.9",
+  "version": "2.1.11",
   "description": "",
   "repository": {
     "type": "git",
@@ -55,10 +55,11 @@
     "bootstrap": "^5.3.8"
   },
   "devDependencies": {
-    "@chromatic-com/storybook": "^4.1.3",
+    "@chromatic-com/storybook": "^5.0.0",
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/json": "^0.14.0",
+    "@eslint/json": "^1.0.0",
     "@qld-gov-au/qgds-tokens": "^1.2.1",
+    "@vitejs/plugin-react": "^5.1.2",
     "@storybook/addon-a11y": "^10.1.10",
     "@storybook/addon-docs": "^10.1.10",
     "@storybook/addon-links": "^10.1.10",
@@ -70,19 +71,19 @@
     "chai": "^6.2.1",
     "chalk": "^5.6.2",
     "chromatic": "^13.3.3",
-    "esbuild": "0.27.2",
+    "esbuild": "0.27.3",
     "esbuild-plugin-copy": "^2.1.1",
     "esbuild-plugin-eslint": "^0.3.12",
     "esbuild-plugin-handlebars": "1.0.3",
     "esbuild-sass-plugin": "3.6.0",
-    "eslint": "9.39.1",
+    "eslint": "9.39.2",
     "eslint-plugin-json": "^4.0.1",
     "eslint-plugin-storybook": "^10.1.10",
-    "globals": "16.5.0",
+    "globals": "17.3.0",
     "handlebars": "4.7.8",
     "http-server": "^14.1.1",
     "husky": "^9.1.7",
-    "jsdom": "^27.2.0",
+    "jsdom": "^28.0.0",
     "mini-svg-data-uri": "^1.4.4",
     "minimist": "^1.2.8",
     "mocha": "^11.7.5",

package/src/components/bs5/accordion/accordion.stories.js

@@ -6,6 +6,7 @@
 
 import { Accordion } from "./Accordion.js";
 import defaultdata from "./accordion.data.json";
+import metadata from "./metadata.json";
 
 export default {
   tags: ["autodocs"],
@@ -24,24 +25,15 @@ export default {
     backgrounds: { value: "default" },
   },
 
-  /**
-   * Additional parameters for the story.
-   *
-   * @type {Object}
-   * @property {Object} design - Configuration for the design parameter.
-   * @property {string} design.name - Name of the design parameter.
-   * @property {string} design.type - Type of the design parameter.
-   * @property {string} design.url - URL of the design parameter.
-   */
   parameters: {
-    design: {
-      name: "QGDS Figma Reference",
-      type: "figma",
-      url: "https://www.figma.com/file/qKsxl3ogIlBp7dafgxXuCA/QLD-GOV-DDS?type=design&node-id=6276-45691&mode=design&t=crJKtPwMG2IcZf5E-4",
+    coderefs: {
+      metadata,
+      partialname: "accordion", //{{> accordion }}
     },
     backgrounds: {
       disable: false,
     },
+    docs: {},
   },
 };
 
@@ -112,6 +104,7 @@ export const Alternative = {
 
 /**
  * Accordion in 'Dark' colour theme.
+ *
  */
 export const Dark = {
   args: {

package/src/components/bs5/accordion/metadata.json

@@ -0,0 +1,15 @@
+{
+  "id": "qgds-accordion",
+  "title": "Accordion",
+  "title_uikit": "Accordion",
+  "type": "Component",
+  "scope": "Core",
+  "group": "",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=5990-98109&p=f&t=GROIooMNoyn7sZDF-0",
+    "website": "https://www.designsystem.qld.gov.au/components/accordion"
+  }
+}

package/src/components/bs5/backToTop/backToTop.stories.js

@@ -1,11 +1,12 @@
 /**
- * @file bactToTop.stories.js
+ * @file backToTop.stories.js
  * @description Storybook configuration file for the BackToTop component.
  * @module backToTop.stories
  */
 
 import { BackToTop } from "./backToTop.js";
 import defaultdata from "./backToTop.data.json";
+import metadata from "./metadata.json";
 
 export default {
   tags: ["autodocs"],
@@ -13,21 +14,16 @@ export default {
   render: (args) => new BackToTop(args).html,
   args: defaultdata,
 
-  /**
-   * Additional parameters for the story.
-   *
-   * @type {Object}
-   * @property {Object} design - Configuration for the design parameter.
-   * @property {string} design.name - Name of the design parameter.
-   * @property {string} design.type - Type of the design parameter.
-   * @property {string} design.url - URL of the design parameter.
-   */
   parameters: {
-    design: {
-      name: "QGDS Figma Reference",
-      type: "figma",
-      url: "https://www.figma.com/design/XPeQMu5zKhEPKXdtZclWIW/Back-to-top?node-id=2004-2461&m=dev",
+    coderefs: {
+      metadata,
+      partialname: "backToTop", //{{> back-to-top }}
+      tabs: {
+        notes:
+          "\n\nThe Back to Top is nested within the Content Footer pattern. It requires additonal markup (containers and utility classes) for correct layout within a page",
+      },
     },
+    docs: {},
   },
 };
 

package/src/components/bs5/backToTop/manifest.json

@@ -0,0 +1,15 @@
+{
+  "id": "qgds-back-to-top",
+  "title": "Back to Top",
+  "type": "pattern",
+  "category": "Core",
+  "group": "Navigation",
+  "status": "Published",
+  "tags": [""],
+  "description": "Accordions expand and collapse sections of content.",
+  "urls": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=11056-321317&p=f&m=dev",
+    "website": "https://designsystem.qld.gov.au/components/back-to-top",
+    "storybook": "https://qld-gov-au.github.io/qgds-bootstrap5/?path=/docs/3-components-back-to-top"
+  }
+}

package/src/components/bs5/backToTop/metadata.json

@@ -0,0 +1,15 @@
+{
+  "id": "qgds-back-to-top",
+  "title": "Back to top",
+  "title_uikit": "Back to top",
+  "type": "Pattern",
+  "scope": "Core",
+  "group": "",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=120353-3948&t=beW2nmeyEGkeoezl-0",
+    "website": "https://www.designsystem.qld.gov.au/components/back-to-top"
+  }
+}

package/src/components/bs5/banner/banner.stories.js

@@ -1,5 +1,6 @@
-import defaultdata from "./banner.data.json";
 import { Banner } from "./Banner";
+import defaultdata from "./banner.data.json";
+import metadata from "./metadata.json";
 
 //Import data objects required for the banner and any nested components
 import breadcrumbdata from "../breadcrumbs/breadcrumbs.data.json";
@@ -210,6 +211,20 @@ export default {
       control: { type: "hidden" }, // Hide the control in the Storybook UI
     },
   },
+
+  parameters: {
+    coderefs: {
+      metadata,
+      partialname: "banner",
+      tabs: {
+        notes:
+          "\n\nThe Banner component includes nested components such as Breadcrumbs, Buttons, and Cards. Data for these components should be passed on the main JSON object for banner. Refer to the JSON example for each story.",
+      },
+    },
+    docs: {
+      notes: "The QGDS Banner component has Basic and Advanced variants.",
+    },
+  },
 };
 
 /**

package/src/components/bs5/banner/metadata.json

@@ -0,0 +1,16 @@
+{
+  "id": "qgds-banner",
+  "title": "Banners (Default)",
+  "title_uikit": "Banners",
+  "type": "Component",
+  "scope": "Core",
+  "group": "",
+  "status": "Published",
+  "synonyms": [],
+  "description": "Banners are used to introduce a page, their content should reflect the goals, content and purpose of the page they're on.",
+  "refs": {
+    "title_uikit": "Banner",
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=6992-107232&t=1PNeXYXdepnDeW4g-0",
+    "website": "https://www.designsystem.qld.gov.au/components/banners"
+  }
+}

package/src/components/bs5/blockquote/blockquote.stories.js

@@ -1,11 +1,20 @@
 // Blockquote.stories.js
-import { Blockquote } from './Blockquote.js';
-import defaultdata from './blockquote.data.json';
+import { Blockquote } from "./Blockquote.js";
+import defaultdata from "./blockquote.data.json";
+import metadata from "./metadata.json";
 
 export default {
-  tags: ['autodocs'],
-  title: '3. Components/Blockquote',
+  tags: ["autodocs"],
+  title: "3. Components/Blockquote",
   render: (args) => new Blockquote(args).html,
+
+  parameters: {
+    coderefs: {
+      metadata,
+      partialname: "blockquote", //{{> blockquote }}
+    },
+    docs: {},
+  },
 };
 
 /**
@@ -15,25 +24,27 @@ export const Default = {
   args: defaultdata,
 };
 
+// Controls are auto-generated here by Storybook from argTypes
 
 /**
  * Light colour blockquote
  */
 export const Light = {
-  args: defaultdata,
+  args: {
+    ...defaultdata,
+    "cite-text": "Elvis the King",
+  },
   parameters: {
     backgrounds: {
-      default: 'light',
+      default: "light",
     },
   },
   decorators: [
     (Story) => {
       return `
-      <div class="container-fluid"><div class="row"><div class="col-12">
       <div class="light">
           ${Story()}
       </div>
-      </div></div></div>
       `;
     },
   ],
@@ -46,17 +57,15 @@ export const Alternative = {
   args: defaultdata,
   parameters: {
     backgrounds: {
-      default: 'alternative',
+      default: "alternative",
     },
   },
   decorators: [
     (Story) => {
       return `
-      <div class="container-fluid"><div class="row"><div class="col-12">
       <div class="alt">
           ${Story()}
       </div>
-      </div></div></div>
       `;
     },
   ],

package/src/components/bs5/blockquote/metadata.json

@@ -0,0 +1,15 @@
+{
+  "id": "qgds-blockquote",
+  "title": "Blockquote",
+  "title_uikit": "Callout and Blockquote",
+  "type": "Component",
+  "scope": "Core",
+  "group": "Callouts",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=120360-73541&t=yBoHyNGNM1kMkPfC-0",
+    "website": "https://www.designsystem.qld.gov.au/components/callouts"
+  }
+}

package/src/components/bs5/breadcrumbs/breadcrumbs.stories.js

@@ -46,10 +46,12 @@ export default {
    * @property {string} design.url - URL of the design parameter.
    */
   parameters: {
-    design: {
-      name: "QGDS Figma Reference",
-      type: "figma",
-      url: "https://www.figma.com/file/qKsxl3ogIlBp7dafgxXuCA/QLD-GOV-DDS?type=design&node-id=5990-98076&mode=design&t=Ge7frKNP4uEGswUz-0",
+    coderefs: {
+      partialname: "breadcrumbs", //{{> breadcrumbs }}
+      tabs: {
+        notes:
+          "Breadcrumbs usually sit within a container that aligns with the main content. Refer to the Page Layout story for example usage.",
+      },
     },
     backgrounds: {
       disable: false,

package/src/components/bs5/breadcrumbs/metadata.json

@@ -0,0 +1,16 @@
+{
+  "id": "qgds-breadcrumbs",
+  "title": "Breadcrumbs",
+  "title_uikit": "Breadcrumbs",
+  "type": "Component",
+  "scope": "Core",
+  "group": "Navigation",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=5990-98076&p=f&t=GROIooMNoyn7sZDF-0",
+    "website": "https://www.designsystem.qld.gov.au/components/breadcrumbs",
+    "storybook": ""
+  }
+}

package/src/components/bs5/button/button.stories.js

@@ -1,6 +1,9 @@
 // Button.stories.js
 import { Button } from "./Button.js";
 import defaultdata from "./button.data.json";
+import metadata from "./metadata.json";
+
+//import buttonSchema from "./button.schema.json";
 
 /**
  * Define the variants for Button component.
@@ -120,14 +123,19 @@ export default {
   },
 
   parameters: {
-    design: {
-      name: "QGDS Figma Reference",
-      type: "figma",
-      url: "https://www.figma.com/file/qKsxl3ogIlBp7dafgxXuCA/QLD-GOV-DDS?type=design&node-id=5990-98058&mode=design&t=YBUAJHIxqF46Um9y-0",
-    },
     backgrounds: {
       disabled: false,
     },
+    coderefs: {
+      metadata,
+      partialname: "button", //{{> button }}
+      tabs: {
+        custom: {
+          label: "Schema",
+          content: new Button(defaultdata).html,
+        },
+      },
+    },
   },
 };
 

package/src/components/bs5/button/metadata.json

@@ -0,0 +1,15 @@
+{
+  "id": "qgds-button",
+  "title": "Buttons",
+  "title_uikit": "Buttons",
+  "type": "Component",
+  "scope": "Core",
+  "group": "Forms",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=5990-98058&p=f&t=1PNeXYXdepnDeW4g-0",
+    "website": "https://www.designsystem.qld.gov.au/components/buttons"
+  }
+}

package/src/components/bs5/callToAction/callToAction.stories.js

@@ -6,6 +6,7 @@
 
 import { CallToAction } from "./callToAction.js";
 import defaultdata from "./callToAction.data.json";
+import metadata from "./metadata.json";
 
 export default {
   tags: ["autodocs"],
@@ -26,12 +27,12 @@ export default {
     `;
   },
   parameters: {
-    design: {
-      name: "QGDS Figma Reference",
-      type: "figma",
-      url: "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=11056-321367&p=f&t=v3sxViBgYUUmwplL-0",
-    },
     backgrounds: { disable: false },
+    coderefs: {
+      metadata,
+      partialname: "callToAction",
+    },
+    docs: {},
   },
   globals: { backgrounds: { value: "default" } },
 };

package/src/components/bs5/callToAction/metadata.json

@@ -0,0 +1,15 @@
+{
+  "id": "qgds-button-cta",
+  "title": "Call to action",
+  "title_uikit": "Call-to-action",
+  "type": "Component",
+  "scope": "Core",
+  "group": "Navigation",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=120360-77029&t=72ZKZxpVAzz6DIVf-0",
+    "website": "https://www.designsystem.qld.gov.au/components/call-to-action-cta"
+  }
+}

package/src/components/bs5/callout/callout.stories.js

@@ -2,6 +2,8 @@
 import { Callout } from "./Callout.js";
 import defaultdata from "./callout.data.json";
 
+import metadata from "./metadata.json";
+
 export default {
   tags: ["autodocs"],
   title: "3. Components/Callout",
@@ -28,12 +30,11 @@ export default {
    * @property {string} design.url - URL of the design parameter.
    */
   parameters: {
-    design: {
-      name: "QGDS Figma Reference",
-      type: "figma",
-      url: "https://www.figma.com/file/qKsxl3ogIlBp7dafgxXuCA/QLD-GOV-DDS?type=design&node-id=5990-98115&mode=design&t=Ue7c77KjVYU1eTGj-0",
-    },
     backgrounds: { disable: false },
+    coderefs: {
+      metadata,
+      partialname: "callout", //{{> callout }}
+    },
   },
   globals: { backgrounds: { value: "default" } },
 };

package/src/components/bs5/callout/metadata.json

@@ -0,0 +1,16 @@
+{
+  "id": "qgds-callout",
+  "title": "Callout",
+  "title_uikit": "Callout and Blockquote",
+  "type": "Component",
+  "scope": "Core",
+  "group": "Alerts",
+  "status": "Published",
+  "synonyms": [],
+  "description": "",
+  "refs": {
+    "uikit": "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=5990-98115&p=f&t=1PNeXYXdepnDeW4g-0",
+    "website": "https://www.designsystem.qld.gov.au/components/callouts",
+    "storybook": ""
+  }
+}

package/src/components/bs5/card/card--icon-list-footer.stories.js

@@ -2,6 +2,7 @@
 import { Card, argTypes } from "./Card.js";
 import { Link } from "../link/link.js";
 import defaultdata from "./card.data.json";
+import metadata from "./metadata.json";
 
 export default {
   tags: ["autodocs"],
@@ -106,10 +107,9 @@ export default {
         exclude: ["link", "arrow", "iconPosition", "footer"],
       },
     },
-    design: {
-      name: "QGDS Figma Reference - Cards",
-      type: "figma",
-      url: "https://www.figma.com/design/qKsxl3ogIlBp7dafgxXuCA/QGDS-UI-kit?node-id=card-component",
+    coderefs: {
+      metadata,
+      partialname: "card", //{{> card }}
     },
   },
 };