buckram 1.9.1 → 1.10.0

package/.release-please-manifest.json

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

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.10.0](https://github.com/pressbooks/buckram/compare/v1.9.1...v1.10.0) (2026-05-06)
+
+
+### Features
+
+* new dynamic parameters ([#415](https://github.com/pressbooks/buckram/issues/415)) ([a71a7ef](https://github.com/pressbooks/buckram/commit/a71a7ef72c29873793d029d6348a5c3113a488b7))
+
 ## [1.9.1](https://github.com/pressbooks/buckram/compare/v1.9.0...v1.9.1) (2026-04-28)
 
 

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-of-group:left' {
+        @if $page-position == '#{$first-page-pseudo}: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-of-group:right' {
+        } @else if $page-position == '#{$first-page-pseudo}: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-of-group:left' {
+        @if $page-position == '#{$first-page-pseudo}: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-of-group:right' {
+        } @else if $page-position == '#{$first-page-pseudo}: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-of-group:left' {
+      @if $page-position == '#{$first-page-pseudo}: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-of-group:right' {
+      } @else if $page-position == '#{$first-page-pseudo}: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-of-group:left' {
+      @if $page-position == '#{$first-page-pseudo}: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-of-group:right' {
+      } @else if $page-position == '#{$first-page-pseudo}: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-of-group' {
+      @if $page-position != $first-page-pseudo {
         @page #{$page-type}:#{$page-position} {
           @include position($running-content-position) {
             @if $page-position == 'left' {
@@ -384,7 +384,7 @@
           }
         }
       } @else {
-        @page #{$page-type}:first-of-group:right {
+        @page #{$page-type}:#{$first-page-pseudo}: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-of-group:left {
+        @page #{$page-type}:#{$first-page-pseudo}: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-of-group' {
+      @if $page-position != $first-page-pseudo {
         @page #{$page-type}:#{$page-position} {
           @include position($running-content-position) {
             @if $page-position == 'left' {
@@ -429,7 +429,7 @@
 
         }
       } @else {
-        @page #{$page-type}:first-of-group:right {
+        @page #{$page-type}:#{$first-page-pseudo}: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-of-group:left {
+        @page #{$page-type}:#{$first-page-pseudo}: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-of-group' {
+      @if $page-position != $first-page-pseudo {
         @page #{$page-type}:#{$page-position} {
           @include position($numbering-position) {
             @if $page-position == 'left' {
@@ -461,13 +461,13 @@
           }
         }
       } @else {
-        @page #{$page-type}:first-of-group:right {
+        @page #{$page-type}:#{$first-page-pseudo}:right {
           @include position(if-map-get($numbering-position, right)) {
             content: if-map-get($right-page-number, $page-type);
           }
         }
 
-        @page #{$page-type}:first-of-group:left {
+        @page #{$page-type}:#{$first-page-pseudo}: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-of-group' {
+      @if $page-position != $first-page-pseudo {
         @page #{$page-type}:#{$page-position} {
           @include position($running-content-position) {
             @if $page-position == 'left' {
@@ -487,13 +487,13 @@
           }
         }
       } @else {
-        @page #{$page-type}:first-of-group:right {
+        @page #{$page-type}:#{$first-page-pseudo}:right {
           @include position(if-map-get($running-content-position, right)) {
             content: if-map-get($right-running-content, $page-type);
           }
         }
 
-        @page #{$page-type}:first-of-group:left {
+        @page #{$page-type}:#{$first-page-pseudo}: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-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('#{$first-page-pseudo}:left', convert-position('first', $first-numbering-position));
+@include page-numbers('#{$first-page-pseudo}: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-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('#{$first-page-pseudo}:left', convert-position('first', $first-running-content-position));
+  @include runninghead('#{$first-page-pseudo}: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-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('#{$first-page-pseudo}:left', convert-position('first', $first-running-content-position));
+  @include runningfoot('#{$first-page-pseudo}: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-of-group {
+@page front-matter:#{$first-page-pseudo} {
   @include blank-head-and-foot;
 }
 
-@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', $first-page-pseudo, 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-of-group {
+@page introduction:#{$first-page-pseudo} {
   @include blank-head-and-foot;
 }
 
-@include page-structure('introduction', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('introduction', $first-page-pseudo, 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-of-group {
+@page post-introduction:#{$first-page-pseudo} {
   @include blank-head-and-foot;
 }
 
-@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', $first-page-pseudo, 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-of-group {
+@page part:#{$first-page-pseudo} {
   @include blank-head-and-foot;
 }
 
-@include page-structure('part', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('part', $first-page-pseudo, 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-of-group {
+@page chapter:#{$first-page-pseudo} {
   @include blank-head-and-foot;
 }
 
-@include page-structure('chapter', 'first-of-group', convert-position('first', $first-numbering-position), convert-position('first', $first-running-content-position));
+@include page-structure('chapter', $first-page-pseudo, 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-of-group {
+@page back-matter:#{$first-page-pseudo} {
   @include blank-head-and-foot;
 }
 
-@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', $first-page-pseudo, 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/variables/_elements.scss

@@ -760,7 +760,7 @@ $blockquote-border-left-color: initial !default;
 /// 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;
+$box-decoration-break: slice !default;
 
 /// Top margin for `<ol>` elements.
 /// @type String | Map

package/assets/styles/variables/_structure.scss

@@ -58,6 +58,14 @@ $first-running-content-position: null !default;
 // $first-running-content-position: 'bottom-outside' !default;
 // TODO: Handle other positions based on recto-verso
 
+/// Page pseudo-class used for the first page of each section group.
+/// Prince 16+ uses 'first-of-group', Prince 15 and earlier use 'first'.
+/// Set to 'first' to restore Prince 15 behavior where the first page
+/// of each named page group was matched by :first.
+/// @type String
+/// @since 1.10.0
+$first-page-pseudo: 'first-of-group' !default;
+
 // Finally, for the running separator, it either exists or it doesn't,
 // so choose between two options (null, or defined content):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buckram",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Opinionated SCSS components for books (web, EPUB and PDF).",
   "scripts": {
     "build": "composer install && composer test",
@@ -45,7 +45,8 @@
         true,
         {
           "ignorePseudoClasses": [
-            "first-of-group"
+            "first-of-group",
+            "first"
           ]
         }
       ]