Merge pull request #1579 from gethinode/develop

Develop

.github/codeql/codeql-config.yml

@@ -0,0 +1,8 @@
+paths:
+  - 'assets/js'
+paths-ignore:
+  - '**/vendor'
+  - '**/critical/languageSelector.js'
+  - '**/critical/color.js'
+  - '**/navbar.js'
+  - '**/sharing.js'

.github/workflows/codeql.yml

@@ -0,0 +1,102 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL Advanced"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '44 1 * * 3'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: actions
+          build-mode: none
+        - language: javascript-typescript
+          build-mode: none
+        # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v5
+
+    # Add any setup steps before running the `github/codeql-action/init` action.
+    # This includes steps like installing compilers or runtimes (`actions/setup-node`
+    # or others). This is typically only required for manual builds.
+    # - name: Setup runtime (example)
+    #   uses: actions/setup-example@v1
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+        config-file: ./.github/codeql/codeql-config.yml
+
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+    # If the analyze step fails for one of the languages you are analyzing with
+    # "We were unable to automatically build your code", modify the matrix above
+    # to set the build mode to "manual" for that language. Then modify this step
+    # to build your code.
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+    - if: matrix.build-mode == 'manual'
+      shell: bash
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.github/workflows/lint-build.yml

@@ -14,16 +14,20 @@ env:
   CACHE_PATH_WIN: '~\AppData\Local\hugo_cache'
   CACHE_PATH_MAC: '/Users/runner/Library/Caches/hugo_cache'
 
+permissions:
+  pull-requests: read
+  contents: read
+
 jobs:
   lint:
     runs-on: ubuntu-latest
 
     steps:
     - name: Check out repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Set up Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v5
       with:
         node-version: lts/*
         cache: 'npm'
@@ -49,15 +53,15 @@ jobs:
 
     steps:
     - name: Check out repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Install Go
-      uses: actions/setup-go@v5
+      uses: actions/setup-go@v6
       with:
         go-version: ">1.0.0"
       
     - name: Set up Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v5
       with:
         node-version: ${{ matrix.node-version }}
         cache: 'npm'

.github/workflows/mod-update.yml

@@ -14,10 +14,10 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     - name: Setup Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@v5
       with:
         node-version: lts/*
         cache: 'npm'

.github/workflows/npm-publish.yml

@@ -1,41 +0,0 @@
-# This workflow will run tests using node and then publish a package to npmjs.org when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-name: Publish package to npmjs
-
-on:
-  workflow_dispatch:
-  release:
-    types: [published]
-
-env:
-  REGISTRY_URL: 'https://registry.npmjs.org/'
-
-jobs:
-  build:
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        node-version: [20.x]
-
-    runs-on: ${{ matrix.os }}
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup .npmrc file to publish to npm
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          registry-url: ${{ env.REGISTRY_URL }}
-          cache: 'npm'
-          cache-dependency-path: '**/package-lock.json'
-  
-      # [27/AUG/23] Adjusted from npm ci to prevent EBADPLATFORM error due to fsevents
-      - name: Install npm
-        run: npm i
-
-      - name: Publish package to npm
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+env:
+  HUSKY: 0
+
+permissions:
+  contents: read # for checkout
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # to be able to publish a GitHub release
+      issues: write # to be able to comment on released issues
+      pull-requests: write # to be able to comment on released pull requests
+      id-token: write # to enable use of OIDC for npm provenance
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: "lts/*"
+
+      - name: Install dependencies
+        run: npm clean-install
+
+      - name: Verify the integrity of provenance attestations and registry signatures for installed dependencies
+        run: npm audit signatures
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx semantic-release

.gitignore

@@ -1,5 +1,6 @@
 _vendor/
 prebuild/
+prebuild-headers/
 public/
 resources/
 node_modules/

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

.husky/install.mjs

@@ -0,0 +1,6 @@
+// Skip Husky install in production and CI
+if (process.env.NODE_ENV === 'production' || process.env.CI === 'true') {
+    process.exit(0)
+}
+const husky = (await import('husky')).default
+console.log(husky())

.husky/pre-commit

@@ -0,0 +1 @@
+npm test

README.md

@@ -15,9 +15,6 @@
     <a href="https://gethinode.com">
         <img src="https://img.shields.io/badge/theme-hinode-blue" alt="Hinode theme">
     </a>
-    <a href="https://www.npmjs.com/package/%40gethinode/hinode">
-        <img src="https://img.shields.io/npm/v/%40gethinode/hinode" alt="npm package">
-    </a>
     <a href="https://app.netlify.com/sites/gethinode-demo/deploys">
         <img src="https://img.shields.io/netlify/0ad42e3e-fdfa-4d37-8e26-58badd429a67"  alt="Netlify Status">
     </a>

assets/js/critical/color.js

@@ -1,4 +1,4 @@
-{{- if site.Params.main.enableDarkMode -}}
+{{- if (or site.Params.main.enableDarkMode site.Params.main.colorMode.enabled) -}}
 
 /*!
  * Color mode toggler for Bootstrap's docs (https://getbootstrap.com/)
@@ -43,9 +43,7 @@
       document.documentElement.setAttribute('data-bs-theme', theme)
     }
 
-    document.querySelectorAll('.navbar-mode-selector').forEach(chk => {
-      chk.checked = (document.documentElement.getAttribute('data-bs-theme') === 'light')
-    })
+    updateSelectors()
   }
 
   // alternates the currently active theme
@@ -54,6 +52,12 @@
     setTheme(target)
   }
 
+  function updateSelectors() {
+    document.querySelectorAll('.navbar-mode-selector').forEach(chk => {
+      chk.checked = (document.documentElement.getAttribute('data-bs-theme') === 'light')
+    })
+  }
+
   window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
     if (storedTheme !== 'light' || storedTheme !== 'dark') {
       setTheme(getPreferredTheme())
@@ -69,7 +73,12 @@
     })
   })
 
-  // initialize theme directly when script is invoked
+  window.addEventListener('load', () => {
+    // update the selectors when all elements are ready
+    updateSelectors()
+  })
+
+  // initialize theme as soon as possible to reduce screen flickering
   setTheme(getTheme())
 })()
 

assets/js/modal.js

@@ -0,0 +1,6 @@
+document.addEventListener('hide.bs.modal', function (event) {
+  // Remove the focus from the active element
+  if (document.activeElement) {
+    document.activeElement.blur()
+  }
+})

assets/js/nav.js

@@ -0,0 +1,45 @@
+function updateDropdown (element, id, label) {
+  const dropdown = document.getElementById(element)
+  if (dropdown != null) {
+    dropdown.querySelector('.dropdown-toggle').textContent = label
+    dropdown.querySelectorAll('.panel-dropdown .dropdown-item').forEach(item => {
+      item.classList.remove('active')
+      let target = item.getAttribute('data-link')
+      if (target != null) {
+        target = target.replace(/^#+/, '')
+        if (target === id) {
+          item.classList.add('active')
+        }
+      }
+    })
+  }
+}
+
+document.querySelectorAll('.panel-dropdown').forEach(trigger => {
+  trigger.addEventListener('hide.bs.dropdown', event => {
+    if (event.clickEvent != null) {
+      let target = event.clickEvent.srcElement.getAttribute('data-link')
+      if (target != null) {
+        trigger.querySelectorAll('.panel-dropdown .dropdown-item').forEach(item => {
+          item.classList.remove('active')
+        })
+        target = target.replace(/^#+/, '')
+        const btn = document.getElementById(target)
+        if (btn != null) {
+          event.clickEvent.srcElement.classList.add('active')
+          trigger.querySelector('.dropdown-toggle').textContent = event.clickEvent.srcElement.textContent
+          btn.click()
+        }
+      }
+    }
+  })
+})
+
+document.querySelectorAll('.nav-panel .nav-link').forEach(trigger => {
+  trigger.addEventListener('click', event => {
+    const companion = event.srcElement.parentElement.parentElement.getAttribute('data-companion')
+    if (companion != null) {
+      updateDropdown(companion, trigger.getAttribute('id'), trigger.textContent.trim())
+    }
+  })
+})

assets/js/toc.js

@@ -0,0 +1,13 @@
+const btnTOCShowMore = document.getElementById('btnTOCShowMore')
+if (btnTOCShowMore !== null) {
+  btnTOCShowMore.addEventListener('click', (e) => {
+    btnTOCShowMore.style.display = 'none'
+  })
+}
+
+const btnTOCShowLess = document.getElementById('btnTOCShowLess')
+if ((btnTOCShowLess !== null) && (btnTOCShowMore !== null)) {
+  btnTOCShowLess.addEventListener('click', (e) => {
+    btnTOCShowMore.style.display = 'initial'
+  })
+}

assets/scss/app-dart.scss

@@ -24,8 +24,10 @@
 @import "components/carousel.scss";
 @import "components/clipboard.scss";
 @import "components/command.scss";
+@import "components/docs.scss";
 @import "components/feature.scss";
 @import "components/footer.scss";
+@import "components/kbd.scss";
 @import "components/nav.scss";
 @import "components/navbar.scss";
 @import "components/img.scss";
@@ -35,6 +37,7 @@
 @import "components/sidebar.scss";
 @import "components/syntax-dart.scss"; // note: modified for dart-sass
 @import "components/table.scss";
+@import "components/toast.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
 @import "components/video.scss";

assets/scss/app.scss

@@ -22,8 +22,10 @@
 @import "components/carousel.scss";
 @import "components/clipboard.scss";
 @import "components/command.scss";
+@import "components/docs.scss";
 @import "components/feature.scss";
 @import "components/footer.scss";
+@import "components/kbd.scss";
 @import "components/nav.scss";
 @import "components/navbar.scss";
 @import "components/img.scss";
@@ -33,6 +35,7 @@
 @import "components/sidebar.scss";
 @import "components/syntax.scss";
 @import "components/table.scss";
+@import "components/toast.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
 @import "components/video.scss";

assets/scss/common/_scrollbar.scss

@@ -21,6 +21,7 @@
 
 	// Standard version (Firefox, only appears on scroll)
 	@supports (-moz-appearance:none) {
+		/* stylelint-disable-next-line no-invalid-position-declaration */
 		scrollbar-color: $foreground-color $background-color;
 	}
 }

assets/scss/common/_styles.scss

