buckram 1.8.8 → 1.9.1

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.8.8"
+  ".": "1.9.1"
 }

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.9.1](https://github.com/pressbooks/buckram/compare/v1.9.0...v1.9.1) (2026-04-28)
+
+
+### Bug Fixes
+
+* **deps:** bump pressbooks-build-tools to v6 ([#408](https://github.com/pressbooks/buckram/issues/408)) ([893d388](https://github.com/pressbooks/buckram/commit/893d38867cc0ce6b703438ea212ce824c7c939d6))
+* set tag types for TOC properly in PDF exports ([#395](https://github.com/pressbooks/buckram/issues/395)) ([b9ecded](https://github.com/pressbooks/buckram/commit/b9ecdedd5366a0bb982b20eed3283224ac3ccef8))
+
+## [1.9.0](https://github.com/pressbooks/buckram/compare/v1.8.8...v1.9.0) (2026-04-15)
+
+
+### Features
+
+* prince 16 support ([#411](https://github.com/pressbooks/buckram/issues/411)) ([6a0460a](https://github.com/pressbooks/buckram/commit/6a0460a4e0e554e9a7547d5ca313a32d0dfe9a9b))
+
 ## [1.8.8](https://github.com/pressbooks/buckram/compare/v1.8.7...v1.8.8) (2025-10-02)
 
 

package/assets/styles/components/elements/_blockquotes.scss

@@ -19,6 +19,7 @@
     word-spacing: if-map-get($blockquote-word-spacing, $type);
     border-left: if-map-get($blockquote-border-left-width, $type) $blockquote-border-left-style;
     border-left-color: $blockquote-border-left-color;
+    box-decoration-break: $box-decoration-break;
     @if $type == 'prince' {
       line-height: $blockquote-line-height;
     }

package/assets/styles/components/specials/_footnotes.scss

@@ -134,6 +134,7 @@
   ol {
     margin-top: $endnote-ol-margin-top;
     margin-left: $endnote-ol-margin-left;
+    padding-left: $endnote-ol-padding-left;
     font-size: $endnote-ol-font-size;
     list-style-position: outside;
   }

package/assets/styles/components/specials/_pullquotes.scss

@@ -21,6 +21,7 @@ aside,
   border-right: $aside-border-right;
   border-bottom: $aside-border-bottom;
   border-left: $aside-border-left;
+  box-decoration-break: $box-decoration-break;
 }
 
 // Pullquotes

package/assets/styles/components/specials/_textboxes.scss

@@ -113,15 +113,18 @@
   border-style: $textbox-border-style;
   border-width: if-map-get($textbox-border-width, $type);
   border-radius: if-map-get($textbox-border-radius, $type);
+  box-decoration-break: $box-decoration-break;
 
   ul {
     margin-top: $textbox-ul-margin-top;
     margin-bottom: $textbox-ul-margin-bottom;
+    padding-left: $textbox-ul-padding-left;
   }
 
   ol {
     margin-top: $textbox-ol-margin-top;
     margin-bottom: $textbox-ol-margin-bottom;
+    padding-left: $textbox-ol-padding-left;
   }
 
   li {

package/assets/styles/components/structure/_mixins.scss

@@ -14,7 +14,7 @@
     @each $page-type in
       'front-matter:#{$page-position}' {
       @page #{$page-type} {
-        @if $page-position == 'first:left' {
+        @if $page-position == 'first-of-group:left' {
           @if if-map-get($content-position, left) {
             @include position(if-map-get($content-position, left)) {
               @if head-or-foot(if-map-get($content-position, left)) == 'head' {
@@ -26,7 +26,7 @@
               @include front-matter-page-number;
             }
           }
-        } @else if $page-position == 'first:right' {
+        } @else if $page-position == 'first-of-group:right' {
           @if if-map-get($content-position, right) {
             @include position(if-map-get($content-position, right)) {
               @if head-or-foot(if-map-get($content-position, right)) == 'head' {
@@ -59,7 +59,7 @@
       'chapter:#{$page-position}',
       'back-matter:#{$page-position}' {
       @page #{$page-type} {
-        @if $page-position == 'first:left' {
+        @if $page-position == 'first-of-group:left' {
           @if if-map-get($content-position, left) {
             @include position(if-map-get($content-position, left)) {
               @if head-or-foot(if-map-get($content-position, left)) == 'head' {
@@ -71,7 +71,7 @@
               @include page-number;
             }
           }
-        } @else if $page-position == 'first:right' {
+        } @else if $page-position == 'first-of-group:right' {
           @if if-map-get($content-position, right) {
             @include position(if-map-get($content-position, right)) {
               @if head-or-foot(if-map-get($content-position, right)) == 'head' {
@@ -217,7 +217,7 @@
     'chapter:#{$page-position}',
     'back-matter:#{$page-position}' {
     @page #{$page-type} {
-      @if $page-position == 'first:left' {
+      @if $page-position == 'first-of-group:left' {
         @if if-map-get($content-position, left) {
           @include position(if-map-get($content-position, left)) {
             padding-top: $runninghead-padding-top;
@@ -232,7 +232,7 @@
             text-transform: $runninghead-left-text-transform;
           }
         }
-      } @else if $page-position == 'first:right' {
+      } @else if $page-position == 'first-of-group:right' {
         @if if-map-get($content-position, right) {
           @include position(if-map-get($content-position, right)) {
             padding-top: $runninghead-padding-top;
@@ -290,7 +290,7 @@
     'chapter:#{$page-position}',
     'back-matter:#{$page-position}' {
     @page #{$page-type} {
-      @if $page-position == 'first:left' {
+      @if $page-position == 'first-of-group:left' {
         @if if-map-get($content-position, left) {
           @include position(if-map-get($content-position, left)) {
             padding-bottom: $runningfoot-padding-bottom;
@@ -305,7 +305,7 @@
             text-transform: $runningfoot-left-text-transform;
           }
         }
-      } @else if $page-position == 'first:right' {
+      } @else if $page-position == 'first-of-group:right' {
         @if if-map-get($content-position, right) {
           @include position(if-map-get($content-position, right)) {
             padding-bottom: $runningfoot-padding-bottom;
@@ -359,7 +359,7 @@
 @mixin page-structure($page-type, $page-position, $numbering-position, $running-content-position) {
   @if $numbering-position and $running-content-position {
     @if $numbering-position == $running-content-position {
-      @if $page-position != 'first' {
+      @if $page-position != 'first-of-group' {
         @page #{$page-type}:#{$page-position} {
           @include position($running-content-position) {
             @if $page-position == 'left' {
@@ -384,7 +384,7 @@
           }
         }
       } @else {
-        @page #{$page-type}:first:right {
+        @page #{$page-type}:first-of-group:right {
           @include position(if-map-get($running-content-position, right)) {
             @if if-map-get($running-content-position, right) == '@bottom-left'
               or if-map-get($running-content-position, right) == '@bottom-left-corner'
@@ -396,7 +396,7 @@
           }
         }
 
-        @page #{$page-type}:first:left {
+        @page #{$page-type}:first-of-group:left {
           @include position(if-map-get($running-content-position, left)) {
             @if if-map-get($running-content-position, left) == '@bottom-right'
               or if-map-get($running-content-position, left) == '@bottom-right-corner'
@@ -409,7 +409,7 @@
         }
       }
     } @else {
-      @if $page-position != 'first' {
+      @if $page-position != 'first-of-group' {
         @page #{$page-type}:#{$page-position} {
           @include position($running-content-position) {
             @if $page-position == 'left' {
@@ -429,7 +429,7 @@
 
         }
       } @else {
-        @page #{$page-type}:first:right {
+        @page #{$page-type}:first-of-group:right {
           @include position(if-map-get($running-content-position, right)) {
             content: if-map-get($right-running-content, $page-type);
           }
@@ -438,7 +438,7 @@
           }
         }
 
-        @page #{$page-type}:first:left {
+        @page #{$page-type}:first-of-group:left {
           @include position(if-map-get($running-content-position, left)) {
             content: if-map-get($left-running-content, $page-type);
           }
@@ -450,7 +450,7 @@
     }
   } @else {
     @if $numbering-position {
-      @if $page-position != 'first' {
+      @if $page-position != 'first-of-group' {
         @page #{$page-type}:#{$page-position} {
           @include position($numbering-position) {
             @if $page-position == 'left' {
@@ -461,13 +461,13 @@
           }
         }
       } @else {
-        @page #{$page-type}:first:right {
+        @page #{$page-type}:first-of-group:right {
           @include position(if-map-get($numbering-position, right)) {
             content: if-map-get($right-page-number, $page-type);
           }
         }
 
-        @page #{$page-type}:first:left {
+        @page #{$page-type}:first-of-group:left {
           @include position(if-map-get($numbering-position, left)) {
             content: if-map-get($left-page-number, $page-type);
           }
@@ -476,7 +476,7 @@
     }
 
     @if $running-content-position {
-      @if $page-position != 'first' {
+      @if $page-position != 'first-of-group' {
         @page #{$page-type}:#{$page-position} {
           @include position($running-content-position) {
             @if $page-position == 'left' {
@@ -487,13 +487,13 @@
           }
         }
       } @else {
-        @page #{$page-type}:first:right {
+        @page #{$page-type}:first-of-group:right {
           @include position(if-map-get($running-content-position, right)) {
             content: if-map-get($right-running-content, $page-type);
           }
         }
 
-        @page #{$page-type}:first:left {
+        @page #{$page-type}:first-of-group:left {
           @include position(if-map-get($running-content-position, left)) {
             content: if-map-get($left-running-content, $page-type);
           }

package/assets/styles/components/structure/_running-content.scss

@@ -51,8 +51,8 @@ $right-page-number: (
 
 // Now we style the appropriate location using our page-numbers mixin.
 
-@include page-numbers('first:left', convert-position('first', $first-numbering-position));
-@include page-numbers('first:right', convert-position('first', $first-numbering-position));
+@include page-numbers('first-of-group:left', convert-position('first', $first-numbering-position));
+@include page-numbers('first-of-group:right', convert-position('first', $first-numbering-position));
 @include page-numbers('left', convert-position('left', $numbering-position));
 @include page-numbers('right', convert-position('right', $numbering-position));
 
@@ -62,13 +62,13 @@ $right-page-number: (
 // Now we style the appropriate location using our runninghead or runningfoot mixin.
 
 @if head-or-foot($running-content-position) == 'head' {
-  @include runninghead('first:left', convert-position('first', $first-running-content-position));
-  @include runninghead('first:right', convert-position('first', $first-running-content-position));
+  @include runninghead('first-of-group:left', convert-position('first', $first-running-content-position));
+  @include runninghead('first-of-group:right', convert-position('first', $first-running-content-position));
   @include runninghead('left', convert-position('left', $running-content-position));
   @include runninghead('right', convert-position('right', $running-content-position));
 } @else if head-or-foot($running-content-position) == 'foot' {
-  @include runningfoot('first:left', convert-position('first', $first-running-content-position));
-  @include runningfoot('first:right', convert-position('first', $first-running-content-position));
+  @include runningfoot('first-of-group:left', convert-position('first', $first-running-content-position));
+  @include runningfoot('first-of-group:right', convert-position('first', $first-running-content-position));
   @include runningfoot('left', convert-position('left', $running-content-position));
   @include runningfoot('right', convert-position('right', $running-content-position));
 }
@@ -80,56 +80,56 @@ $right-page-number: (
 // depending on section type
 
 // Front Matter
-@page front-matter:first {
+@page front-matter:first-of-group {
   @include blank-head-and-foot;
 }
 
-@include page-structure('front-matter', 'first', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('front-matter', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
 @include page-structure('front-matter', 'left', convert-position('left', $numbering-position), convert-position('left', $running-content-position));
 @include page-structure('front-matter', 'right', convert-position('right', $numbering-position), convert-position('right', $running-content-position));
 
 // Introduction
-@page introduction:first {
+@page introduction:first-of-group {
   @include blank-head-and-foot;
 }
 
-@include page-structure('introduction', 'first', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('introduction', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
 @include page-structure('introduction', 'left', convert-position('left', $numbering-position), convert-position('left', $running-content-position));
 @include page-structure('introduction', 'right', convert-position('right', $numbering-position), convert-position('right', $running-content-position));
 
 // Post-introduction
-@page post-introduction:first {
+@page post-introduction:first-of-group {
   @include blank-head-and-foot;
 }
 
-@include page-structure('post-introduction', 'first', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('post-introduction', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
 @include page-structure('post-introduction', 'left', convert-position('left', $numbering-position), convert-position('left', $running-content-position));
 @include page-structure('post-introduction', 'right', convert-position('right', $numbering-position), convert-position('right', $running-content-position));
 
 
 // Parts
-@page part:first {
+@page part:first-of-group {
   @include blank-head-and-foot;
 }
 
-@include page-structure('part', 'first', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('part', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
 @include page-structure('part', 'left', convert-position('left', $numbering-position), convert-position('left', $running-content-position));
 @include page-structure('part', 'right', convert-position('right', $numbering-position), convert-position('right', $running-content-position));
 
 // Chapters
-@page chapter:first {
+@page chapter:first-of-group {
   @include blank-head-and-foot;
 }
 
-@include page-structure('chapter', 'first', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('chapter', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
 @include page-structure('chapter', 'left', convert-position('left', $numbering-position), convert-position('left', $running-content-position));
 @include page-structure('chapter', 'right', convert-position('right', $numbering-position), convert-position('right', $running-content-position));
 
 // Back Matter
-@page back-matter:first {
+@page back-matter:first-of-group {
   @include blank-head-and-foot;
 }
 
-@include page-structure('back-matter', 'first', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('back-matter', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
 @include page-structure('back-matter', 'left', convert-position('left', $numbering-position), convert-position('left', $running-content-position));
 @include page-structure('back-matter', 'right', convert-position('right', $numbering-position), convert-position('right', $running-content-position));

package/assets/styles/components/toc/_center.scss

@@ -36,6 +36,16 @@
 
 @if $type == 'prince' {
   #toc {
+    ul {
+      /* stylelint-disable-next-line value-keyword-case */
+      -prince-pdf-tag-type: TOC;
+    }
+
+    li {
+      /* stylelint-disable-next-line value-keyword-case */
+      -prince-pdf-tag-type: TOCI;
+    }
+
     a::after {
       display: $toc-center-page-number-display;
     }
@@ -50,4 +60,4 @@
       display: $toc-center-chapter-number-display;
     }
   }
-}
+}

package/assets/styles/components/toc/_generic.scss

@@ -252,10 +252,14 @@
     }
 
     ul {
+      /* stylelint-disable-next-line value-keyword-case */
+      -prince-pdf-tag-type: TOC;
       counter-reset: chapter;
     }
 
     li {
+      /* stylelint-disable-next-line value-keyword-case */
+      -prince-pdf-tag-type: TOCI;
       page-break-inside: avoid;
       position: relative;
     }

package/assets/styles/components/toc/_left.scss

@@ -52,6 +52,16 @@
 
 @if $type == 'prince' {
   #toc {
+    ul {
+      /* stylelint-disable-next-line value-keyword-case */
+      -prince-pdf-tag-type: TOC;
+    }
+
+    li {
+      /* stylelint-disable-next-line value-keyword-case */
+      -prince-pdf-tag-type: TOCI;
+    }
+
     a::after {
       display: $toc-left-page-number-display;
       position: absolute;

package/assets/styles/variables/_elements.scss

@@ -755,6 +755,13 @@ $blockquote-border-left-style: none !default;
 /// @since 1.0.0
 $blockquote-border-left-color: initial !default;
 
+/// Box decoration break behavior for elements that may span page breaks (textboxes, asides, blockquotes).
+/// Set to `clone` to restore Prince 15 behavior where borders, padding, and backgrounds
+/// are repeated on each page fragment. Prince 16+ defaults to `slice` per CSS spec.
+/// @type String
+/// @since 1.9.0
+$box-decoration-break: clone !default;
+
 /// Top margin for `<ol>` elements.
 /// @type String | Map
 $ol-margin-top: 1em !default;

package/assets/styles/variables/_specials.scss

@@ -204,6 +204,12 @@ $endnote-ol-margin-top: 0.4em !default;
 /// @type String
 $endnote-ol-margin-left: 0 !default;
 
+/// Left padding on ordered lists within endnotes on `<ol>` elements that are children of elements with a class of `endnotes`.
+/// Required for correct list indentation in Prince 16+ which uses padding-based list indentation.
+/// @type String
+/// @since 1.9.0
+$endnote-ol-padding-left: 0 !default;
+
 /// Font size on ordered lists within endnotes on `<ol>` elements that are children of elements with a class of `endnotes`.
 /// @type String
 $endnote-ol-font-size: 0.85em !default;
@@ -690,6 +696,12 @@ $textbox-ol-margin-top: 1em !default;
 /// @since 1.0.0
 $textbox-ol-margin-bottom: 0.75em !default;
 
+/// Textbox left padding on `<ol>` elements that are children of elements with a class of `textbox`.
+/// Required for correct list indentation in Prince 16+ which uses padding-based list indentation.
+/// @type String
+/// @since 1.9.0
+$textbox-ol-padding-left: 1em !default;
+
 /// Textbox header top margin on `<ul>` elements that are children of elements with a class of `textbox`.
 /// @type String
 /// @since 1.0.0
@@ -700,6 +712,12 @@ $textbox-ul-margin-top: 1em !default;
 /// @since 1.0.0
 $textbox-ul-margin-bottom: 0.75em !default;
 
+/// Textbox left padding on `<ul>` elements that are children of elements with a class of `textbox`.
+/// Required for correct list indentation in Prince 16+ which uses padding-based list indentation.
+/// @type String
+/// @since 1.9.0
+$textbox-ul-padding-left: 1em !default;
+
 /// Textbox header left margin on `<li>` elements that are children of elements with a class of `textbox`.
 /// @type String
 /// @since 1.0.0

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "buckram",
-  "version": "1.8.8",
+  "version": "1.9.1",
   "description": "Opinionated SCSS components for books (web, EPUB and PDF).",
   "scripts": {
     "build": "composer install && composer test",
-    "diff": "npm run -s build && mocha",
+    "diff": "run-s build mocha",
     "docs": "cross-env NODE_ENV=development node_modules/sassdoc/bin/sassdoc assets/styles --config sassdoc.json",
-    "lint": "npm run -s lint:styles",
-    "lint:styles": "stylelint 'assets/styles/**/*.scss'",
-    "test": "npm run -s lint && npm run -s build"
+    "lint": "pressbooks-build-tools lint:styles 'assets/styles/**/*.scss'",
+    "fix": "pressbooks-build-tools fix:styles 'assets/styles/**/*.scss'",
+    "mocha": "mocha",
+    "test": "run-s lint build"
   },
   "repository": {
     "type": "git",
@@ -26,22 +27,28 @@
   "devDependencies": {
     "chai": "^4.1.2",
     "mocha": "^10.0.0",
+    "npm-run-all2": "^8.0.4",
     "pixelmatch": "^5.2.1",
     "polyserve": "^0.27.15",
-    "pressbooks-build-tools": "^4.0.0",
+    "pressbooks-build-tools": "^6.0.0",
     "puppeteer": "^23.6.0",
     "sassdoc": "^2.7.1",
     "type-detect": "^4.0.8"
   },
-  "eslintConfig": {
-    "extends": "./node_modules/pressbooks-build-tools/config/eslint.js"
-  },
   "stylelint": {
-    "extends": "./node_modules/pressbooks-build-tools/config/stylelint.js",
+    "extends": "pressbooks-build-tools/stylelint",
     "rules": {
       "no-descending-specificity": null,
       "no-duplicate-at-import-rules": null,
-      "scss/no-global-function-names": null
+      "scss/no-global-function-names": null,
+      "selector-pseudo-class-no-unknown": [
+        true,
+        {
+          "ignorePseudoClasses": [
+            "first-of-group"
+          ]
+        }
+      ]
     }
   }
 }