@canopycanopycanopy/b-ber-theme-serif 3.1.0 → 4.0.0

package/AGENTS.md

@@ -0,0 +1,47 @@
+# AGENTS.md — b-ber-theme-serif
+
+## What This Is
+
+A serif-first SCSS theme for b-ber publications. The build pipeline compiles `application.scss` into a stylesheet embedded in EPUB, web, reader, and mobi output. The theme uses `b-ber-theme-mixins` for shared mixins and `modularscale-sass` for typographic scale. All settings variables use `!default` so project-level stylesheets can override them. The `$build` variable gates conditional rules per output format.
+
+## Key Files
+
+| File/Directory                | Purpose                                                        |
+| ----------------------------- | -------------------------------------------------------------- |
+| `application.scss`            | Entry point; imports settings, mixins, typography, layout      |
+| `_settings.scss`              | SCSS variables for colors, fonts, spacing, and layout defaults |
+| `typography/_fonts.scss`      | Font-face declarations                                         |
+| `typography/_reset.scss`      | Base element reset                                             |
+| `layout/_container.scss`      | Page/column container rules                                    |
+| `layout/_figure.scss`         | Figure and image layout                                        |
+| `layout/_text.scss`           | Paragraph, heading, inline text styles                         |
+| `layout/_list.scss`           | List element styles                                            |
+| `layout/_table.scss`          | Table styles                                                   |
+| `layout/_media-controls.scss` | Audio/video player controls                                    |
+| `layout/_epub.scss`           | EPUB-specific conditional styles                               |
+| `layout/_web.scss`            | Web-specific conditional styles                                |
+| `layout/_reader.scss`         | Reader-specific conditional styles                             |
+| `layout/_print.scss`          | Print/PDF styles                                               |
+| `layout/_helpers.scss`        | Utility classes                                                |
+| `fonts/`                      | Theme font files (empty placeholder in repo)                   |
+| `images/`                     | Theme image assets (empty placeholder in repo)                 |
+| `index.js`                    | Node entry point for build tooling                             |
+
+## Dev Commands
+
+No test suite. The `test` script exits with an error by default.
+
+```bash
+npm run build:sass   # compile application.scss to application.css
+npm run watch:sass   # watch and recompile on change
+```
+
+## Code Standards
+
+This package follows the monorepo-wide standards in the root AGENTS.md.
+Additional standards for this package:
+
+- SCSS follows BEM-adjacent naming conventions established in `b-ber-theme-mixins`
+- All variable declarations must use `!default` to remain overridable
+- Build-target conditional logic must use the `$build` variable (`epub`, `reader`, `mobi`, `web`)
+- Do not add compiled CSS files (`application.css`) to version control

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/README.md

@@ -1,9 +1,26 @@
-# `@canopycanopycanopy/b-ber-theme-serif`
+# b-ber-theme-serif
 
-The `b-ber-theme-serif` package contains a theme written in SCSS for styling projects. The styles maintain consistency in layout across each of b-ber's output formats. More information about b-ber themes can be found in the [Themes](https://github.com/triplecanopy/b-ber/wiki/Themes) page in the b-ber [Wiki](https://github.com/triplecanopy/b-ber/wiki).
+A serif-first SCSS theme for b-ber publications. During a build, b-ber compiles `application.scss` into the stylesheet that is embedded in generated EPUB, web, reader, and mobi output. The theme imports `b-ber-theme-mixins` for shared mixins and `modularscale-sass` for typographic scale calculations. Settings are controlled by SCSS variables in `_settings.scss`; all variables use `!default` so they can be overridden by project-level stylesheets. The `$build` variable gates conditional rules for `epub`, `reader`, `mobi`, and `web` targets.
 
-## Install
+## Contents
 
-```
-$ npm i -g @canopycanopycanopy/b-ber-theme-serif
+| Path               | Purpose                                                                                                                 |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| `application.scss` | Entry point; imports settings, mixins, typography, and layout                                                           |
+| `_settings.scss`   | SCSS variables for colors, fonts, spacing, and layout defaults                                                          |
+| `typography/`      | `_fonts.scss` (font-face rules), `_reset.scss` (base reset)                                                             |
+| `layout/`          | Partials for container, figure, text, list, table, media controls, epub/web/reader/print variants, and helper utilities |
+| `fonts/`           | Directory for theme font files (empty placeholder in repo)                                                              |
+| `images/`          | Directory for theme image assets (empty placeholder in repo)                                                            |
+| `index.js`         | Node entry point (exposes package path for build tooling)                                                               |
+
+## Dev
+
+No test suite. The `test` script exits with an error by default.
+
+To compile the stylesheet locally:
+
+```bash
+npm run build:sass   # outputs application.css
+npm run watch:sass   # watch mode
 ```

package/index.js

@@ -8,10 +8,10 @@ module.exports = {
   fonts: (() =>
     fs
       .readdirSync(path.join(__dirname, 'fonts'))
-      .filter(file => /\.(otf|ttf|woff2?|eot)/i.test(path.extname(file))))(),
+      .filter((file) => /\.(otf|ttf|woff2?|eot)/i.test(path.extname(file))))(),
   images: (() =>
     fs
       .readdirSync(path.join(__dirname, 'images'))
-      .filter(file => /\.(jpe?g|png|gif)/i.test(path.extname(file))))(),
+      .filter((file) => /\.(jpe?g|png|gif)/i.test(path.extname(file))))(),
   npmPackage,
 }

package/layout/_web.scss

@@ -79,6 +79,20 @@
     }
   }
 
+  // The header/footer chrome icons are inline SVGs emitted directly by
+  // b-ber-tasks' web Template (see TASK-111) rather than a webfont ligature.
+  // `fill: currentColor` keeps the `button:hover { color: $success; }` /
+  // `.publication__nav__link:hover { color: $success; }` rules above working
+  // the same way they did when the icon was glyph text. 24px matches the
+  // Material Icons default ligature size these SVGs replace.
+  .header__item__toggle svg,
+  .publication__search__button svg,
+  .publication__nav__link svg {
+    width: 24px;
+    height: 24px;
+    fill: currentColor;
+  }
+
   // Variables for spacing, sizing, and transitions.
   //
   // Show/hide the navigation panels (TOC and info sidebar).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canopycanopycanopy/b-ber-theme-serif",
-  "version": "3.1.0",
+  "version": "4.0.0",
   "description": "A serif theme for b-ber projects",
   "main": "index.js",
   "author": "Triple Canopy <b-ber@canopycanopycanopy.com> (https://triplecanopy.github.io/)",
@@ -16,8 +16,6 @@
     "access": "public"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "clean": "echo OK",
     "sass": "sass",
     "watch:sass": "sass --watch application.scss application.css",
     "build:sass": "sass application.scss application.css"
@@ -29,5 +27,5 @@
   "devDependencies": {
     "sass": "^1.49.8"
   },
-  "gitHead": "59963709eda1a8eb12dde95405f8f01086d12cc7"
+  "gitHead": "435b9c7e6b97d3fbdeb21f2308283597040ebfc8"
 }

package/.eslintrc.js

@@ -1 +0,0 @@
-module.exports = { extends: '../../.eslintrc.js' }