@@ -14,6 +14,10 @@ a:active {
     text-decoration: none;
 }
 
+div.rounded, img.rounded {
+    --bs-border-radius: #{$theme-border-radius};
+}
+
 //
 // Ensure main page is rendered to full viewport height
 //
@@ -147,3 +151,17 @@ $utilities: map-merge(
         )
     )
 );
+
+.width-100 {
+    width: 100%;
+}
+
+$utilities: (
+  "width": (
+    property: width,
+    responsive: true,
+    values: (
+      auto: auto
+    )
+  )
+);

assets/scss/common/_variables-dart.scss

@@ -16,12 +16,12 @@ $font-weight-normal:            300 !default;
 $font-weight-bold:              600 !default;
 $font-weight-bolder:            bolder !default;
 
-$theme-border-radius:           1rem;
-
 strong {
     font-weight:                600 if($enable-important-utilities, !important, null);
 }
 
+$theme-border-radius:           0.375rem;
+
 $navbar-height:                 h.$navbar-height;
 $navbar-offset:                 h.$navbar-offset;
 $navbar-offset-xs:              h.$navbar-offset-xs;

assets/scss/common/_variables.scss

@@ -17,13 +17,13 @@ $font-weight-normal:            300 !default;
 $font-weight-bold:              600 !default;
 $font-weight-bolder:            bolder !default;
 
-$theme-border-radius:           1rem;
-
 strong {
     font-weight:                600 if($enable-important-utilities, !important, null);
 }
 // scss-docs-end font
 
+$theme-border-radius:           0.375rem;
+
 $white:                       #fff !default;
 $black:                       #000 !default;
 $body-bg:                     #fff !default;

assets/scss/components/_button.scss

@@ -52,3 +52,7 @@ a.btn {
 .btn-xs {
   @include button-size($btn-padding-y-xs, $btn-padding-x-xs, $btn-font-size-xs, $btn-border-radius-xs);
 }
+
+.btn {
+    --bs-border-radius: #{$theme-border-radius};
+}

assets/scss/components/_card.scss

@@ -6,6 +6,9 @@
 }
 
 .card {
+    --bs-card-border-radius: #{$theme-border-radius};
+    --bs-card-inner-border-radius: #{$theme-border-radius};
+    --bs-border-radius: #{$theme-border-radius};
     --bs-card-bg: transparent;
 }
 
@@ -28,6 +31,13 @@
     cursor: pointer;
 }
 
