@canopycanopycanopy/b-ber-theme-serif 3.0.8-nav.0 → 3.0.8-next.96

package/AGENTS.md

@@ -0,0 +1,53 @@
+# 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
+
+## Task System
+
+Tasks for this package are tracked in tasks/ using the same PRD format as the
+root AGENTS.md. No tasks are currently open. To add a task, create
+tasks/TASK-NNN.open.md following the format in the root AGENTS.md.

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canopycanopycanopy/b-ber-theme-serif",
-  "version": "3.0.8-nav.0+24db1e6b",
+  "version": "3.0.8-next.96+7446845b",
   "description": "A serif theme for b-ber projects",
   "main": "index.js",
   "author": "Triple Canopy <b-ber@canopycanopycanopy.com> (https://triplecanopy.github.io/)",
@@ -29,5 +29,5 @@
   "devDependencies": {
     "sass": "^1.49.8"
   },
-  "gitHead": "24db1e6bb491faae0d52c6dadc09d974a5a31cf5"
+  "gitHead": "7446845bcda4337bfbc9f75b55a1e0ca805023eb"
 }

package/.eslintrc.js

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