+.card-img-top {
+    --bs-border-radius: #{$theme-border-radius};
+
+    border-top-left-radius: var(--bs-border-radius) !important;
+    border-top-right-radius: var(--bs-border-radius) !important;
+}
+
 .card-img-wrap img {
     transition: transform 0.25s ease;
     width: 100%;

assets/scss/components/_carousel.scss

@@ -1,3 +1,7 @@
+.carousel-inner {
+    border-radius: #{$theme-border-radius};
+}
+
 .gradient {
     width: 100%;
     height: 100%;

assets/scss/components/_docs.scss

@@ -0,0 +1,22 @@
+.docs-controls .nav-link,
+.file-controls .nav-link {
+    border-top-left-radius: #{$theme-border-radius};
+    border-top-right-radius: #{$theme-border-radius};
+    margin-left: #{$theme-border-radius};
+
+    &:hover,
+    &:focus {
+        border-bottom: 0;
+    }
+}
+
+.docs-panel,
+.file-panel {
+    border: 1px solid var(--#{$prefix}border-color);
+    overflow: hidden;
+}
+
+.docs-panel, .docs-panel .collapse,
+.file-panel, .file-panel .collapse {
+    border-radius: #{$theme-border-radius};
+}

assets/scss/components/_img.scss

@@ -27,3 +27,7 @@
     width: 100vw;
     object-fit: cover;
 }
+
+.figure-caption {
+    margin-left: #{$theme-border-radius};
+}

assets/scss/components/_kbd.scss

@@ -0,0 +1,3 @@
+kbd {
+    border-radius: #{$theme-border-radius};
+}

assets/scss/components/_nav.scss

@@ -1,14 +1,8 @@
-.nav-tabs .nav-tabs {
-    border: none;
+.nav-tabs {
+    border: none !important;
 }
 
-.nav-tabs .nav-link.active {
-    border-bottom-color: var(--bs-body-bg) !important;
-    border-bottom-style: solid !important;
-    z-index: 1;
-}
-
-.nav-callout {
+.nav-callout, .tab-content {
     --#{$prefix}nav-callout-bg: var(--#{$prefix}light);
     --#{$prefix}nav-callout-active-bg: var(--bs-primary-bg-subtle);
     --#{$prefix}nav-callout-gap: #{$nav-underline-gap};
@@ -90,9 +84,17 @@
     border-color: var(--#{$prefix}border-color);
 }
 
+.nav-callout, .pagination {
+    --bs-border-radius: #{$theme-border-radius};
+}
+
+.nav-callout .tab-content {
+    border-radius: #{$theme-border-radius};
+}
+
 @if $enable-dark-mode {
     @include color-mode(dark) {
-        .nav-callout {
+        .nav-callout, .tab-content {
             --#{$prefix}nav-callout-bg: var(--#{$prefix}tertiary-bg);
         }
 

assets/scss/components/_navbar.scss

@@ -7,7 +7,7 @@
 }
 
 .mode-switch {
-    --#{$prefix}mode-switch-width: 50px;
+    --#{$prefix}mode-switch-width: 3em;
 }
 
 .mode-switch .label {
@@ -64,6 +64,18 @@
     transform: scale(0.8);
 }
 
+.mode-toggle > input {
+	z-index: 1;
+	cursor: pointer;
+    height: 25px;
+    width: 25px;
+}
+
+.mode-toggle > label {
+	z-index: 0;
+	cursor: pointer;
+}
+
 // Source: https://jsfiddle.net/njhgr40m/
 
 @if $enable-dark-mode {
@@ -92,20 +104,27 @@
     margin: 0 .15rem;
 }
 
-.navbar-title {
+.navbar-title, .navbar-title-center, .navbar-title-start {
     display: inline-block;
     white-space: normal;
-    text-align: center !important;
     vertical-align: middle;
     padding: 0 $spacer;
     width: 100% !important;
 }
 
+.navbar-title, .navbar-title-center {
+    text-align: center !important;
+}
+
 .navbar-contrast .nav-link.active, .navbar-contrast .nav-link.show, .navbar-contrast .nav-link:hover {
     border-bottom: solid 1px var(--bs-navbar-hover-color);
     margin-bottom: -1px;
 }
 
+.navbar-brand {
+    margin-right: 0;
+}
+
 .navbar-contrast {
     --bs-navbar-color: white !important;
     --bs-navbar-hover-color: white !important;
@@ -113,7 +132,7 @@
     --bs-navbar-active-color: white !important;
     --bs-navbar-toggler-color: white;
 
-    .navbar-title, .mode-switch {
+    .navbar-title, .navbar-brand, .mode-switch {
         --#{$prefix}border-color: white;
 
         color: white !important;
@@ -126,12 +145,65 @@
 
 .navbar-expanded {
     box-shadow: $box-shadow-sm;
+    min-height: 100vh;
+    align-items: start;
+}
+
+.navbar-expanded .navbar-collapse {
+    margin-top: 2rem;
+}
+
+@each $h, $size in $font-sizes {
+    .navbar-fs-#{$h} {
+        font-size: #{$size};
+    }
+}
+
+@each $breakpoint in map-keys($grid-breakpoints) {
+    $next: breakpoint-next($breakpoint, $grid-breakpoints);
+    $infix: breakpoint-infix($next, $grid-breakpoints);
+
+    @if $infix != '' {
+        @include media-breakpoint-up($next) {
+            .navbar#{$infix}-fs { 
+                font-size: inherit;
+            } 
+        }
+    }
+}
+
+.navbar-icon {
+    padding-right: var(--bs-navbar-nav-link-padding-x);
+    padding-left: var(--bs-navbar-nav-link-padding-x);
 }
 
 .nav-item .vr {
     color: var(--bs-navbar-color);
 }
 
+.navbar .nav-item {
+    display: flex;
+    align-items: center;
+    white-space: nowrap;
+}
+
+.navbar-collapse .dropdown {
+    display: inline;
+    align-items: normal;
+}
+
+.navbar-expanded .btn {
+    font-size: 1em;
+}
+
+.navbar .btn {
+    border-radius: #{$theme-border-radius};    
+}
+
+.navbar-expanded .search-input {
+    margin-bottom: 1rem;
+}
+
 /* Remove border from toggler */
 .navbar-toggler {
     border: 0 if($enable-important-utilities, !important, null);
@@ -223,13 +295,10 @@
 }
 
 .navbar-container {
+    min-height: calc(2rem + 10px);
     width: 100% !important;
 }
 
-.navbar-brand {
-    margin-right: 0;
-}
-
 @include media-breakpoint-up(#{$navbar-size}) {
     :root {
         --navbar-offset: #{$navbar-offset};
@@ -319,3 +388,7 @@
     position: absolute;
     z-index: $zindex-fixed;
 }
+
+.form-control.is-search {
+    border: 1px solid var(--bs-border-color) !important;
+}

assets/scss/components/_sidebar.scss

@@ -11,6 +11,12 @@
 }
 
 .sidebar-item {
+    --bs-border-radius: #{$theme-border-radius};
+    --bs-border-radius-sm: #{$theme-border-radius};
+    --bs-border-radius-lg: #{$theme-border-radius};
+    --bs-border-radius-xl: #{$theme-border-radius};
+    --bs-border-radius-xxl: #{$theme-border-radius};
+
     color: rgba(0, 0, 0, 0.65);
     margin-left: 0 !important;
     display: inline-block;
@@ -28,6 +34,8 @@
 }
 
 .sidebar-item-group {
+    border-radius: #{$theme-border-radius};
+
     &:hover,
     &:focus {
         color: $primary;
@@ -126,4 +134,6 @@
 
 .dropdown-toggle {
     outline: 0;
+    display: flex;
+    align-items: center;
 }

assets/scss/components/_syntax-dart.scss

@@ -16,6 +16,10 @@
     flex: 1;
 }
 
+.codeblock.syntax-highlight, .command.syntax-highlight {
+    border-radius: #{$theme-border-radius};
+}
+
 .syntax-highlight {
     background-color: var(--bs-light) if($enable-important-utilities, !important, null);
     overflow-x: auto;

assets/scss/components/_syntax.scss

@@ -16,6 +16,10 @@
     flex: 1;
 }
 
+.codeblock.syntax-highlight, .command.syntax-highlight {
+    border-radius: #{$theme-border-radius};
+}
+
 .syntax-highlight {
     background-color: var(--bs-light) if($enable-important-utilities, !important, null);
     overflow-x: auto;

assets/scss/components/_timeline.scss

@@ -26,6 +26,10 @@ $semi-circle-border: 0.2rem;
 
 // scss-docs-end timeline
 
+.timeline-container {
+    border-radius: #{$theme-border-radius}; 
+}
+
 .timeline, .timeline-sm {
     position: relative;
 }

assets/scss/components/_toast.scss

@@ -0,0 +1,4 @@
+.toast {
+    border-radius: #{$theme-border-radius};
+    overflow: hidden;
+}

assets/scss/components/_toc.scss

@@ -3,11 +3,11 @@
 //
 // scss-docs-start toc
 .toc-sidebar {
-    grid-area: toc;
     right: 0;
     z-index: 2;
     overflow-y: auto;
     top: 5rem;
+    max-height: calc(100vh - var(--navbar-offset));
 }
 
 // scss-docs-end toc
@@ -74,6 +74,14 @@
     }
 }
 
+.btn-link.toc-item {
+    font-size: inherit;
+}
+
+#btnTOCShowMore {
+    padding-top: 0.875rem;
+}
+
 a.toc-item {
     display: block;
 }

assets/scss/components/_video.scss

@@ -3,6 +3,7 @@
     padding-bottom: 56.25%;
     height: 0;
     overflow: hidden;
+    border-radius: #{$theme-border-radius};
 }
 
 .video-embedded > iframe {
@@ -11,7 +12,7 @@
     left: 0;
     width: 100%;
     height: 100%;
-    border:0;
+    border: 0;
 }
 
 // Adapted from https://github.com/gohugoio/hugo/tpl/tplimpl/embedded/templates/shortcodes/vimeo_simple.html

assets/scss/theme/fonts.scss

@@ -10,7 +10,7 @@
 
 /* inter-200 - latin */
 @font-face {
-    font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+    font-display: block; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
     font-family: 'Inter';
     font-style: normal;
     font-weight: 200;
@@ -23,7 +23,7 @@
   }
   /* inter-300 - latin */
   @font-face {
-    font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+    font-display: block; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
     font-family: 'Inter';
     font-style: normal;
     font-weight: 300;
@@ -36,7 +36,7 @@
   }
   /* inter-regular - latin */
   @font-face {
-    font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+    font-display: block; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
     font-family: 'Inter';
     font-style: normal;
     font-weight: 400;
@@ -49,7 +49,7 @@
   }
   /* inter-600 - latin */
   @font-face {
-    font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+    font-display: block; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
     font-family: 'Inter';
     font-style: normal;
     font-weight: 600;

commitlint.config.js

@@ -0,0 +1 @@
+module.exports = {extends: ['@commitlint/config-conventional']}

component-library/bookshop.scss

@@ -2,8 +2,10 @@
 @import "modules/bookshop/components/about/about";
 @import "modules/bookshop/components/articles/articles";
 @import "modules/bookshop/components/cards/cards";
+@import "modules/bookshop/components/cta/cta";
 @import "modules/bookshop/components/faq/faq";
 @import "modules/bookshop/components/hero/hero";
+@import "modules/bookshop/components/panels/panels";
 @import "modules/bookshop/components/releases/releases";
 @import "modules/bookshop/components/separator/separator";
 @import "modules/bookshop/components/video-message/video-message";

component-library/components/about/about.bookshop.yml

@@ -32,6 +32,8 @@ blueprint:
   width:
   justify:
   link-type:
+  theme:
+  cover:
   links:
     -
       title:

component-library/components/about/about.hugo.html

@@ -19,9 +19,10 @@
 {{/* Main code */}}
 {{ if not $args.error }}
     {{ partial "assets/hero.html"  (dict 
+        "page"         page
         "heading"      $args.heading
         "background"   $args.background
-        "illustration" (merge (dict "ratio" "1x1") $args.illustration)
+        "illustration" (merge (dict "ratio" "auto") $args.illustration)
         "order"        $args.order
         "link-type"    $args.linkType
         "links"        $args.links

component-library/components/articles/articles.bookshop.yml

@@ -27,6 +27,8 @@ blueprint:
   more:
     title:
     link:
+  icon-rounded:
+  icon-style:
   cols:
   padding:
   limit:
@@ -45,3 +47,5 @@ blueprint:
   class:
   width:
   justify:
+  theme:
+  cover:

component-library/components/articles/articles.hugo.html

@@ -19,6 +19,10 @@
     {{ $error = $args.err }}
 {{ end }}
 
+{{/* Initialize global arguments */}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
+
+{{/* Initialize local variables */}}
 {{ $pages := slice }}
 {{ $result := partial "assets/live-pages.html" (dict 
 	"page"       $args.page
@@ -60,48 +64,58 @@
 	{{ $paginate = false }}
 {{ end }}
 
-<!-- Main code -->
+{{/* Main code */}}
 {{ if not $error }}
-	{{- partial "assets/section-title.html" (dict "heading" $args.heading) -}}
+	{{ if or (gt (len $pages) 0) (not $args.hideEmpty) }}
+		{{- partial "assets/section-title.html" (dict
+			"heading" $args.heading
+			"justify" $args.justify
+			"class" (printf "pb-%d" $padding.y))
+		-}}
 
-	{{ $partial := "assets/card-group.html" }}
-	{{ $params := dict }}
-	{{- $params = merge $params (dict
-		"page"         page
-		"list"         $pages
-		"limit"        $args.limit
-		"cols"         $args.cols
-		"icon-rounded" $args.iconRounded
-		"href"         (cond $moreButton $moreLink "")
-		"href-title"   (cond $moreButton $moreTitle "")
-		"href-force"   (gt $result.total (len $result.pages))
-	)}}
+		{{ $partial := "assets/card-group.html" }}
+		{{ $params := dict }}
+		{{- $params = merge $params (dict
+			"page"         page
+			"list"         $pages
+			"limit"        $args.limit
+			"cols"         $args.cols
+			"icon-rounded" $args.iconRounded
+			"icon-style"   $args.iconStyle
+			"href"         (cond $moreButton $moreLink "")
+			"href-title"   (cond $moreButton $moreTitle "")
+			"href-force"   (gt $result.total (len $result.pages))
+		)}}
 
-	{{ if $args.scroll }}
-		{{ $partial := "assets/stack.html" }}
-		{{ $params = merge $params (dict 
-			"header-style" "none"
-			"body-style"   "title"
-			"footer-style" "none"
-			"gutter"       1
-			"padding"      3
-			"ratio"        "1x1"
-			"orientation"  "horizontal-sm"
-			"styles"       (cond $args.bento $styles "")
-		) -}}
-	{{ else }}
-		{{ $params = merge $params (dict 
-			"header-style" $args.headerStyle
-			"footer-style" $args.footerStyle
-			"padding"      $args.padding
-			"class"        (or $args.class "border-0")
-			"icon-style"   "fa-2x"
-			"align"        "start"
-			"orientation"  $args.orientation
-			"hook"         "assets/live-card.html"
-			"pagination"   $args.pagination
-			"paginate"     $paginate
-		) -}}
+		{{ if $args.scroll }}
+			{{ $partial = "assets/stack.html" }}
+			{{ $params = merge $params (dict 
+				"header-style" "none"
+				"body-style"   "title"
+				"footer-style" "none"
+				"gutter"       1
+				"padding"      3
+				"ratio"        "1x1"
+				"orientation"  "horizontal-sm"
+				"styles"       (cond $args.bento $styles "")
+			) -}}
+		{{ else }}
+			{{ $params = merge $params (dict 
+				"header-style" $args.headerStyle
+				"footer-style" $args.footerStyle
+				"padding"      $args.padding
+				"class"        (or $args.class "border-0")
+				"align"        "start"
+				"orientation"  $args.orientation
+				"hook"         "assets/live-card.html"
+				"pagination"   $args.pagination
+				"paginate"     $paginate
+			) -}}
+		{{ end }}
+		{{ if gt (len $pages) 0 }}
+			{{ partial $partial $params }}
+		{{ else }}
+			<p class="pt-{{ $padding.y }}">{{- T "emptyList" }}.</p>
+		{{ end }}
 	{{ end }}
-	{{ partial $partial $params }}
 {{ end }}

component-library/components/cards/cards.bookshop.yml

@@ -17,6 +17,7 @@ blueprint:
     width:
   cols:
   icon-rounded:
+  icon-style:
   padding:
   background:
     backdrop:
@@ -32,3 +33,6 @@ blueprint:
   class:
   width:
   justify:
+  align:
+  theme:
+  cover:

component-library/components/cards/cards.hugo.html

@@ -21,6 +21,7 @@
 
 {{/* Initialize global arguments */}}
 {{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
 
 {{/* Initialize local variables */}}
 {{ $list := slice }}
@@ -34,37 +35,46 @@
 	) }}
 {{ end}}
 
+{{/* Main code */}}
 {{ if not $error }}
-	{{- partial "assets/section-title.html" (dict "heading" $args.heading) -}}
+	{{- partial "assets/section-title.html" (dict
+		"heading" $args.heading
+		"justify" $args.justify
+		"class" (printf "pb-%d" $padding.y))
+	-}}
 
+	{{/* Layout for small screens */}}
 	{{- partial "assets/card-group.html" (dict 
 		"page"         page
 		"list"         $list
-		"class"        (printf "border-0 card-icon-primary d-%s-none %s" $breakpoint.prev $args.class)
+		"class"        (printf "border-0 card-icon-primary %s" (or $args.class ""))
+		"wrapper"      (printf "d-%s-none" $breakpoint.prev)
 		"cols"         $args.cols
 		"gutter"       "4"
 		"padding"      $args.padding
 		"header-style" "none"
 		"footer-style" "none"
 		"icon-rounded" $args.iconRounded
-		"icon-style"   "fa-2x"
-		"align"        "start"
+		"icon-style"   (or $args.iconStyle "fa-2x")
+		"align"        $args.align
 		"orientation"  ($args.orientation | default "horizontal-sm")
 		"hook"         "assets/live-card.html"
 	) -}}
 
+	{{/* Layout for regular screens */}}
 	{{- partial "assets/card-group.html" (dict 
 		"page"         page
 		"list"         $list
-		"class"        (printf "border-0 card-icon-primary d-none d-%s-block %s" $breakpoint.prev $args.class)
+		"class"        (printf "border-0 card-icon-primary %s" (or $args.class ""))
+		"wrapper"      (printf "d-none d-%s-block" $breakpoint.prev)
 		"cols"         $args.cols
 		"gutter"       "4"
 		"padding"      $args.padding
 		"header-style" "none"
 		"footer-style" "none"
 		"icon-rounded" $args.iconRounded
-		"icon-style"   "fa-2x"
-		"align"        "start"
+		"icon-style"   (or $args.iconStyle "fa-2x")
+		"align"        $args.align
 		"orientation"  ($args.orientation | default "stacked")
 		"hook"         "assets/live-card.html"
 	) -}}

component-library/components/cta/cta.bookshop.yml

@@ -0,0 +1,45 @@
+# Metadata about this component, to be used in the CMS
+spec:
+  structures:
+    - content_blocks
+  label: CTA
+  description: Call to action
+  icon: contact_page
+  tags: []
+
+# Defines the structure of this component, as well as the default values
+blueprint:
+  heading:
+    preheading:
+    title:
+    content:
+    align:
+    arrangement:
+    width:
+    size:
+  contact:
+  caption-url:
+  illustration:
+    image:
+    icon:
+    ratio:
+    class:
+    anchor:
+    mode:
+  background:
+    backdrop:
+    color:
+    subtle:
+  links:
+    -
+      title:
+      url:
+      icon:
+      force:
+  align:
+  fluid:
+  padding:
+  order:
+  width:
+  theme:
+  cover:

component-library/components/cta/cta.hugo.html

@@ -0,0 +1,43 @@
+{{/* 
+    Copyright © 2025 The Hinode Team / Mark Dumay. All rights reserved.
+    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
+    Visit gethinode.com/license for more details.
+*/}}
+
+{{/* Initialize arguments */}}
+{{ $args := partial "utilities/InitArgs.html" (dict "bookshop" "cta" "args" .) }}
+{{ if or $args.err $args.warnmsg }}
+    {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+        "partial" "component-library/components/cta/cta.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
+        "msg"     "Invalid arguments"
+        "details" ($args.errmsg | append $args.warnmsg)
+        "file"    page.File
+    )}}
+{{- end -}}
+
+{{/* Main code */}}
+{{ if not $args.error }}
+	{{ $links := slice }}
+	{{ if and (reflect.IsSlice .links) (gt (len .links) 0) }}
+		{{ $links = .links }}
+	{{ else }}
+		{{ with site.Params.modules.bookshop.cta.defaultURL }}
+			{{ $links = $links | append (dict "title" (T "contactAction") "url" . "icon" "fas chevron-right") }}
+		{{ end }}
+	{{ end }}
+
+	{{ partial "assets/contact.html" (dict 
+		"page"         page
+		"orientation"  "horizontal"
+		"heading"      $args.heading
+		"contact"      $args.contact
+		"caption-url"  $args.captionUrl
+		"illustration" $args.illustration
+		"class"        "contact-img"
+		"links"        $links
+		"align"        $args.align
+		"order"        $args.order
+		"data"         site.Params.modules.bookshop.cta.section 
+	) }}
+{{ end }}

component-library/components/cta/cta.scss

@@ -0,0 +1,12 @@
+.cta {
+    background-color: var(--#{$prefix}primary-bg-subtle);
+}
+
+.cta, .background-img-fluid  {
+    border-radius: #{$theme-border-radius} if($enable-important-utilities, !important, null);
+}
+
+.cta .contact-img {
+    background-color: var(--#{$prefix}body-bg);
+    border-radius: var(--bs-border-radius);
+}

component-library/components/faq/faq.bookshop.yml

@@ -26,3 +26,5 @@ blueprint:
   items:
     - title:
       description:
+  theme:
+  cover:

component-library/components/faq/faq.hugo.html

@@ -16,15 +16,24 @@
     )}}
 {{ end }}
 
+{{/* Initialize global arguments */}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
+
+{{/* Main code */}}
 {{ if not $args.err }}
 	{{ $color := "" }}
 	{{ if $args.contrast }}{{ $color = "white" }}{{ end }}
-	{{- partial "assets/section-title.html" (dict  "heading" $args.heading "color" $color) -}}
+	{{- partial "assets/section-title.html" (dict
+		"heading" $args.heading
+		"justify" $args.justify
+		"class" (printf "pb-%d" $padding.y))
+	-}}
 
 	{{ $class := "" }}
 	{{ $id := printf "faq-%s" (md5 (delimit (slice . now) "-")) }}
 
-	<div id="{{ $id }}" class="accordion accordion-faq {{ if $args.contrast }}accordion-faq-contrast text-white {{ end }}accordion-flush mb-3{{ with $class }} {{ . }}{{ end }} col-12 col-md-6 mx-auto">
+	<div id="{{ $id }}" class="accordion accordion-faq {{ if $args.contrast }}accordion-faq-contrast text-white {{ end -}}
+		accordion-flush{{ with $class }} {{ . }}{{ end }} col-12 col-md-6 mx-auto">
 		{{ range $index, $item := $args.items }}
 			<div class="accordion-item">
 				{{- with $item.title -}}

component-library/components/hero/hero.bookshop.yml

@@ -35,6 +35,7 @@ blueprint:
   align:
   order:
   overlay-mode:
+  theme:
   cover:
   orientation:
   width:

component-library/components/hero/hero.hugo.html

@@ -18,6 +18,7 @@
 
 {{ if not $args.err }}
 	{{ partial "assets/hero.html"  (dict 
+        "page"         page
 		"breadcrumb"   $args.breadcrumb
 		"heading"      $args.heading
 		"background"   $args.background

component-library/components/panels/panels.bookshop.yml

@@ -0,0 +1,37 @@
+# Metadata about this component, to be used in the CMS
+spec:
+  structures:
+    - content_blocks
+  label: Panels
+  description: Introduction section
+  icon: check
+  tags: []
+
+# Defines the structure of this component, as well as the default values
+blueprint:
+  heading:
+    preheading:
+    heading:
+    content:
+    align:
+    width:
+  cols:
+  padding:
+  background:
+    backdrop:
+    color:
+    subtle:
+  elements:
+    - title:
+      icon:
+      image:
+      mode:
+      content:
+  tab-type:
+  ratio:
+  responsive:
+  class:
+  width:
+  justify:
+  theme:
+  cover:

component-library/components/panels/panels.hugo.html

@@ -0,0 +1,88 @@
+{{/* 
+    Copyright © 2025 The Hinode Team / Mark Dumay. All rights reserved.
+    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
+    Visit gethinode.com/license for more details.
+*/}}
+
+{{ $error := false }}
+
+{{/* Initialize arguments */}}
+{{ $args := partial "utilities/InitArgs.html" (dict "bookshop" "panels" "args" .)}}
+{{ if or $args.err $args.warnmsg }}
+    {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+        "partial" "component-library/components/panels/panels.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
+        "msg"     "Invalid arguments"
+        "details" ($args.errmsg | append $args.warnmsg)
+        "file"    page.File
+    )}}
+    {{ $error = $args.err }}
+{{ end }}
+
+{{/* Initialize global arguments */}}
+{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
+
+{{/* Initialize local variables */}}
+{{ $list := slice }}
+{{ $titles := slice }}
+{{ $toc := slice }}
+{{ $parentID := printf "panel-%v" (cond (isset . "_ordinal") (index . "_ordinal") (md5 (delimit (slice . now) "-"))) }}
+{{ $inner := "" }}
+{{ range $i, $element := $args.elements }}
+	{{ $toc = $toc | append (dict "href" "panel-0-1" "level" 2 "title" $element.title) }}
+
+    {{ $hero := partial "assets/hero.html"  (dict 
+        "page"          page
+        "heading"       (dict "content" $element.content "width" 8)
+        "background"    $args.background
+        "illustration"  (dict "ratio" $args.ratio "icon" $element.icon "image" $element.image "mode" $element.mode)
+		"order"         $args.order
+        "link-type"     $args.linkType
+        "links"         $args.links
+        "orientation"   "horizontal"
+		"align"         "start"
+		"width"         12
+        "content-style" "fs-6"
+        )
+    }}
+
+	{{- $output := partial "assets/nav-item.html" (dict 
+        "page"      page
+        "id"        $i
+        "parent-id" $parentID
+        "fade"      false
+        "title"     $element.title
+		"show"      (eq $i 0)
+        "raw"       $hero
+        )
+    -}}
+
+	{{ $inner = printf "%s\n%s" $inner $output }}
+	{{ $titles = $titles | append $element.title }}
+{{ end}}
+
+{{/* Main code */}}
+{{ if not $error }}
+	{{- partial "assets/section-title.html" (dict
+		"heading" $args.heading
+		"justify" $args.justify
+		"class" (printf "pb-%d" $padding.y))
+	-}}
+
+	{{- partial "assets/nav.html" (dict 
+        "id"           (or $args.id $parentID)
+        "page"         page
+		"nav-items"    $inner
+        "nav-titles"   $titles
+        "tab-type"     $args.tabType
+        "vertical"     $args.vertical
+        "word-wrap"    $args.wordWrap
+        "class"        $args.class
+        "pane"         $args.pane
+        "width"        $args.width
+		"responsive"   $args.responsive
+        ) 
+    -}}
+{{ end }}
+

component-library/components/panels/panels.scss

@@ -0,0 +1,13 @@
+.panels .dropdown-toggle {
+    text-decoration: none !important;
+}
+
+.panels .nav-tabs {
+    border-top-left-radius: #{$theme-border-radius};
+    border-top-right-radius: #{$theme-border-radius};
+    margin-left: #{$theme-border-radius};
+}
+
+.panels .tab-content {
+    border-radius: #{$theme-border-radius};
+}

component-library/components/releases/releases.bookshop.yml

@@ -23,4 +23,6 @@ blueprint:
     subtle:
   width:
   justify:
-  data:
+  data:
+  theme:
+  cover:

component-library/components/separator/separator.bookshop.yml

@@ -6,3 +6,5 @@ spec:
   description: Inserts a horizontal page section separator
   icon: horizontal_rule
   tags: []
+
+blueprint:

component-library/components/separator/separator.hugo.html

@@ -4,7 +4,7 @@
     Visit gethinode.com/license for more details.
 */}}
 
-{{ $args := partial "utilities/InitArgs.html" (dict "structure" "separator" "args" .) }}
+{{ $args := partial "utilities/InitArgs.html" (dict "bookshop" "separator" "args" .) }}
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/separator/separator.hugo.html" 

component-library/components/video-message/video-message.bookshop.yml

@@ -24,12 +24,14 @@ blueprint:
   link-type:
   orientation:
   icon-rounded:
+  icon-style:
   video:
     provider:
     account:
     media-id:
     autoplay:
     query-args:
+    color:
   cols:
   messages:
     - title:
@@ -40,6 +42,8 @@ blueprint:
   border:
   width:
   justify:
+  theme:
+  cover:
 
 _structures:
   messages:

component-library/components/video-message/video-message.hugo.html

@@ -16,6 +16,7 @@
     )}}
 {{ end }}
 
+{{/* Initialize global variables */}}
 {{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
 {{- $padding := partial "utilities/GetPadding.html" -}}
 
@@ -27,6 +28,7 @@
 	{{ $queryArgs := .queryArgs }}
 	{{ $border := .border }}
 	{{ $padding := .padding }}
+	{{ $color := .color }}
 
 	{{ if site.Params.env_bookshop_live }}
 		{{/* Define dummy content as we cannot retrieve video data in live mode */}}
@@ -35,7 +37,7 @@
 			"ratio" "21x9"
 			"wrapper" (printf "text-center mb-%d" $padding.y)) -}}
 	{{ else }}
-        <div class="video-container{{ if $border }} video-container-border{{ end}}">
+        <div class="video-container{{ if $border }} video-container-border{{ end}} {{ with $color }}bg-{{ . }}{{ end }}">
 			{{ partial "assets/video.html" (dict
 				"page"       page
 				"provider"   $provider
@@ -59,6 +61,7 @@
 	{{ $cols := .cols }}
 	{{ $type := .type }}
 	{{ $iconRounded := .iconRounded }}
+	{{ $iconStyle := .iconStyle }}
 
 	{{- partial "assets/card-group.html" (dict 
 		"page"         page
@@ -75,9 +78,11 @@
 		"button"       true
 		"link-type"    $type
 		"icon-rounded" $iconRounded
+		"icon-style"   $iconStyle
 	) -}}
 {{ end }}
 
+{{/* Main code */}}
 {{ if not $args.err }}
 	{{ $list := slice }}
 
@@ -96,10 +101,14 @@
 		) }}
 	{{ end}}
 
-	{{- partial "assets/section-title.html" (dict "heading" $args.heading) -}}
+	{{- partial "assets/section-title.html" (dict
+		"heading" $args.heading
+		"justify" $args.justify
+		"class" (printf "pb-%d" $padding.y))
+	-}}
 
 	{{ if eq $args.orientation "stacked" }}
-		<div class="col-{{ $breakpoint.current }}-{{ $args.width }} mx-auto pb-{{ $padding.y }}">
+		<div class="col-{{ $breakpoint.current }}-{{ $args.width }} mx-auto">
 		{{ with $args.video }}
 			{{- partial "inline/video.html" (dict
 				"provider"   .provider
@@ -109,14 +118,21 @@
 				"query-args" .queryArgs
 				"border"     $.border
 				"padding"    $padding
+				"color"      .color
 			) -}}
 		{{ end }}
 		</div>
-		<div class="mt-{{ $padding.y }} pb-{{ $padding.y }}">
-			{{- partial "inline/messages.html" (dict "list" $list "cols" $args.cols "type" $args.type "iconRounded" $args.iconRounded) -}}
+		<div class="mt-{{ $padding.y }} w-100">
+			{{- partial "inline/messages.html" (dict
+				"list"        $list
+				"cols"        $args.cols
+				"type"        $args.type
+				"iconRounded" $args.iconRounded
+				"iconStyle"   $args.iconStyle
+			) -}}
 		</div>
 	{{ else }}
-		<div class="container grid gap-4 pb-{{ $padding.y }}">
+		<div class="container grid gap-{{ $padding.x }}">
 			<div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2">
 				<div class="col col-{{ $breakpoint.current }}-{{ $args.width }} p-0">
 					{{ with $args.video }}
@@ -128,11 +144,18 @@
 							"query-args" .queryArgs
 							"border"     $.border
 							"padding"    $padding
+							"color"      .color
 						) -}}
 					{{ end }}
 				</div>
 				<div class="col col-{{ $breakpoint.current }}-{{ sub 12 $args.width }} mt-{{ $padding.y }} mt-{{ $breakpoint.current }}-0">
-					{{- partial "inline/messages.html" (dict "list" $list "cols" 1 "type" $args.type "iconRounded" $args.iconRounded) -}}
+					{{- partial "inline/messages.html" (dict
+						"list"        $list
+						"cols"        1
+						"type"        $args.type
+						"iconRounded" $args.iconRounded
+						"iconStyle"   $args.iconStyle
+					) -}}
 				</div>
 			</div>
 		</div>

component-library/components/video-message/video-message.scss

@@ -2,6 +2,7 @@
     --bs-video-border-color: var(--bs-primary);
     --bs-video-border-width: 1rem;
     
+    border-radius: $theme-border-radius;
     position: relative;
 }
 

component-library/helpers/component.html

@@ -16,6 +16,7 @@
 {{- $class := index . 2 | default "p-0" -}}
 {{- $bgclass := index . 3 | default "" -}}
 {{- $padding := partial "utilities/GetPadding.html" -}}
+{{- with index $component_props "padding" }}{{ $padding = dict "x" . "y" . }}{{ end -}}
 {{- $component_path := partial "_bookshop/helpers/component_key" $component_name -}}
 {{- $flat_component_path := partial "_bookshop/helpers/flat_component_key" $component_name -}}
 
@@ -26,30 +27,49 @@
     {{- $resolved_component = $flat_component_path -}}
 {{- end -}}
 
+<!-- TODO: use initialized component args instead of component_props -->
+{{ $error := false }}
+{{ $args := dict }}
 {{- if $resolved_component -}}
+    {{ $args = partial "utilities/InitArgs.html" (dict "bookshop" $component_name "args" $component_props) }}
+    {{ if or $args.err $args.warnmsg }}
+        {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+            "partial" $resolved_component
+            "warnid"  "warn-invalid-arguments"
+            "msg"     "Invalid arguments"
+            "details" ($args.errmsg | append $args.warnmsg)
+            "file"    page.File
+        )}}
+    {{ end }}
+{{ end }}
+
+{{ if and $resolved_component (not $args.err) }}
     {{- $id := index $component_props "id" -}}
     {{- $cover := index $component_props "cover" -}}
     {{- $background := index $component_props "background" -}}
     {{- $backdrop := "" -}}
-    {{- $style := index $component_props "wrapper" -}}
+    {{- $fluid := index $component_props "fluid" | default true -}}
+    {{- $wrapper := index $component_props "wrapper" -}}
     {{- $width := index $component_props "width" -}}
     {{- $justify := index $component_props "justify" | default "start" -}}
-    {{- $padding := cond (ne $component_name "separator") (printf "px-%d px-xxl-0 py-%d" $padding.x $padding.y) "" -}}
-    {{- $wrapper := $style }}
+    {{- $paddingOuter := cond (ne $component_name "separator") (printf "px-xxl-0 px-%d py-0" $padding.x) "" -}}
+    {{- $padding := cond (ne $component_name "separator") (printf "px-%d %spy-%d" $padding.x (cond $fluid "px-xxl-0 " "") $padding.y) "" -}}
     {{ with $background }}
-        {{ $wrapper = partial "utilities/GetBackgroundStyle.html" (dict "background" . "class" $style) }}
+        {{ $wrapper = partial "utilities/GetBackgroundStyle.html" (dict "background" . "class" $wrapper) }}
         {{ if reflect.IsMap $background }}
             {{ with $background.backdrop }}{{ $wrapper = "" }}{{ $backdrop = . }}{{ end }}
         {{ end }}
     {{ end }}
-    {{/* warnf "wrapper: '%s'" $wrapper */}}
     {{- $theme := index $component_props "theme" -}}
     {{- $overlayMode := (or (index $component_props "overlay-mode") page.Params.overlayMode) | default "dark" -}}
     {{ if not $backdrop }}{{ $overlayMode = page.Params.overlayMode }}{{ end }}
     {{ if eq $overlayMode "none" }}{{ $overlayMode = "" }}{{ end }}
     
     {{ (printf "<!--bookshop-live name(%s)-->" $component_name) | safeHTML }}
-    <section {{ with $id }}id="{{ . }}" {{ end }}class="{{ $component_name }} container-fluid {{ $class }} {{ with $wrapper }}{{ . }}{{ end -}}
+    {{ if not $fluid }}<div class="container-xxl {{ $paddingOuter }}">{{ end }}
+    <section {{ with $id }}id="{{ . }}" {{ end }}class="{{ $component_name }}
+        container-fluid {{ $class }}
+        {{ with $wrapper }}{{ . }}{{ end -}}
         {{- if and $backdrop $overlayMode }} background-container{{ end -}}
         {{- if $cover }} section-cover d-flex align-items-center{{ end }}" 
         {{ with $overlayMode -}}
@@ -60,21 +80,29 @@
         {{- end -}}
         >
         {{- if $backdrop -}}
-            {{ partial "assets/live-image.html" (dict "src" $backdrop "class" (printf "background-img-fluid %s" $bgclass) "title" (T "backgroundImage")) }}
+            {{ partial "assets/live-image.html" (dict
+                "src" $backdrop
+                "class" (printf "background-img-fluid %s" $bgclass)
+                "title" (T "backgroundImage"))
+            }}
         {{- end -}}
 
         {{ $col := cond (and $width (lt $width 12)) (printf "col-12 col-md-%d" $width) "" }}
-
-        <div class="container-xxl {{ $padding }} d-flex flex-column align-items-{{ $justify }}">
-            {{ with $col }}
-                <div class="{{ . }}">{{ partial $resolved_component $component_props }}</div>
-            {{ else }}
-                {{ partial $resolved_component $component_props }}
-            {{ end}}
-        </div>
+        {{ if $args.passthrough }}
+            {{ partial $resolved_component $component_props }}
+        {{ else }}
+            <div class="container-{{ cond $fluid "xxl" "fluid" }} {{ $padding }} d-flex flex-column align-items-{{ $justify }}">
+                {{ with $col }}
+                    <div class="{{ . }}">{{ partial $resolved_component $component_props }}</div>
+                {{ else }}
+                    {{ partial $resolved_component $component_props }}
+                {{ end}}
+            </div>
+        {{ end }}
     </section>
+    {{ if not $fluid }}</div>{{ end }}
     {{ "<!--bookshop-live end-->" | safeHTML }}
-{{- else -}}
+{{- else if (not $args.err) -}}
     {{- $file_loc := slicestr $component_path 9 -}}
     {{- $flat_file_loc := slicestr $flat_component_path 9 -}}
     {{- partial "_bookshop/errors/err" (printf "Component \"%s\" does not exist.\n     Create this component by placing a file in your bookshop at %s or %s" $component_name $file_loc $flat_file_loc) -}}

config/_default/hugo.toml

@@ -176,7 +176,7 @@ home = ["HTML", "RSS", "REDIR", "netlify", "server"]
   [[module.imports]]
     path = "github.com/gethinode/mod-csp"
   [[module.imports]]
-    path = "github.com/gethinode/mod-flexsearch/v2"
+    path = "github.com/gethinode/mod-flexsearch/v3"
   [[module.imports]]
     path = "github.com/gethinode/mod-fontawesome/v2"
   [[module.imports]]
@@ -188,7 +188,7 @@ home = ["HTML", "RSS", "REDIR", "netlify", "server"]
   [[module.imports]]
     path = "github.com/gethinode/mod-lottie"
   [[module.imports]]
-    path = "github.com/gethinode/mod-mermaid/v2"
+    path = "github.com/gethinode/mod-mermaid/v3"
   [[module.imports]]
     path = "github.com/gethinode/mod-simple-datatables/v2"
   [[module.imports]]

config/_default/params.toml

@@ -2,9 +2,7 @@
 [main]
     separator = "-"
     description = "Hinode is a clean documentation and blog theme for your Hugo site based on Bootstrap 5."
-    enableDarkMode = true
     enableLanguageSelectionStorage = false
-    modes = ["light", "dark"]
     canonifyAssetsURLs = false
     endorse = true
     footerBelowFold = false
@@ -22,6 +20,12 @@
         tab = false
     [main.build]
         transpiler = "libsass"
+    [main.colorMode]
+        enabled = true
+        modes = ["light", "dark"]
+        toggle = false
+        iconLight = "fas sun"
+        iconDark = "fas moon"
 # toml-docs-end main
 
 # toml-docs-start images
@@ -84,18 +88,31 @@
 [navigation]
     anchor = true
     logo = "/img/logo_icon.svg"
+    logo-mode = false
+    logo-align = "center"
+    logo-height = 30
     color = "body"
     fixed = true
     overlay = false
     overlayMode = "dark"
     horizontal = false
     offset = "5.5rem"
-    search = true
-    searchModal = false
     breadcrumb = true
     toc = true
     sidebar = true
     size = "md"
+    startLevel = 2
+    endLevel = 3
+    maxNumHeadings = 9
+    [navigation.padding]
+        x = 4
+        y = 4
+    [navigation.language]
+        icon = "fas globe"
+    [navigation.search]
+        enabled = true
+        modal = true
+        icon = "fas magnifying-glass"
 # toml-docs-end navigation
 
 # toml-docs-start messages

config/postcss.config.js

@@ -27,9 +27,10 @@ const purgecss = purgeCSSPlugin({
       './assets/scss/theme/fonts.scss',
       './assets/scss/theme/theme.scss',
       './_vendor/github.com/gethinode/mod-cookieyes/v2/assets/scss/cookieyes.scss',
-      './_vendor/github.com/gethinode/mod-flexsearch/v2/assets/scss/modules/flexsearch/flexsearch.scss',
+      './_vendor/github.com/gethinode/mod-flexsearch/v3/assets/scss/modules/flexsearch/flexsearch.scss',
       './_vendor/github.com/gethinode/mod-katex/dist/katex.scss',
       './_vendor/github.com/gethinode/mod-leaflet/dist/leaflet.scss',
+      './_vendor/github.com/gethinode/mod-mermaid/v3/assets/scss/mermaid.scss',
       './_vendor/github.com/gethinode/mod-simple-datatables/v2/dist/simple-datatables.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_carousel.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_dropdown.scss',

content/_index.md

@@ -7,18 +7,18 @@ content_blocks:
       title: Welcome to Hinode!
       content: |-
         A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
-      align: start
+      width: 6
     background:
       color: primary
       subtle: true
     illustration:
       image: /img/sunrise.jpg
       ratio: 16x9
-      width: 8
-    width: 6
+    width: 8
     links:
-      - title: Get started
+      - title: Getting started
         url: https://gethinode.com/docs
-        icon: fas book-open
+        icon: fas chevron-right
     orientation: horizontal
+    justify: center
 ---

content/_modals/_index.md

@@ -0,0 +1,8 @@
+---
+title: Modal elements
+cascade:
+- build:
+    list: local
+    publishResources: false
+    render: never
+---

data/netlify.toml

@@ -4,12 +4,12 @@
     command = "npm run build:example"
 
 [build.environment]
-    DART_SASS_VERSION = "1.83.1"
-    HUGO_VERSION = "0.140.2"
+    DART_SASS_VERSION = "1.89.2"
+    HUGO_VERSION = "0.147.9"
     HUGO_ENV = "production"
     HUGO_ENABLEGITINFO = "true"
-    NODE_VERSION = "22.12.0"
-    NPM_VERSION = "10.9.0"
+    NODE_VERSION = "22.13.0"
+    NPM_VERSION = "10.9.2"
 # toml-docs-end netlify
 
 [context.deploy-preview]

data/structures/card-group.yml

@@ -12,6 +12,7 @@ arguments:
   class:
   color:
   padding:
+    default: 3
   gutter:
     release: v0.19.0
   header-style:
@@ -43,6 +44,7 @@ arguments:
   icon-rounded:
     release: v1.0.0
   align:
+    default: start
   wrapper:
     default: p-0
   responsive:

data/structures/card.yml

@@ -15,6 +15,7 @@ arguments:
     parent: cascade
   padding:
     parent: cascade
+    default: 3
   gutter:
     default: 0
     parent: cascade
@@ -45,6 +46,7 @@ arguments:
   icon-rounded:
     release: v1.0.0
   align:
+    default: start
     parent: cascade
     release: v0.23.0
   scroll:
@@ -71,6 +73,8 @@ arguments:
     group: partial
   anchor:
     release: v0.24.23
+  links:
+    release: v1.14.0
   # deprecated arguments
   header:
     type: select

data/structures/contact.yml

@@ -0,0 +1,36 @@
+comment: >-
+  Displays a contact banner, typically placed at the bottom or right-hand side of the page.
+arguments:
+  page:
+  data:
+  heading:
+  contact:
+    type: string
+    optional: false
+    comment: >-
+      The full name of the contact to retrieve.
+  caption-url:
+    type:
+      - string
+      - template.URL
+    optional: true
+    comment: >-
+      Address of the contact's page, either a local reference or an external
+      address. Include the `scheme` when referencing an external address, such
+      as `https://google.com`. Local references may include an optional anchor
+      link such as `blog/bootstrap-elements/#docs`.
+  illustration:
+  background:
+  link-type:
+  links:
+  align:
+  order:
+    default: first
+  orientation:
+  width:
+  justify:
+  class:
+  width:
+    default: 12
+  hook:
+    default: assets/hero-image.html

data/structures/hero.yml

@@ -3,6 +3,7 @@ comment: >-
   supports a heading, featured illustration, and navigation links. You can
   can also add a background image with an overlay to improve contrast.
 arguments:
+  page:
   breadcrumb:
   heading:
   background:
@@ -18,6 +19,7 @@ arguments:
   justify:
   use-section:
   use-title:
+  size:
   class:
   padding:
     default: px-4 px-xxl-0 py-4
@@ -26,3 +28,5 @@ arguments:
   theme:
   hook:
     default: assets/hero-image.html
+  heading-style:
+  content-style:

data/structures/nav-item.yml

@@ -15,6 +15,9 @@ arguments:
   class:
   body:
     group: partial
+  raw:
+    group: partial
+    release: v1.3.0
   navitem-type:
     release: v1.0.0
   illustration:

data/structures/nav.yml

@@ -7,8 +7,12 @@ arguments:
     group: partial
   list:
     group: partial
+  nav-disabled:
+    release: v1.0.0
   nav-items:
     release: v1.0.0
+  nav-show:
+    release: v1.0.0
   nav-titles:
     release: v1.0.0
   tab-type:
@@ -18,6 +22,8 @@ arguments:
     release: v1.0.0
   class:
   pane:
+  responsive:
+    release: v1.4.0
   width:
     default: 12
     group: partial

data/structures/navbar-item.yml

@@ -9,7 +9,9 @@ arguments:
     comment: Context of the current page.
     group: partial
   menu:
-    type: '*navigation.MenuEntry'
+    type:
+      - '*navigation.MenuEntry'
+      - 'map[string]interface {}'
     optional: false
     comment: Menu data to use for the navbar item.
   parent:
@@ -37,3 +39,24 @@ arguments:
     optional: true
     comment: >-
       Renders the navigation item as plain item, ignoring any children.
+  breakpoint:
+    release: v1.2.0
+  modal:
+    type: string
+    optional: true
+    release: v1.2.0
+    comment: >-
+      If set, toggles a modal control for the provided target.
+  id:
+    type: string
+    optional: true
+    release: v1.2.0
+    comment: >-
+      If set, adds an id attribute to the menu item.
+  fs:
+    type: int
+    optional: true
+    default: 6
+    release: v1.2.0
+    comment: >-
+      Sets the font size of the navigation items when the navbar is collapsed.

data/structures/navbar.yml

@@ -79,6 +79,25 @@ arguments:
     comment: >-
       Address of the logo image, defaults to the parameter `logo` set in the
       `main` section of the site's parameter configuration.
+  logo-align:
+    type: select
+    optional: true
+    default: center
+    comment: Alignment of the logo when the navbar is in collapsed mode.
+    options:
+      values:
+        - start
+        - center
+    release: v1.15.0
+  logo-mode:
+    type: bool
+    default: false
+    optional: true
+    comment: >-
+      Flag indicating if the logo should support color modes. If set, the
+      navbar searches for images having a matching color-mode suffix
+      such as `-light` or `-dark`.
+    release: v1.15.0
   # deprecated arguments
   size:
     type: select

data/structures/script.yml

@@ -1,6 +1,6 @@
 comment: >-
   Includes a reference to a local or external JavaScript file. Hinode uses the
-  template defined in `layouts/partials/templates/script.html` to generate the
+  template defined in `layouts/_partials/templates/script.html` to generate the
   link to a (bundled) JavaScript file. It includes context such as the state,
   category, and integrity. For example, you can adapt this template to implement
   cookie consent management.
@@ -44,3 +44,10 @@ arguments:
     optional: true
     comment: >-
       Cryptographic hash of the script to enable Subresource Integrity (SRI).
+  script-type:
+    type: string
+    optional: true
+    release: v1.7.0
+    comment: >-
+      Type of the attribute of the script. Set the value to `module` to import
+      the script as a JavaScript module.

data/structures/separator.yml

@@ -1,20 +0,0 @@
-comment: >-
-  Inserts a horizontal page section separator.
-arguments:
-  _bookshop_name:
-    type: string
-    optional: true
-    comment: Unique name of the bookshop component
-    group: partial
-  page:
-    type:
-      - '*hugolib.pageState'
-      - '*hugolib.pageForShortcode'
-    optional: true
-    comment: Context of the current page.
-    group: partial
-  theme:
-    type: string
-    optional: true
-    comment: Color theme to apply.
-    release: v1.0.0-alpha

data/structures/timeline.yml

@@ -9,3 +9,4 @@ arguments:
     optional: false
   background:
   class:
+  justify:

exampleSite/config/_default/hugo.toml

@@ -115,7 +115,7 @@ home = ["HTML", "RSS", "REDIR", "netlify", "server"]
   [[module.imports]]
     path = "github.com/gethinode/mod-csp"
   [[module.imports]]
-    path = "github.com/gethinode/mod-flexsearch/v2"
+    path = "github.com/gethinode/mod-flexsearch/v3"
   [[module.imports]]
     path = "github.com/gethinode/mod-fontawesome/v2"
   [[module.imports]]

exampleSite/config/_default/params.toml

@@ -1,9 +1,7 @@
 [main]
     separator = "-"
     description = "Hinode is a clean documentation and blog theme for your Hugo site based on Bootstrap 5."
-    enableDarkMode = true
     enableLanguageSelectionStorage = true
-    modes = ["light", "dark"]
     canonifyAssetsURLs = false
     footerBelowFold = false
     loading = "lazy"
@@ -21,6 +19,12 @@
     [main.build]
         transpiler = "dartsass"
         silenceDeprecations = true
+    [main.colorMode]
+        enabled = true
+        modes = ["light", "dark"]
+        toggle = true
+        iconLight = "fas sun"
+        iconDark = "fas moon"
 
 [debugging]
     showJS = false
@@ -37,6 +41,9 @@
 [navigation]
     anchor = true
     logo = "/img/logo_icon.svg"
+    logo-mode = false
+    logo-align = "center"
+    logo-height = 30
     color = "body"
     fixed = true
     overlay = false
@@ -44,12 +51,23 @@
     horizontal = false
     offset = "5.5rem"
     offsetXS = "5.5rem"
-    search = true
-    searchModal = false
     breadcrumb = true
     toc = true
     sidebar = true
     size = "md"
+    fontsizeCollapsed = 6
+    startLevel = 2
+    endLevel = 3
+    maxNumHeadings = 9
+    [navigation.language]
+        icon = "fas globe"
+    [navigation.padding]
+        x = 4
+        y = 4
+    [navigation.search]
+        enabled = true
+        modal = false
+        icon = "fas magnifying-glass"
 
 [messages]
     placement = "bottom-right"
@@ -165,3 +183,6 @@
 
 [modules.cookieyes]
     url = "https://cdn-cookieyes.com/client_data/a54b5553f349dd13bd225f8e/script.js"
+
+[modules.mermaid]
+    elk = true

exampleSite/config/postcss.config.js

@@ -27,9 +27,10 @@ const purgecss = purgeCSSPlugin({
       './assets/scss/theme/fonts.scss',
       './assets/scss/theme/theme.scss',
       './_vendor/github.com/gethinode/mod-cookieyes/v2/assets/scss/cookieyes.scss',
-      './_vendor/github.com/gethinode/mod-flexsearch/v2/assets/scss/modules/flexsearch/flexsearch.scss',
+      './_vendor/github.com/gethinode/mod-flexsearch/v3/assets/scss/modules/flexsearch/flexsearch.scss',
       './_vendor/github.com/gethinode/mod-katex/dist/katex.scss',
       './_vendor/github.com/gethinode/mod-leaflet/dist/leaflet.scss',
+      './_vendor/github.com/gethinode/mod-mermaid/v3/assets/scss/mermaid.scss',
       './_vendor/github.com/gethinode/mod-simple-datatables/v2/dist/simple-datatables.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_carousel.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_dropdown.scss',

exampleSite/content/en/_index.md

@@ -56,6 +56,7 @@ content_blocks:
     cols: 1
     padding: 4
     limit: 2
+    icon-style: fa-5x
     header-style: none
     footer-style: tags
     orientation: horizontal-sm

exampleSite/content/en/blocks/_index.md

@@ -6,18 +6,17 @@ content_blocks:
   - _bookshop_name: hero
     heading:
       title: Content blocks
-      align: start
-    breadcrumb: true
-
-  - _bookshop_name: articles
-    heading:
       content: >-
         Hinode uses [Bookshop](https://github.com/CloudCannon/bookshop) to
         support so-called content blocks. Content blocks are reusable page
         elements, such as a hero, about panel, or an FAQ. Hinode includes
         several ready-to-use blocks. Click on a card for more details about
         a content block, including its frontmatter configuration.
+      align: start
       width: 8
+    breadcrumb: true
+
+  - _bookshop_name: articles
     hide-empty: false
     input:
       section: blocks
@@ -26,9 +25,10 @@ content_blocks:
     more:
       title: More Posts
     cols: 3
-    padding: 0
+    padding: 3
     limit: 9
     paginate: true
     cover: false
     header-style: none
+    class: border-1
 ---

exampleSite/content/en/blocks/about.md

@@ -25,6 +25,7 @@ The `about` content block renders a short message next to an illustration. You c
     subtle: true
   illustration:
     image: /assets/img/nat-9l98kFByiao-unsplash.jpg
+    ratio: 1x1
   link-type: link
   links:
     - title: First link

exampleSite/content/en/blocks/cards.md

@@ -24,14 +24,19 @@ The `cards` content block renders a group of content cards.
     subtle: true
   orientation: stacked
   icon-rounded: true
-  class: text-center
+  icon-style: fa-xs
+  padding: 0
+  align: start
   elements:
     - title: First Card
       icon: fas 1
+      content: Content of the first card
     - title: Second Card
       icon: fas 2
+      content: Content of the second card
     - title: Third Card
       icon: fas 3
+      content: Content of the third card
 ```
 
 {{< /example-bookshop >}}
@@ -42,3 +47,145 @@ The `cards` content block renders a group of content cards.
 The content block supports the following arguments:
 
 {{< args bookshop-cards >}}
+
+## Examples
+
+### Stacked cards with an image
+
+Set the `image` attribute of each `element` to an image asset to render illustrated cards.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cards
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Cards content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  orientation: stacked
+  class: bg-body
+  align: center
+  elements:
+    - title: First Card
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+    - title: Second Card
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+    - title: Third Card
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Horizontal cards with an image
+
+Set the `orientation` attribute to `horizontal` to render horizontally oriented cards.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cards
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Cards content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  orientation: horizontal
+  class: bg-body
+  align: center
+  elements:
+    - title: First Card
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: Content of the first card
+    - title: Second Card
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: Content of the second card
+    - title: Third Card
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: Content of the third card
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Stacked cards with an icon
+
+Set the `icon` attribute of each `element` to an icon to render illustrated cards. Adjust the icon's styling with `icon-rounded` and `icon-style`.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cards
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Cards content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  orientation: stacked
+  icon-style: fa-xs text-primary
+  align: start
+  padding: 0
+  elements:
+    - title: First Card
+      icon: fas 1
+      content: Content of the first card
+    - title: Second Card
+      icon: fas 2
+      content: Content of the second card
+    - title: Third Card
+      icon: fas 3
+      content: Content of the third card
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Horizontal cards with an icon
+
+Set the `icon` attribute of each `element` to an icon to render illustrated cards. Adjust the icon's styling with `icon-rounded` and `icon-style`.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cards
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Cards content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  orientation: horizontal
+  icon-rounded: true
+  icon-style: fa-2xs text-primary
+  align: start
+  padding: 0
+  elements:
+    - title: First Card
+      icon: fas 1
+      content: Content of the first card
+    - title: Second Card
+      icon: fas 2
+      content: Content of the second card
+    - title: Third Card
+      icon: fas 3
+      content: Content of the third card
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->

exampleSite/content/en/blocks/cta.md

@@ -0,0 +1,36 @@
+---
+_schema: default
+title: CTA
+description: Use the CTA content block to display an action link with an optional contact.
+icon: fas address-card
+---
+
+## Overview
+
+The `cta` content block renders a call to action link or button. You can include an optional contact or provide your own illustration. By default, the `cta` uses a generic title and message. Set the `heading` attribute to override these values.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cta
+  contact: Betty White
+  caption-url: /en/blocks/cta/
+  background:
+    color: primary
+    subtle: true
+  order: first
+  links:
+    - title: Get in touch
+      url: '#!'
+      icon: fas chevron-right
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+## Arguments
+
+The content block supports the following arguments:
+
+{{< args bookshop-cta >}}

exampleSite/content/en/blocks/panels.md

@@ -0,0 +1,189 @@
+---
+_schema: default
+title: Panels
+description: Use the panels content block to display multiple toggable panels.
+icon: fa folder
+---
+
+## Overview
+
+The `panels` content block displays multiple panels that are toggled by a tab control.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: panels
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Panels content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  width: 12
+  tab-type: underline
+  ratio: 1x1
+  elements:
+    - title: First Panel
+      image: /img/sunrise.jpg
+      content: content 1
+    - title: Second Panel
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: content 2
+    - title: Third Panel
+      image: /img/pj-accetturo-XpD6Dkui-yg-unsplash.jpg
+      content: content 3
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+## Arguments
+
+The content block supports the following arguments:
+
+{{< args bookshop-panels >}}
+
+## Examples
+
+### Tabs
+
+Set `tab-type` to `tabs` to adjust the panel controls.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: panels
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Panels content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  width: 12
+  tab-type: tabs
+  ratio: 1x1
+  elements:
+    - title: First Panel
+      image: /img/sunrise.jpg
+      content: content 1
+    - title: Second Panel
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: content 2
+    - title: Third Panel
+      image: /img/pj-accetturo-XpD6Dkui-yg-unsplash.jpg
+      content: content 3
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Pills
+
+Set `tab-type` to `pills` to adjust the panel controls.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: panels
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Panels content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  width: 12
+  tab-type: pills
+  ratio: 1x1
+  elements:
+    - title: First Panel
+      image: /img/sunrise.jpg
+      content: content 1
+    - title: Second Panel
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: content 2
+    - title: Third Panel
+      image: /img/pj-accetturo-XpD6Dkui-yg-unsplash.jpg
+      content: content 3
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Underline
+
+Set `tab-type` to `underline` to adjust the panel controls.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: panels
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Panels content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  width: 12
+  tab-type: underline
+  ratio: 1x1
+  elements:
+    - title: First Panel
+      image: /img/sunrise.jpg
+      content: content 1
+    - title: Second Panel
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: content 2
+    - title: Third Panel
+      image: /img/pj-accetturo-XpD6Dkui-yg-unsplash.jpg
+      content: content 3
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Callout
+
+Set `tab-type` to `callout` to adjust the panel controls.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: panels
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Panels content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  width: 12
+  tab-type: callout
+  ratio: 1x1
+  elements:
+    - title: First Panel
+      image: /img/sunrise.jpg
+      content: content 1
+    - title: Second Panel
+      image: /img/nat-9l98kFByiao-unsplash.jpg
+      content: content 2
+    - title: Third Panel
+      image: /img/pj-accetturo-XpD6Dkui-yg-unsplash.jpg
+      content: content 3
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->

exampleSite/content/en/blocks/video-message.md

@@ -24,10 +24,12 @@ The `video` content block renders a horizontal line to separate sections. The se
     color: primary
     subtle: true
   orientation: horizontal
+  icon-style: fa-lg
   video:
     provider: vimeo
     media-id: "55073825"
     autoplay: true
+    color: black
   messages:
     - title: First Message
       icon: fas 1

exampleSite/content/en/blog/bootstrap-elements.md

@@ -362,14 +362,14 @@ As an example, the following shortcode displays a tab group with vertically alig
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
   {{</* nav tab-type="pills" vertical="true" */>}}
-    {{</* nav-item title="Nav Item #1" show="true" */>}}
+    {{</* nav-item title="Nav Item #1" */>}}
       This is the first item's nav body. It supports Markdown content.
       The item is shown by adding the value `show` to the `class` argument.
     {{</* /nav-item */>}}
-    {{</* nav-item title="Nav Item #2" */>}}
+    {{</* nav-item title="Nav Item #2" show="true" */>}}
       This is the second item's nav body.
     {{</* /nav-item */>}}
-    {{</* nav-item title="Nav Item #3" */>}}
+    {{</* nav-item title="Nav Item #3" disabled="true" */>}}
       This is the third item's nav body.
     {{</* /nav-item */>}}
   {{</* /nav */>}}

exampleSite/content/en/blog/components.md

@@ -4,7 +4,7 @@ title: Components
 date: 2023-09-23
 description: Use shortcodes to add predefined components powered by external libraries.
 tags: ["bootstrap", "shortcode"]
-keywords: ["featured"]
+keywords: featured
 thumbnail:
   url: img/puzzle.jpg
   author: Ryoji Iwata
@@ -94,6 +94,22 @@ As an example, the following shortcode displays an interactive map of the city o
 
 ## Mermaid Diagrams
 
+### Shortcode (with controls and frontmatter)
+
+<!-- markdownlint-disable MD003 MD022 -->
+{{< mermaid controls=true >}}
+---
+config:
+  layout: elk.stress
+  look: handDrawn
+  theme: forest
+---
+flowchart TD
+  A --> B
+  A --> C
+{{< /mermaid >}}
+<!-- markdownlint-enable MD003 MD022 -->
+
 ### Flowchart
 
 ```mermaid

exampleSite/content/en/blog/content-blocks.md

@@ -4,7 +4,7 @@ title: Content blocks
 date: 2025-06-07
 description: Quickly edit your webpages using reusable content blocks.
 tags: ["bookshop", "blocks"]
-keywords: ["featured"]
+keywords: featured
 thumbnail:
   url: img/pj-accetturo-XpD6Dkui-yg-unsplash.jpg
   author: Pj Accetturo

exampleSite/content/fr/_index.md

@@ -2,14 +2,63 @@
 author: Mark Dumay
 title: Bienvenue sur Hinode!
 description: Un thème de blog et de documentation pour Hugo basé sur Bootstrap 5.
-thumbnail:
-  url: /img/sunrise.jpg
-  author: Harris Vo
-  authorURL: https://unsplash.com/@hoanvokim
-  origin: https://unsplash.com/photos/ZX6BPboJrYk
-  originName: Unsplash
-actions:
-  about:
-    url: "a-propos"
-    title: "À propos"
+content_blocks:
+  - _bookshop_name: hero
+    heading:
+      title: Bienvenue sur Hinode!
+      content: |-
+        Un thème de blog et de documentation pour Hugo basé sur Bootstrap 5.
+      width: 6
+    background:
+      color: primary
+      subtle: true
+    illustration:
+      image: /img/sunrise.jpg
+      ratio: 16x9
+    width: 8
+    links:
+      - title: À propos
+        url: "/fr/a-propos/"
+        icon: fas chevron-right
+    orientation: horizontal
+    justify: center
+
+  - _bookshop_name: articles
+    heading:
+      title: Articles de blog
+      align: start
+    input:
+      section: blog
+      reverse: true
+      sort: date
+      keywords: featured
+    hide-empty: false
+    header-style: none
+    more:
+      title: Plus d'articles
+    padding: 0
+    limit: 3
+    class: border-0 card-zoom card-body-margin
+
+  - _bookshop_name: articles
+    heading:
+      title: Projets
+      align: start
+    background:
+      background: body-tertiary
+    hide-empty: false
+    input:
+      section: projects
+      reverse: false
+      sort: date
+    more:
+      title: Plus d'articles
+    cols: 1
+    padding: 4
+    limit: 2
+    icon-style: fa-5x
+    header-style: none
+    footer-style: tags
+    orientation: horizontal-sm
+    class: border-1 card-emphasize
 ---

exampleSite/content/fr/blog/bootstrap-elements.md

@@ -5,6 +5,7 @@ slug: elements-bootstrap
 date: 2023-08-12
 description: Utilisez des shortcodes pour ajouter facilement des éléments Bootstrap courants.
 tags: ["bootstrap", "shortcode"]
+keywords: featured
 thumbnail:
   url: img/boots.jpg
   author: Nathan Dumlao

exampleSite/content/fr/blog/components.md

@@ -5,6 +5,7 @@ slug: composents
 date: 2023-07-21
 description: Utilisez des shortcodes pour ajouter des composants prédéfinis alimentés par des bibliothèques externes.
 tags: ["bootstrap", "shortcode"]
+keywords: featured
 thumbnail:
   url: img/puzzle.jpg
   author: Ryoji Iwata

exampleSite/content/fr/blog/image.md

@@ -4,6 +4,7 @@ title: Images locales et distantes
 date: 2024-05-19
 description: Inclure des images responsives provenant de sources locales et de certains fournisseurs de CDN d'images.
 tags: ["blog"]
+keywords: featured
 thumbnail:
   url: https://assets.imgix.net/examples/bluehat.jpg
 ---

exampleSite/content/nl/_index.md

@@ -2,14 +2,62 @@
 author: Mark Dumay
 title: Welkom bij Hinode!
 description: Een documentatie en blog thema voor Hugo gebaseerd op Bootstrap 5.
-thumbnail:
-    url: /img/sunrise.jpg
-    author: Harris Vo
-    authorURL: https://unsplash.com/@hoanvokim
-    origin: https://unsplash.com/photos/ZX6BPboJrYk
-    originName: Unsplash
-actions:
-  about:
-    url: "over-mij"
-    title: "Over mij"
+content_blocks:
+  - _bookshop_name: hero
+    heading:
+      title: Welkom bij Hinode!
+      content: |-
+        Een documentatie en blog thema voor Hugo gebaseerd op Bootstrap 5.
+      width: 6
+    background:
+      color: primary
+      subtle: true
+    illustration:
+      image: /img/sunrise.jpg
+      ratio: 16x9
+    width: 8
+    links:
+      - title: "Over mij"
+        url: "/nl/over-mij/"
+        icon: fas chevron-right
+    orientation: horizontal
+    justify: center
+
+  - _bookshop_name: articles
+    heading:
+      title: Blog
+      align: start
+    input:
+      section: blog
+      reverse: true
+      sort: date
+    hide-empty: false
+    header-style: none
+    more:
+      title: Meer artikelen
+    padding: 0
+    limit: 3
+    class: border-0 card-zoom card-body-margin
+
+  - _bookshop_name: articles
+    heading:
+      title: Projecten
+      align: start
+    background:
+      background: body-tertiary
+    hide-empty: false
+    input:
+      section: projects
+      reverse: false
+      sort: date
+    more:
+      title: Meer artikelen
+    cols: 1
+    padding: 4
+    limit: 2
+    icon-style: fa-5x
+    header-style: none
+    footer-style: tags
+    orientation: horizontal-sm
+    class: border-1 card-emphasize
 ---