@dataimago/css 0.1.0-alpha.18 → 0.1.0-alpha.19

package/README.md

@@ -12,6 +12,7 @@ Depends on [`@dataimago/tokens`](../tokens) for the canonical house identity.
 - `dist/quarto/dataimago-{light,dark}.scss` + `components.scss` — the Quarto theme pair (self-contained; dark keyed to `body.quarto-dark`) and the `.di-*` components.
 - `dist/latex/dataimago-tokens.sty` + `dataimago.sty` — the generated `di-*` colour layer and the LaTeX macro layer.
 - `dist/dataviz/` — the Okabe-Ito data-viz palette as CSS, TeX (PSTricks/TikZ), JSON and R.
+- `dist/templates/` — the project templates (`KNOWLEDGE-*.md`, the Quarto website scaffold) as stamped copies, synced into a project with `dataimago-sync` like the other outputs (house only).
 - `dist/outputs.json` and the `dataimago-sync` bin — pinned sync for non-JS consumers (below).
 
 Use [`@dataimago/css-neutral`](../css-neutral) instead when an externally-owned Level-3 app or future third-party hub needs the neutral identity.

package/dist/dataviz/dataimago-dataviz.css

@@ -1,4 +1,4 @@
-/* @dataimago/css@0.1.0-alpha.18 dist/dataviz/dataimago-dataviz.css · sha256:4fb36e2401c1cd21f57d50c017ac080377c3943362a5b6c5ce2cd658080e4499 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync */
+/* @dataimago/css@0.1.0-alpha.19 dist/dataviz/dataimago-dataviz.css · sha256:4fb36e2401c1cd21f57d50c017ac080377c3943362a5b6c5ce2cd658080e4499 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync */
 /* dataimago data-viz palette (Okabe-Ito). Categorical colour is never the only channel. */
 :root, [data-bs-theme="light"], body.quarto-light {
   --color-dataviz-okabe-ito-orange: #E69F00;

package/dist/dataviz/dataimago-dataviz.json

@@ -1,11 +1,11 @@
 {
   "_meta": {
     "package": "@dataimago/css",
-    "version": "0.1.0-alpha.18",
+    "version": "0.1.0-alpha.19",
     "path": "dist/dataviz/dataimago-dataviz.json",
     "sha256": "28160e151fca196be3e36790d6b67db232d8df060e8d9556b29dfee50f4b278b",
     "note": "generated from tokens; do not edit",
-    "restore": "npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync"
+    "restore": "npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync"
   },
   "okabe-ito": {
     "orange": "#E69F00",

package/dist/dataviz/dataimago-dataviz.tex

@@ -1,4 +1,4 @@
-% @dataimago/css@0.1.0-alpha.18 dist/dataviz/dataimago-dataviz.tex · sha256:d7be36cb429ce8a1f19c95a7da8f57a7fcfda85fd2b0113e086913d37e9fa645 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+% @dataimago/css@0.1.0-alpha.19 dist/dataviz/dataimago-dataviz.tex · sha256:d7be36cb429ce8a1f19c95a7da8f57a7fcfda85fd2b0113e086913d37e9fa645 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 % dataimago data-viz palette (Okabe-Ito), light mode, for PSTricks and TikZ. Requires xcolor.
 \definecolor{di-dataviz-okabe-ito-orange}{HTML}{E69F00}
 \definecolor{di-dataviz-okabe-ito-sky-blue}{HTML}{56B4E9}

package/dist/dataviz/dataimago_dataviz.R

@@ -1,4 +1,4 @@
-# @dataimago/css@0.1.0-alpha.18 dist/dataviz/dataimago_dataviz.R · sha256:6443982f105b0f5e4a9d90ac2d1f6ce9fce2db4e8e8148b47f71bfc438940055 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+# @dataimago/css@0.1.0-alpha.19 dist/dataviz/dataimago_dataviz.R · sha256:6443982f105b0f5e4a9d90ac2d1f6ce9fce2db4e8e8148b47f71bfc438940055 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 # dataimago data-viz palette (Okabe-Ito). Categorical colour is never the only channel:
 # pair it with marker shape, line type or a label.
 

package/dist/latex/dataimago-tokens.sty

@@ -1,4 +1,4 @@
-% @dataimago/css@0.1.0-alpha.18 dist/latex/dataimago-tokens.sty · sha256:97596b5136434afc7d03b17916219cdccffd6c1cdc748b861f012e06fbbfc5df · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+% @dataimago/css@0.1.0-alpha.19 dist/latex/dataimago-tokens.sty · sha256:97596b5136434afc7d03b17916219cdccffd6c1cdc748b861f012e06fbbfc5df · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{dataimago-tokens}[dataimago design tokens, light mode]
 \RequirePackage{xcolor}

package/dist/latex/dataimago.sty

@@ -1,4 +1,4 @@
-% @dataimago/css@0.1.0-alpha.18 dist/latex/dataimago.sty · sha256:deefadc765fb6c3fb673d7b4e71dcc7d12473f2ee4f0de1160af062b94d7e810 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+% @dataimago/css@0.1.0-alpha.19 dist/latex/dataimago.sty · sha256:deefadc765fb6c3fb673d7b4e71dcc7d12473f2ee4f0de1160af062b94d7e810 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 %%%
 %%% dataimago.sty - LaTeX Style Package for dataimago Design System
 %%%

package/dist/outputs.json

@@ -1,15 +1,26 @@
 {
   "package": "@dataimago/css",
-  "version": "0.1.0-alpha.18",
+  "version": "0.1.0-alpha.19",
   "files": {
-    "dataviz/dataimago-dataviz.css": "128ed7ea829e6667ce3987e10df0fdbb0ccaf239f7dec629b019bae7481f0509",
-    "dataviz/dataimago-dataviz.json": "c9f11f24f9f485d087db124b25c52002bc52db4420751738180485f80f5269bd",
-    "dataviz/dataimago-dataviz.tex": "6fa584eed9fc11417cb7d7b29c19722e7c86d47eea3caac90022ecb36d01e2ca",
-    "dataviz/dataimago_dataviz.R": "a5e49ca7fe859df42f1013f2c4b37784c6a4306673494855b2072e6fd7ca6721",
-    "latex/dataimago-tokens.sty": "5db3f9be31a480ca38393f29bce535a7eb47c76cbf436eadcef17eaaf1bfae4f",
-    "latex/dataimago.sty": "2f3f9c8492607e5b58b3359043feb11d92b4a3beb04a0dbc4176a63e19e432cd",
-    "quarto/components.scss": "7370d1c1967f4fac2dc87a2cce394480f725967660847cb8b82e3d29b5aa4a30",
-    "quarto/dataimago-dark.scss": "8a99910b5c7e4cebdd39efc5223e3d086e1f362a678fd5d73851f97326df32d7",
-    "quarto/dataimago-light.scss": "46174d3e118e59493b75f6d80009dd09758337b6221b87343854f6f6f5c2211f"
+    "dataviz/dataimago-dataviz.css": "1af7427ac88a12540accb2da04d8442f7801c7d8176ca8d4f15a708e1e0b4cb9",
+    "dataviz/dataimago-dataviz.json": "e49da8cd904a941ab1586b48063e1c5d4eba4962e7fb50b045d162fa7c931c83",
+    "dataviz/dataimago-dataviz.tex": "f82616e309e08066b077d828152f01479b919cdc5fe48bd1db7c9914cc54123a",
+    "dataviz/dataimago_dataviz.R": "5f3cbacb922046ca78f2860b40d09b14676091eed5b1710c4fcc46031fa45246",
+    "latex/dataimago-tokens.sty": "fc1a0652b8216d4a98c09a5314aef978ea172c5dff8ad8e7a971ac53cf188b22",
+    "latex/dataimago.sty": "08baf49cf2cfd0d720107ccef4921c7bffcc396dd6fec10fb1f64587322ba4af",
+    "quarto/components.scss": "bb01822d6be02a6e5e83d66460d34931ad5863cb2c2c63f9df71787f7d0dc892",
+    "quarto/dataimago-dark.scss": "61ffc1bcaca9edc03a236085b3073f56a40eff9809728bd777f02121c5e3e74b",
+    "quarto/dataimago-light.scss": "0ccbc31c3da002545bf37709fae7e5b220c33f709722c9ec18d987088c9c4ef4",
+    "templates/KNOWLEDGE-explorer.md": "b954fa898ccc9960426986b97d10a9785cab12034c96656f5090f06bc94d1f80",
+    "templates/KNOWLEDGE-framework.md": "0cf61a6ba79f4601b6ed1d096dbe3c37a4dae75742e112e5fb2271b26e4c439d",
+    "templates/KNOWLEDGE-research.md": "64c10fbc9c15f2cea34c1d388793c8309430b1817b8301c2229cba34b9c21e46",
+    "templates/quarto_website/README.md": "9d771be3c1f73087ed641ac8117bcd19afc92a4b0397e66cb4210206759f7a17",
+    "templates/quarto_website/_quarto.yml.template": "9dee3b591ddcaf63455a35a46212c9ffe80aa5627a8b88bff3d74e604446b55a",
+    "templates/quarto_website/about.qmd.template": "b922b7b3ad54c2cd6885825901c02e02d4d2a33e9a7724ce285494b2cc498a6a",
+    "templates/quarto_website/assets/js/custom-anchors.js": "afd06bbc94340b5bd98acdfd46c2b01f1dc2bc604931566dc1d37cd1c569622b",
+    "templates/quarto_website/assets/js/logo-switch.js": "324b070c527fb47e629bac5bcfcaac7ae955707379b92c2c141c7e02cedc4469",
+    "templates/quarto_website/assets/js/scroll.js": "4ce5ac410a29608eb3b2c7313ccbd7d8c458655b714fe9a47a3dd0c626eb648d",
+    "templates/quarto_website/ethics.qmd.template": "164d344466811fcfaf3c9a42012c2a53a0a394d8b007ea8be037c77df82149d5",
+    "templates/quarto_website/index.qmd.template": "03ef348dcd13c479c01ebd87356e118d387df4173984940374cb0bb83b3661c9"
   }
 }

package/dist/quarto/components.scss

@@ -1,4 +1,4 @@
-// @dataimago/css@0.1.0-alpha.18 dist/quarto/components.scss · sha256:7449c84f769ce0f0ec574328144abb42b5c7087706f3ae2c6d36977977c94d50 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+// @dataimago/css@0.1.0-alpha.19 dist/quarto/components.scss · sha256:7449c84f769ce0f0ec574328144abb42b5c7087706f3ae2c6d36977977c94d50 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 /*-- scss:rules --*/
 // dataimago components (.di-*) — generated from src/styles/components/.
 .di-figure-box {

package/dist/quarto/dataimago-dark.scss

@@ -1,4 +1,4 @@
-// @dataimago/css@0.1.0-alpha.18 dist/quarto/dataimago-dark.scss · sha256:5d85054f4316c2ad6c65d29f1b26f939e0052b6ba716ea50545a21eef69d24d7 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+// @dataimago/css@0.1.0-alpha.19 dist/quarto/dataimago-dark.scss · sha256:5d85054f4316c2ad6c65d29f1b26f939e0052b6ba716ea50545a21eef69d24d7 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 // dataimago dark theme for Quarto 1.8 — generated from the design tokens (tools/formats/quarto.mjs).
 // Bootstrap Sass variables are compile-time sRGB; runtime colours come from the custom properties below.
 

package/dist/quarto/dataimago-light.scss

@@ -1,4 +1,4 @@
-// @dataimago/css@0.1.0-alpha.18 dist/quarto/dataimago-light.scss · sha256:6e0e24eeabfc9524f0d4dfd70dcac22fb4b70b9c99d7a074d0354eca5c7d1603 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.18 dataimago-sync
+// @dataimago/css@0.1.0-alpha.19 dist/quarto/dataimago-light.scss · sha256:6e0e24eeabfc9524f0d4dfd70dcac22fb4b70b9c99d7a074d0354eca5c7d1603 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
 // dataimago light theme for Quarto 1.8 — generated from the design tokens (tools/formats/quarto.mjs).
 // Bootstrap Sass variables are compile-time sRGB; runtime colours come from the custom properties below.
 

package/dist/templates/KNOWLEDGE-explorer.md

@@ -0,0 +1,236 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/KNOWLEDGE-explorer.md · sha256:907c08638ed56813d453227759e29de08350465885d11f0efe94ec7ba8c42a50 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+# {{PROJECT_NAME}} — Knowledge Base Operating Manual
+
+**Domain:** {{DOMAIN_NAME}}
+**Type:** explorer
+**Explorer dimension:** {{EXPLORER_DIMENSION}}
+**Generated:** {{GENERATED_DATE}}
+**Framework:** [dataimago-design]({{FRAMEWORK_WIKI_URL}}/wiki/index.md)
+
+This file is the operating manual for the **{{PROJECT_NAME}}** knowledge base — an AI-maintained wiki that documents the dimensions, attributes, datasets, and data quality considerations that make this application trustworthy and navigable. Read it at the start of every knowledge-work session.
+
+---
+
+## Role
+
+You are the wiki maintainer for **{{PROJECT_NAME}}**'s knowledge base — an `explorer`-type domain wiki organized around the `{{EXPLORER_DIMENSION}}` dimension. This application has no thesis to advance; it makes a dataset navigable. Your job is to ensure that every piece of data the application presents is accurately documented — what it means, where it came from, what its limitations are.
+
+Your job is to:
+- Document new attributes as they are added to the application
+- Summarize source datasets and their quality characteristics
+- Answer queries about data provenance, coverage, and interpretation
+- File answers as `wiki/analyses/` pages so knowledge compounds
+- Lint the wiki for gaps in attribute documentation and stale dataset information
+
+You never modify files in `raw/`. You own everything in `wiki/`.
+
+The framework layer (how this application is built) is documented in the dataimago-design wiki (see `dataimago-framework.json` for the URL). Data and content questions belong here; build and architecture questions belong there.
+
+---
+
+## Session Start Protocol
+
+At the start of every knowledge-work session:
+1. Read this file (KNOWLEDGE.md)
+2. Read `wiki/index.md` to orient to the current knowledge base state
+3. Read the last 5 entries of `wiki/log.md` to understand recent activity
+4. Check `wiki/attributes/` for any attributes flagged as needing documentation updates
+5. Read the framework wiki index (URL in `dataimago-framework.json`) for framework context (optional unless architecture is relevant)
+6. Ask the user: ingest new data, document an attribute, answer a query, or something else?
+
+---
+
+## Directory Structure
+
+```
+wiki/
+├── index.md          ← Master catalog of all wiki pages
+├── overview.md       ← High-level synthesis: what data this application holds and why
+├── glossary.md       ← Canonical terminology for this domain
+├── log.md            ← Append-only activity record
+├── dimensions/       ← The organizing axes of the explorer (geography, time, etc.)
+├── attributes/       ← Each measurable property: meaning, source, coverage, caveats
+├── datasets/         ← Data sources: provenance, update cadence, coverage gaps
+├── sources/          ← Authoritative sources for datasets and attribute definitions
+├── personas/         ← Who uses the explorer and what they discover with it
+└── analyses/         ← Patterns, comparisons, and insights surfaced from the data
+
+raw/
+├── papers/           ← Academic sources, methodology documents
+├── conversations/    ← AI dialogues, decisions, notes
+├── data/             ← Raw dataset files, exports from R
+└── references/       ← External data portals, API specs, codebooks
+```
+
+---
+
+## Entity Types
+
+| Type | Location | Page purpose |
+|---|---|---|
+| **Dimension** | `wiki/dimensions/` | The organizing axes: what they cover, how entities are identified, edge cases |
+| **Attribute** | `wiki/attributes/` | Each measurable property: precise definition, source, geographic/temporal coverage, caveats |
+| **Dataset** | `wiki/datasets/` | A data source: provenance, update cadence, coverage gaps, known issues, R dataset name |
+| **Source** | `wiki/sources/` | An authoritative reference for an attribute definition or dataset methodology |
+| **Persona** | `wiki/personas/` | A user type: what they're trying to discover, what attributes they care about |
+| **Analysis** | `wiki/analyses/` | Patterns found, comparisons made, insights derived from the data |
+
+---
+
+## The Attribute Page — Core Knowledge Atom
+
+The `wiki/attributes/` directory is the most important part of this wiki. Every attribute the application exposes must have a page that documents:
+
+```markdown
+---
+title: <attribute human name>
+type: attribute
+attribute_id: <the parameter name used in R functions and API endpoints>
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+dataset: <wiki/datasets/dataset-name.md>
+sources:
+  - <authoritative source for the attribute definition>
+tags: []
+---
+
+One-line description of what this attribute measures.
+
+## Definition
+Precise definition — not just a label. What exactly is being measured? What is the unit?
+What is the reference period (for point-in-time attributes)?
+
+## Data Source
+- Dataset: [[dataset-name]] 
+- R dataset object: `{{PROJECT_NAME}}::dataset_name`
+- R retrieval function: `get_entity_profile(entity_id, attributes = "{{ATTRIBUTE_ID}}")`
+
+## Coverage
+- Entities covered: (e.g., "193 UN member states", "47 European countries")
+- Temporal coverage: (e.g., "2000–2023 annually", "2022 only")
+- Known gaps: (e.g., "Missing for small island nations with population < 50,000")
+
+## Data Quality
+- Source reliability: (official statistics / derived / estimated / self-reported)
+- Known issues: (e.g., "Pre-2010 figures use different methodology")
+- Comparability caveats: (e.g., "Purchasing power adjustments vary by source year")
+
+## Interpretation
+For non-specialist audiences: what does a high/low value on this attribute mean?
+What should users NOT conclude from this attribute?
+
+## Related Attributes
+- [[attribute-name]] — (relationship, e.g., "often inversely correlated")
+```
+
+---
+
+## Workflows
+
+### Ingest a New Dataset
+
+1. Read the raw data file from `raw/data/` and any codebook from `raw/references/`
+2. Create a `wiki/datasets/` page documenting provenance, coverage, and update cadence
+3. Create a `wiki/attributes/` page for each attribute the dataset provides
+4. Update `wiki/dimensions/` if the dataset covers new entities or extends temporal range
+5. Update `wiki/glossary.md` with any new technical terms
+6. Update `wiki/index.md` and append to `wiki/log.md`
+
+### Document a New Attribute
+
+1. Identify the authoritative source for the attribute's definition
+2. Create a `wiki/attributes/` page following the template above
+3. Verify the R retrieval function returns correct data for the attribute
+4. Add the attribute to the relevant `wiki/datasets/` page
+5. Update `wiki/index.md` and append to `wiki/log.md`
+
+### Ingest a Paper or Reference
+
+1. Read from `raw/papers/`
+2. Determine: does this define an attribute? challenge a dataset's methodology? describe a dimension?
+3. Create a `wiki/sources/` page summarizing the key claims
+4. Link to the affected `wiki/attributes/` or `wiki/datasets/` pages
+5. Update `wiki/glossary.md` and append to `wiki/log.md`
+
+### Query
+
+1. Read `wiki/index.md` to identify relevant pages (typically `wiki/attributes/` and `wiki/datasets/`)
+2. Read those pages
+3. Synthesize a clear answer with citations
+4. Ask: "Should I file this as an analysis?" If yes, save to `wiki/analyses/`
+5. Append to `wiki/log.md`
+
+### Lint
+
+1. Check every attribute in `wiki/attributes/` has: definition, coverage, data quality, interpretation
+2. Check every dataset in `wiki/datasets/` has: provenance, update cadence, known gaps
+3. Check for attributes used in the application but not documented in the wiki
+4. Check for stale dataset entries (coverage dates that should have been updated)
+5. Report findings and propose fixes
+6. Append to `wiki/log.md`
+
+---
+
+## Log Format
+
+```
+## [YYYY-MM-DD] <action> | <title>
+
+**Action:** <description>
+Pages created: ...
+Pages updated: ...
+Key additions: ...
+```
+
+---
+
+## Terminology Discipline
+
+- Check `wiki/glossary.md` before using any domain term
+- Attribute IDs (used in R functions and API endpoints) must be consistent: `{{ATTRIBUTE_ID}}` form
+- Entity identifiers must be consistent: `{{EXPLORER_DIMENSION}}` → [describe ID format, e.g., ISO 3166-1 alpha-3 for countries]
+- Key terms for this domain: [populated by domain expert — add canonical terms here as the wiki develops]
+
+---
+
+## R Functions in This Application
+
+The following R functions are the retrieval backbone of {{PROJECT_NAME}}:
+
+{{EXPORTED_FUNCTIONS}}
+
+**Standard explorer function pattern:**
+- Every attribute is retrievable via `get_entity_profile(entity_id, attributes = "attribute_id")`
+- Every attribute is comparable via `compare_entities(entity_ids, "attribute_id")`
+- Discovery: `get_attributes()` returns all attributes with their wiki descriptions
+- Discovery: `get_entities()` returns all entities with their available attributes
+
+---
+
+## Data Quality Standards
+
+This application makes claims about the world. Every attribute must meet these standards before it can be displayed to users:
+
+1. **Defined** — A `wiki/attributes/` page exists with a precise definition
+2. **Sourced** — The data source is documented in a `wiki/datasets/` page
+3. **Bounded** — Coverage (entities and time period) is documented
+4. **Caveated** — Known quality issues and comparability limits are documented
+5. **Interpreted** — A plain-language interpretation is available for non-specialist users
+
+Attributes that fail any of these standards should be marked `status: draft` in their frontmatter and excluded from the production data explorer until the standard is met.
+
+---
+
+## Connection to the Framework Layer
+
+This wiki documents **what data** this application holds and **what it means**. The dataimago-design wiki documents **how** the application is built. The connection:
+
+```
+wiki/attributes/greeting.md
+  → documents HelloWorld::Hello_World dataset
+    → retrieved via get_entity_profile(entity_id)
+      → exposed at GET /entity/{id}?attributes=greeting
+        → documented in dataimago-design/wiki/patterns/rest-api-from-r.md
+```
+
+Do not duplicate framework documentation here. Reference it.

package/dist/templates/KNOWLEDGE-framework.md

@@ -0,0 +1,233 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/KNOWLEDGE-framework.md · sha256:edc7c6622722c1258f025a385ba79fe62a03ebb4d36f06e999aabc1290145b84 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+# {{PROJECT_NAME}} — Knowledge Base Operating Manual
+
+**Domain:** {{DOMAIN_NAME}}
+**Type:** framework
+**Generated:** {{GENERATED_DATE}}
+**Framework:** [dataimago-design]({{FRAMEWORK_WIKI_URL}}/wiki/index.md)
+
+This file is the operating manual for the **{{PROJECT_NAME}}** knowledge base — an AI-maintained wiki that documents the principles, patterns, and decisions that govern this framework. Read it at the start of every knowledge-work session.
+
+*Note: If this is dataimago-design itself, this file's role is played by `CLAUDE.md` — the original operating manual. This template applies to other framework-type applications generated by dataimago.*
+
+---
+
+## Role
+
+You are the wiki maintainer for **{{PROJECT_NAME}}**'s knowledge base — a `framework`-type domain wiki that documents the principles, patterns, and governance decisions that constrain and guide this system's use.
+
+Your job is to:
+- Document new decisions as Architecture Decision Records (ADRs)
+- Keep principles and patterns consistent and cross-referenced
+- Answer queries about what the framework requires and why
+- File answers as `wiki/analyses/` pages so knowledge compounds
+- Lint the wiki for contradictions between principles and patterns, and for undocumented enforcement mechanisms
+
+You never modify files in `raw/`. You own everything in `wiki/`.
+
+The meta-framework layer (how dataimago builds framework applications) is at the URL in `dataimago-framework.json`. Questions about this specific framework's content belong here; questions about how it was generated or deployed belong there.
+
+---
+
+## Session Start Protocol
+
+At the start of every knowledge-work session:
+1. Read this file (KNOWLEDGE.md)
+2. Read `wiki/index.md` to orient to the current knowledge base state
+3. Read the last 5 entries of `wiki/log.md` to understand recent activity
+4. Check `wiki/decisions/` for any ADRs marked `status: proposed` — these need review
+5. Read the framework wiki index (URL in `dataimago-framework.json`) for meta-framework context
+6. Ask the user: document a decision, document a pattern, answer a query, lint, or something else?
+
+---
+
+## Directory Structure
+
+```
+wiki/
+├── index.md           ← Master catalog of all wiki pages
+├── overview.md        ← High-level synthesis: what this framework governs and how
+├── glossary.md        ← Canonical terminology for this framework domain
+├── log.md             ← Append-only activity record
+├── principles/        ← The values the framework upholds and enforces
+├── patterns/          ← How to implement each principle in practice
+├── decisions/         ← ADRs: every significant choice with justification
+├── connections/       ← How principles map across implementation domains
+├── personas/          ← Who is governed by or governs this framework
+└── analyses/          ← Compliance audits, gap analyses, comparisons
+
+raw/
+├── papers/            ← Academic sources, standards documents, prior art
+├── conversations/     ← AI dialogues, governance meeting notes
+├── data/              ← Validation results, compliance reports, audit logs
+└── references/        ← External frameworks, standards, codebases compared against
+```
+
+---
+
+## Entity Types
+
+| Type | Location | Page purpose |
+|---|---|---|
+| **Principle** | `wiki/principles/` | A value the framework upholds: what it means, how it is enforced, the governance basis |
+| **Pattern** | `wiki/patterns/` | How to implement a principle: concrete steps, code examples, common mistakes |
+| **Decision** | `wiki/decisions/` | An ADR: what was chosen, what was rejected, why, date, and any revision history |
+| **Connection** | `wiki/connections/` | Cross-domain synthesis: how principle X maps to practice Y in context Z |
+| **Persona** | `wiki/personas/` | A stakeholder: who uses the framework, who is governed by it, who governs it |
+| **Analysis** | `wiki/analyses/` | Compliance audit, gap analysis, comparison with alternative frameworks |
+
+---
+
+## The Decision Page — Core Knowledge Atom
+
+Architecture Decision Records are the most important pages in a framework wiki. Every significant choice must be documented before it is enforced:
+
+```markdown
+---
+title: "ADR: <Decision title>"
+type: decision
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+status: proposed | accepted | superseded | deprecated
+superseded_by: <ADR page name if superseded>
+sources:
+  - <pages or raw files that informed this decision>
+tags: []
+---
+
+One-line summary of the decision.
+
+## Decision
+What was chosen. State it precisely.
+
+## Context
+The problem that required a decision. What constraints existed?
+
+## Alternatives Considered
+What else was evaluated? Why was each rejected?
+
+## Justification
+Why this choice? Include ethical justification where relevant.
+
+## Consequences
+What does this enable? What does it foreclose? What monitoring is needed?
+
+## Related Pages
+- [[principle-name]] — The principle this decision serves
+- [[pattern-name]] — The implementation pattern this decision authorizes
+```
+
+ADRs are **append-only in spirit**: when a decision changes, mark the old ADR `status: superseded`, add `superseded_by: new-adr-name`, and create a new ADR. Never silently overwrite the reasoning history.
+
+---
+
+## Workflows
+
+### Document a New Decision
+
+1. Identify the decision being made (never document a decision after the fact without noting that it was post-hoc)
+2. Create a `wiki/decisions/` ADR page with `status: proposed`
+3. Link to the relevant principles it serves and patterns it authorizes
+4. After review/consensus, update to `status: accepted`
+5. Update `wiki/index.md` and append to `wiki/log.md`
+
+### Document a New Pattern
+
+1. Identify the principle the pattern implements
+2. Create a `wiki/patterns/` page with: problem, solution, implementation details, ethical justification
+3. Link from the relevant `wiki/principles/` page
+4. Verify that an ADR exists authorizing this pattern (or create one)
+5. Update `wiki/index.md` and append to `wiki/log.md`
+
+### Ingest a Comparison Framework or Standard
+
+1. Read from `raw/papers/` or `raw/references/`
+2. Create a `wiki/sources/` page summarizing the key claims
+3. Create or update a `wiki/analyses/` page comparing this framework to {{PROJECT_NAME}} on key dimensions
+4. Identify any principles or patterns that should be updated in light of the comparison
+5. Update `wiki/glossary.md` and append to `wiki/log.md`
+
+### Query
+
+1. Read `wiki/index.md` to identify relevant pages (typically `wiki/principles/` and `wiki/patterns/`)
+2. Read those pages
+3. Synthesize a clear answer citing the relevant ADRs and principles
+4. Ask: "Should I file this as an analysis?" If yes, save to `wiki/analyses/`
+5. Append to `wiki/log.md`
+
+### Lint
+
+1. Check every `wiki/principles/` page has at least one `wiki/patterns/` page implementing it
+2. Check every `wiki/patterns/` page is authorized by an ADR in `wiki/decisions/`
+3. Check for enforcement mechanisms that exist in the codebase but are not documented in a principle page
+4. Check for principles that are stated but have no enforcement mechanism (document the gap or add enforcement)
+5. Check for ADRs with `status: proposed` that have not been reviewed
+6. Report findings and propose fixes
+7. Append to `wiki/log.md`
+
+---
+
+## Log Format
+
+```
+## [YYYY-MM-DD] <action> | <title>
+
+**Action:** <description>
+Pages created: ...
+Pages updated: ...
+Key additions: ...
+```
+
+---
+
+## Terminology Discipline
+
+- Check `wiki/glossary.md` before using any framework term
+- Canonical terms must be used consistently — never paraphrase a principle's name
+- ADR titles must be unique and stable (they are referenced by other pages)
+- Key terms for this domain: [populated by domain expert — add canonical terms here as the wiki develops]
+
+---
+
+## R Functions in This Application
+
+The following R functions implement validation and generation capabilities for {{PROJECT_NAME}}:
+
+{{EXPORTED_FUNCTIONS}}
+
+**Standard framework function pattern:**
+- `validate_*()` functions check compliance and return violations with severity
+- `scaffold_*()` functions generate new instances conforming to the framework
+- `get_*_status()` functions report system health
+- `get_validation_rules()` returns all rules with descriptions (discovery endpoint)
+
+---
+
+## Principle Documentation Standard
+
+Every principle must meet these standards before it can be enforced:
+
+1. **Named** — A canonical name in the glossary
+2. **Defined** — A `wiki/principles/` page with precise definition
+3. **Justified** — The ethical or practical basis is documented (who authorized this and on what grounds)
+4. **Implemented** — At least one `wiki/patterns/` page shows how to comply
+5. **Enforced** — An automated check exists OR the absence of automation is noted and justified
+6. **Governed** — The process for changing this principle is documented
+
+Principles that lack justification or governance documentation should be marked `status: draft` and flagged in the next lint pass.
+
+---
+
+## Connection to the Meta-Framework Layer
+
+This wiki documents **what {{PROJECT_NAME}} requires** and **why**. The dataimago-design wiki documents **how framework-type applications are built**. The connection:
+
+```
+wiki/principles/my-principle.md
+  → implemented by wiki/patterns/my-pattern.md
+    → enforced by validate_my_rule() in R
+      → exposed at POST /validate
+        → documented in dataimago-design/wiki/patterns/rest-api-from-r.md
+```
+
+Do not duplicate dataimago-design's framework documentation here. Reference it.

package/dist/templates/KNOWLEDGE-research.md

@@ -0,0 +1,201 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/KNOWLEDGE-research.md · sha256:ef0a6748731b61840e8e8da1142db5981948da4dec78888f40f471c2a3d3300f · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+# {{PROJECT_NAME}} — Knowledge Base Operating Manual
+
+**Domain:** {{DOMAIN_NAME}}
+**Type:** research
+**Generated:** {{GENERATED_DATE}}
+**Framework:** [dataimago-design]({{FRAMEWORK_WIKI_URL}}/wiki/index.md)
+
+This file is the operating manual for the **{{PROJECT_NAME}}** knowledge base — an AI-maintained wiki that documents the ideas, evidence, methods, and arguments that this application embodies. Read it at the start of every knowledge-work session.
+
+---
+
+## Role
+
+You are the wiki maintainer for **{{PROJECT_NAME}}**'s knowledge base — a `research`-type domain wiki that synthesizes the evidence, methods, and arguments behind the application's analytical claims.
+
+Your job is to:
+- Ingest source materials and extract knowledge into structured wiki pages
+- Keep pages consistent, cross-referenced, and up to date
+- Answer queries by reading the wiki (not re-deriving from scratch)
+- File good answers back as `wiki/analyses/` pages so knowledge compounds
+- Periodically lint the wiki for contradictions, stale content, and orphan pages
+
+You never modify files in `raw/`. You own everything in `wiki/`.
+
+The framework layer (how this application is built) is documented in the dataimago-design wiki (see `dataimago-framework.json` for the URL). Domain knowledge questions belong here; build and architecture questions belong there.
+
+---
+
+## Session Start Protocol
+
+At the start of every knowledge-work session:
+1. Read this file (KNOWLEDGE.md)
+2. Read `wiki/index.md` to orient to the current knowledge base state
+3. Read the last 5 entries of `wiki/log.md` to understand recent activity
+4. Read the framework wiki index (URL in `dataimago-framework.json`) for framework context (optional unless architecture is relevant)
+5. Ask the user: ingest, query, lint, or something else?
+
+---
+
+## Directory Structure
+
+```
+wiki/
+├── index.md         ← Master catalog of all wiki pages
+├── overview.md      ← High-level synthesis of the knowledge base
+├── glossary.md      ← Canonical terminology for this domain
+├── log.md           ← Append-only activity record
+├── sources/         ← Summaries of papers, datasets, conversations
+├── theories/        ← Theoretical frameworks the research uses
+├── methods/         ← Methodological choices and their justifications
+├── findings/        ← Specific results with interpretation
+├── arguments/       ← Central claims and their evidence chains
+├── personas/        ← Who uses this application and what they need
+└── analyses/        ← Synthesized outputs, comparisons, strategic insights
+
+raw/
+├── papers/          ← PDFs, journal articles, preprints
+├── conversations/   ← AI dialogues, meeting notes, transcripts
+├── data/            ← Datasets, R output files, analysis exports
+└── references/      ← External codebases, specs, documentation
+```
+
+---
+
+## Entity Types
+
+| Type | Location | Page purpose |
+|---|---|---|
+| **Source** | `wiki/sources/` | Summary of a raw document: key claims, quotes, metadata |
+| **Theory** | `wiki/theories/` | A theoretical framework: definition, key thinkers, application here |
+| **Method** | `wiki/methods/` | A methodological choice: what was done, why, limitations |
+| **Finding** | `wiki/findings/` | A specific result: statistical context, interpretation, R function reference |
+| **Argument** | `wiki/arguments/` | A central claim: what it asserts, what evidence supports it, what challenges it |
+| **Persona** | `wiki/personas/` | A user type: goals, what they need from this application |
+| **Analysis** | `wiki/analyses/` | A synthesized output: comparison, gap analysis, strategic insight |
+
+---
+
+## Page Format
+
+Every wiki page must have this YAML frontmatter:
+
+```yaml
+---
+title: <page title>
+type: source | theory | method | finding | argument | persona | analysis
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources:
+  - <raw/ filenames or wiki pages that informed this>
+tags:
+  - <relevant tags>
+---
+```
+
+Followed by: one-line summary, body with headers and tables, and a **Related pages** section at the bottom using `[[page-name]]` links.
+
+---
+
+## Workflows
+
+### Ingest a Paper or Article
+
+1. Read the source file from `raw/papers/` or `raw/references/`
+2. Discuss key takeaways (ask 1-3 clarifying questions if needed)
+3. Create a summary page in `wiki/sources/`
+4. Identify which theories, methods, or arguments it supports or challenges — update those pages
+5. Create new entity pages as warranted (new theory, new method, etc.)
+6. Update `wiki/glossary.md` with new domain terms
+7. Update `wiki/index.md` and `wiki/overview.md` if the source shifts the big picture
+8. Append to `wiki/log.md`
+
+### Ingest an R Analysis Output
+
+1. Read the output from `raw/data/`
+2. Identify what R function produced it and with what parameters
+3. Create or update a `wiki/findings/` page documenting the result
+4. Link the finding to the argument(s) it supports in `wiki/arguments/`
+5. Note the R function and parameters in the finding page (makes it verifiable and updatable)
+6. Update `wiki/index.md` and append to `wiki/log.md`
+
+### Ingest a Conversation
+
+1. Read the transcript from `raw/conversations/`
+2. Extract: key decisions made, questions raised, terminology clarified, arguments refined
+3. Update affected wiki pages (typically `wiki/arguments/`, `wiki/methods/`, `wiki/analyses/`)
+4. Create new pages if new concepts emerged
+5. Update `wiki/glossary.md` and append to `wiki/log.md`
+
+### Query
+
+1. Read `wiki/index.md` to identify relevant pages
+2. Read those pages
+3. Synthesize a clear answer with citations to wiki pages
+4. Ask: "Should I file this as a wiki page?" If yes, save to `wiki/analyses/`
+5. Append to `wiki/log.md`
+
+### Lint
+
+1. Read all pages in the wiki
+2. Report: contradictions between pages, stale claims, orphan pages, missing cross-references, inconsistent terminology
+3. Propose fixes and ask which ones to apply
+4. Append to `wiki/log.md`
+
+---
+
+## Log Format
+
+```
+## [YYYY-MM-DD] <action> | <title>
+
+**Action:** <description>
+Pages created: ...
+Pages updated: ...
+Key additions: ...
+```
+
+---
+
+## Terminology Discipline
+
+- Check `wiki/glossary.md` before using any domain term
+- If a new term appears in a source, add it to the glossary before using it elsewhere
+- If a term conflicts with an existing entry, flag it explicitly before updating
+- Key terms for this domain: [populated by domain expert — add canonical terms here as the wiki develops]
+
+---
+
+## R Functions in This Application
+
+The following R functions are the analytical backbone of {{PROJECT_NAME}}. Each exported function should have a corresponding wiki entry linking its output to `wiki/findings/` pages:
+
+{{EXPORTED_FUNCTIONS}}
+
+When ingesting an R analysis output, always record:
+- Which function produced it
+- The parameter values used
+- The date it was run
+- What finding page documents it
+
+---
+
+## Philosophical Alignment
+
+Every wiki page is evaluated against the question: does this serve the application's purpose of making research accessible to its intended audiences? Knowledge that exists only in academic prose has a single audience. Knowledge filed in this wiki serves general readers (via the web app), data analysts (via the API), AI agents (via MCP tools), and the domain expert themselves (via this wiki).
+
+---
+
+## Connection to the Framework Layer
+
+This wiki documents **what** this application knows. The dataimago-design wiki documents **how** the application is built. When a finding page references an R function, that function's API exposure is documented in the framework layer. The connection is:
+
+```
+wiki/findings/my-finding.md
+  → references HelloWorld::my_function()
+    → exposed at GET /my-endpoint
+      → documented in dataimago-design/wiki/patterns/rest-api-from-r.md
+```
+
+Do not duplicate framework documentation here. Reference it.

package/dist/templates/quarto_website/README.md

@@ -0,0 +1,48 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/README.md · sha256:19a8e30db9c7fc15e62e7bebb573041947b31be886d2e32d75b217236b0ab421 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+# Quarto Website Template
+
+Canonical template for Quarto-powered R package websites built with the dataimago framework.
+
+## Usage
+
+This template is consumed by `dataimago::create_quarto_documentation()` when `scaffold_full_site = TRUE`. It can also be used manually by copying the template files and replacing placeholders.
+
+## Placeholders
+
+All `.template` files use Mustache-style `{{PLACEHOLDER}}` syntax:
+
+| Placeholder | Source | Description |
+|---|---|---|
+| `{{PACKAGE_NAME}}` | DESCRIPTION `Package` field | R package name |
+| `{{PACKAGE_TITLE}}` | DESCRIPTION `Title` field | Full package title |
+| `{{PACKAGE_DESCRIPTION}}` | DESCRIPTION `Description` field | Package description |
+| `{{PACKAGE_AUTHOR}}` | DESCRIPTION `Authors@R` field | Author information |
+| `{{PACKAGE_LICENSE}}` | DESCRIPTION `License` field | License type |
+| `{{SITE_URL}}` | DESCRIPTION `URL` field | GitHub Pages URL |
+| `{{REPO_URL}}` | DESCRIPTION `BugReports` (minus `/issues`) | GitHub repo URL |
+
+## Template Files
+
+- `_quarto.yml.template` -- Site configuration with navbar, sidebar, footer, and theme
+- `index.qmd.template` -- Homepage with hero section and feature cards
+- `ethics.qmd.template` -- Ethical AI principles from dataimago-design wiki
+- `about.qmd.template` -- Package about page
+
+## Static Assets (no templating)
+
+- `assets/js/scroll.js` -- Sticky header shrink on scroll
+- `assets/js/custom-anchors.js` -- Left-placed anchor links on headings
+- `assets/js/logo-switch.js` -- Theme-aware logo hover effects (uses `{{SITE_URL}}`)
+
+## Features Included
+
+- Sticky navbar that shrinks on scroll
+- Custom anchor links on all headings
+- Theme-aware logo switching (dark/light mode)
+- Lenis smooth scrolling
+- Accessibility layer (reduced motion, high contrast, skip links)
+- Ethics-first content pages sourced from dataimago-design wiki
+- Documents and presentations content scaffolding
+- News/changelog page
+- Custom 404 page
+- Open Graph and Twitter Card metadata

package/dist/templates/quarto_website/_quarto.yml.template

@@ -0,0 +1,141 @@
+# @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/_quarto.yml.template · sha256:d28f9f49ba75df94183a074bcab94399ea10368ddfd538055f6b421d8194af91 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
+project:
+  type: website
+  title: "{{PACKAGE_TITLE}}"
+  output-dir: ../../docs
+  render:
+   - "*.qmd"
+   - "!content/presentations/**"
+   - "content/documents/**"
+
+execute:
+  freeze: auto
+
+extensions:
+  - dataimago/ai-native
+
+filters:
+  - svg-inline
+
+references:
+  - type: r
+    title: "Function Reference"
+    source: "../../man"
+
+website:
+  site-url: "{{SITE_URL}}"
+  repo-url: "{{REPO_URL}}"
+  title: "{{PACKAGE_TITLE}}"
+  description: "{{PACKAGE_DESCRIPTION}}"
+  favicon: /assets/img/ai_monogram_supreme_favicon.png
+  repo-actions: none
+  page-navigation: false
+  bread-crumbs: false
+
+  navbar:
+    title: "{{PACKAGE_NAME}}"
+    logo: /assets/img/ai_monogram.svg
+    logo-alt: "{{PACKAGE_NAME}}"
+    logo-href: "{{SITE_URL}}"
+    title-href: "{{SITE_URL}}"
+    search: false
+    pinned: true
+    left:
+      - href: index.qmd
+        text: Home
+      - href: r_package.qmd
+        text: R Package
+      - text: Ethics
+        menu:
+          - href: ethics.qmd
+            text: Ethical AI Principles
+          - href: design_system.qmd
+            text: Design System
+          - href: governance.qmd
+            text: Democratic Governance
+      - text: Foundation
+        menu:
+          - href: mission.qmd
+            text: Mission & Vision
+          - href: philosophy.qmd
+            text: Philosophy
+      - text: Resources
+        menu:
+          - href: documents.qmd
+            text: Documents
+          - href: presentations.qmd
+            text: Presentations
+      - href: news.qmd
+        text: News
+    right:
+      - text: "<img src='/assets/img/github_logo.svg' class='navbar-github-logo' title='GitHub' alt='GitHub' style='height:32px; vertical-align:middle; padding-right: 2px; margin-top: 0px;'/>"
+        menu:
+          - href: "{{REPO_URL}}"
+            text: Source Code
+          - href: "{{REPO_URL}}/issues"
+            text: Report a Bug
+          - href: "{{REPO_URL}}/discussions"
+            text: Request a Feature
+        target: _blank
+
+  sidebar:
+    style: "docked"
+    search: true
+    contents:
+       - section: "Getting Started"
+         contents:
+           - r_package.qmd
+       - section: "Ethics & Design"
+         contents:
+           - ethics.qmd
+           - design_system.qmd
+           - governance.qmd
+       - section: "Foundation"
+         contents:
+           - mission.qmd
+           - philosophy.qmd
+       - section: "Resources"
+         contents:
+           - documents.qmd
+           - presentations.qmd
+           - news.qmd
+
+  page-footer:
+    left:
+      - text: "<img src='/assets/img/quarto_logo.svg' class='footer-quarto-logo inline-svg' title='quarto.org' alt='quarto.org' style='width:28px; height:28px; vertical-align:middle; padding-right: 4px; margin-top: 6px;'/>"
+        href: https://quarto.org/
+        target: _blank
+    center:
+      - text: "<img src='/assets/img/ai_monogram.svg' class='footer-ai-monogram-logo inline-svg' title='dataimago.ai' alt='dataimago.ai' style='height:28px; vertical-align:middle; padding-right: 4px; margin-top: 6px;'/>"
+        href: https://dataimago.ai/
+        target: _blank
+      - text: "<img src='/assets/img/package_hex_logo.svg' class='footer-package-hex-logo inline-svg' title='{{PACKAGE_NAME}} R Package' alt='{{PACKAGE_NAME}} R Package' style='height: 32px; margin-top: 3px;'/>"
+        href: "{{SITE_URL}}"
+
+metadata:
+  image: /assets/img/ai_monogram_supreme_COLOR.png
+  open-graph: true
+  twitter-card:
+    image: /assets/img/ai_monogram_supreme_COLOR.png
+    card-style: summary_large_image
+
+format:
+  html:
+    theme:
+      light: _extensions/dataimago/ai-native/assets/css/dataimago-light.scss
+      dark: _extensions/dataimago/ai-native/assets/css/dataimago-dark.scss
+    toc: true
+    toc-depth: 3
+    code-copy: true
+    code-overflow: wrap
+    include-after: |
+      <link rel="preconnect" href="https://fonts.googleapis.com">
+      <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+      <link href="https://fonts.googleapis.com/css2?family=Josefin+Sans:wght@200;300;400;500;600;700&family=Noto+Sans:wdth,wght@100..125,300..800&family=Noto+Sans+Math&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">
+      <script src="https://unpkg.com/lenis@1.3.8/dist/lenis.min.js"></script>
+      <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
+      <script type="text/javascript" src="/assets/js/scroll.js"></script>
+      <script type="text/javascript" src="/assets/js/logo-switch.js"></script>
+      <script type="text/javascript" src="/assets/js/lenis-integration.js"></script>
+      <script type="text/javascript" src="/assets/js/custom-anchors.js"></script>
+      <script type="text/javascript" src="/assets/js/accessibility.js"></script>

package/dist/templates/quarto_website/about.qmd.template

@@ -0,0 +1,36 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/about.qmd.template · sha256:5f896d14240e32c56a8711cbc458e8d3726cf8bcebac154aa62ead41f49af185 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+---
+title: "About {{PACKAGE_NAME}}"
+format:
+  html:
+    toc: true
+    toc-depth: 2
+---
+
+## Overview
+
+{{PACKAGE_DESCRIPTION}}
+
+## Built with dataimago
+
+{{PACKAGE_NAME}} is built using the [dataimago](https://dataimago.ai) framework --- an AI-native application development framework for data science. dataimago provides:
+
+- Complete design system compilation from tokens to production-ready assets
+- Multi-platform deployment (Quarto, Shiny, Next.js)
+- MCP-compatible tooling for AI agent integration
+- Ethical AI build-time validation
+- R-first workflows with modern web tools
+
+## Author
+
+{{PACKAGE_AUTHOR}}
+
+## License
+
+{{PACKAGE_LICENSE}}
+
+## Links
+
+- [GitHub Repository]({{REPO_URL}})
+- [Bug Reports]({{REPO_URL}}/issues)
+- [dataimago Framework](https://dataimago.ai)

package/dist/templates/quarto_website/assets/js/custom-anchors.js

@@ -0,0 +1,6 @@
+// @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/assets/js/custom-anchors.js · sha256:9b0f2d567a86e90431cc1470a6542f4e0549245dfda7b1b05b94119bddab0cb9 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
+anchors.options = {
+  placement: 'left',
+  visible: 'hover'
+};
+anchors.add('h1, h2, h3, h4, h5, h6');

package/dist/templates/quarto_website/assets/js/logo-switch.js

@@ -0,0 +1,73 @@
+// @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/assets/js/logo-switch.js · sha256:f69f3ad9c9ab670197c32d75e072cdfa5fb5cc0fc720f636dd9a9e3a3c44015c · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
+var defaultLogoSrc = '/assets/img/ai_monogram.svg';
+var defaultLogoHref = '{{SITE_URL}}';
+var hoverLogoHref = 'https://dataimago.ai';
+
+function getCurrentTheme() {
+  var dataTheme = document.documentElement.getAttribute('data-bs-theme');
+  if (dataTheme === 'dark') return 'dark';
+
+  var lightSheets = document.querySelectorAll('link.quarto-color-scheme:not(.quarto-color-alternate)');
+  var allLightDisabled = true;
+  for (var i = 0; i < lightSheets.length; i++) {
+    if (!lightSheets[i].disabled) { allLightDisabled = false; break; }
+  }
+  var darkSheets = document.querySelectorAll('link.quarto-color-scheme.quarto-color-alternate');
+  var anyDarkEnabled = false;
+  for (var j = 0; j < darkSheets.length; j++) {
+    if (!darkSheets[j].disabled) { anyDarkEnabled = true; break; }
+  }
+  if (allLightDisabled && anyDarkEnabled) return 'dark';
+  if (document.body.classList.contains('quarto-dark')) return 'dark';
+  return 'light';
+}
+
+function setupNavbarBrandHover() {
+  var navbarLogo = document.querySelector('.navbar-logo');
+  var navbarBrand = navbarLogo ? navbarLogo.closest('a') : document.querySelector('.navbar-brand');
+  if (!navbarBrand) return;
+
+  navbarBrand.addEventListener('mouseover', function() {
+    navbarBrand.href = hoverLogoHref;
+    if (navbarLogo) navbarLogo.classList.add('logo-hover');
+  });
+  navbarBrand.addEventListener('mouseout', function() {
+    navbarBrand.href = defaultLogoHref;
+    if (navbarLogo) navbarLogo.classList.remove('logo-hover');
+  });
+}
+
+function setupFooterLogoHover() {
+  var footerLogos = document.querySelectorAll('.footer-ai-monogram-logo');
+  footerLogos.forEach(function(logo) {
+    logo.addEventListener('mouseover', function() { logo.classList.add('logo-hover'); });
+    logo.addEventListener('mouseout', function() { logo.classList.remove('logo-hover'); });
+  });
+}
+
+function initLogoSwitch() {
+  setupNavbarBrandHover();
+  setupFooterLogoHover();
+}
+
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', initLogoSwitch);
+} else {
+  initLogoSwitch();
+}
+
+var themeObserver = new MutationObserver(function(mutations) {
+  mutations.forEach(function(mutation) {
+    if (mutation.type === 'attributes' &&
+        (mutation.attributeName === 'data-bs-theme' || mutation.attributeName === 'class')) {
+      setTimeout(initLogoSwitch, 100);
+    }
+  });
+});
+themeObserver.observe(document.documentElement, { attributes: true });
+themeObserver.observe(document.body, { attributes: true });
+
+document.querySelectorAll('link.quarto-color-scheme').forEach(function(sheet) {
+  new MutationObserver(function() { setTimeout(initLogoSwitch, 100); })
+    .observe(sheet, { attributes: true, attributeFilter: ['disabled'] });
+});

package/dist/templates/quarto_website/assets/js/scroll.js

@@ -0,0 +1,67 @@
+// @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/assets/js/scroll.js · sha256:694f335a8c098d252123b523e1a7ac8d475da436eb3c5f73451d96108b2863d2 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync
+$(window).scroll(function(){
+    if($(window).scrollTop() > 35) {
+        $('.navbar').addClass("shrink");
+        $('.navbar-title').addClass("shrink");
+        $('.navbar-logo').addClass("shrink");
+        $('body').addClass("shrink");
+    } else {
+        $('.navbar').removeClass("shrink");
+        $('.navbar-title').removeClass("shrink");
+        $('.navbar-logo').removeClass("shrink");
+        $('body').removeClass("shrink");
+    }
+});
+
+$(document).ready(function() {
+    function observeDropdownChanges() {
+        var observer = new MutationObserver(function(mutations) {
+            mutations.forEach(function(mutation) {
+                if (mutation.type === 'attributes') {
+                    var $target = $(mutation.target);
+                    if ($target.hasClass('dropdown-toggle')) {
+                        var $dropdown = $target.closest('.dropdown, .nav-item');
+                        var isExpanded = $target.attr('aria-expanded') === 'true';
+
+                        if (isExpanded) {
+                            $dropdown.addClass('open');
+                        } else {
+                            $dropdown.removeClass('open');
+                        }
+                    }
+                }
+            });
+        });
+
+        $('.navbar-nav .dropdown-toggle').each(function() {
+            observer.observe(this, {
+                attributes: true,
+                attributeFilter: ['aria-expanded']
+            });
+        });
+    }
+
+    observeDropdownChanges();
+
+    $('.navbar-nav .dropdown-toggle').on('click', function() {
+        var $this = $(this);
+        var $dropdown = $this.closest('.dropdown, .nav-item');
+
+        setTimeout(function() {
+            var isExpanded = $this.attr('aria-expanded') === 'true';
+            if (isExpanded) {
+                $dropdown.addClass('open');
+            } else {
+                $dropdown.removeClass('open');
+            }
+        }, 50);
+    });
+
+    $('.navbar-nav .dropdown, .navbar-nav .nav-item').on('show.bs.dropdown', function() {
+        $(this).addClass('open');
+    });
+
+    $('.navbar-nav .dropdown, .navbar-nav .nav-item').on('hide.bs.dropdown', function() {
+        $(this).removeClass('open');
+    });
+});

package/dist/templates/quarto_website/ethics.qmd.template

@@ -0,0 +1,49 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/ethics.qmd.template · sha256:fc151adb9c9fd9934a3c23ca5822eb6b05ca27795070ff7dbb26acd0e50ddbe5 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+---
+title: "Ethical AI Principles"
+subtitle: "Superalignment Through Design Architecture"
+format:
+  html:
+    toc: true
+    toc-depth: 3
+---
+
+{{PACKAGE_NAME}} treats every design token, animation curve, and color choice as a moral decision with consequences for human agency. Ethics is not bolted on after design --- it is embedded in the system architecture from the foundation.
+
+## Core Commitments
+
+1. **Emancipation over efficiency** --- When efficiency and emancipation conflict, emancipation always wins.
+2. **AI in culture, not culture in AI** --- Technology serves lived human contexts, not the reverse.
+3. **Democratic participation** --- Communities affected by design decisions must have binding authority.
+4. **Reflexive practice** --- The system questions its own power relations.
+5. **Dialectical thinking** --- Productive tension over false simplicity.
+
+## Design Principles
+
+### Accessibility Beyond Compliance
+WCAG compliance is a floor, not a ceiling. Enhanced standards: 7.0:1 contrast, 48px touch targets, 300ms motion maximum.
+
+### Ethical Tokens First-Class
+Ethical constraints are first-class design tokens enforced at build time through the three-tier hierarchy (Primitive, Semantic, Ethical).
+
+### Performance Equity
+Speed is access. Design targets the most constrained users: 2G networks, single-core processors, 1GB RAM devices.
+
+### Color Democracy
+Color is communication technology serving community meaning-making, not brand commodity.
+
+### Motion Dignity
+Animation must respect vestibular safety, cognitive load, and cultural expectations.
+
+## How Ethics Are Enforced
+
+::: {.ethical-note}
+**Build-time validation:** Three automated validators gate every deployment:
+
+- **Contrast checking** --- 7.0:1 minimum ratio
+- **Motion linting** --- 300ms maximum duration, `prefers-reduced-motion` required
+- **Bundle size checking** --- Performance equity for low-bandwidth users
+:::
+
+For the complete design system documentation, see the [Design System](design_system.qmd) page.
+For governance processes, see [Democratic Governance](governance.qmd).

package/dist/templates/quarto_website/index.qmd.template

@@ -0,0 +1,71 @@
+<!-- @dataimago/css@0.1.0-alpha.19 dist/templates/quarto_website/index.qmd.template · sha256:fa09cd4cce412445d164a1ca1248c5080e03ee65db6e762e4bf2e543557c2958 · generated from tokens; do not edit · restore: npx -p @dataimago/css@0.1.0-alpha.19 dataimago-sync -->
+---
+format:
+  html:
+    page-layout: full
+    toc: false
+    sidebar: false
+---
+
+::::::::: {.lenis-slide}
+::::::: {.hero-section}
+:::::: {.grid}
+:::: {.g-col-12 .g-col-md-4 .logo-column}
+::: {.logo-container}
+![](assets/img/package_hex_logo.svg){width=500 .hero-logo}
+:::
+::::
+:::: {.g-col-12 .g-col-md-8 .g-start-md-5}
+::: {.hero-content-scroller data-lenis-animate="fade-left"}
+::: {.scroller-content}
+
+### {{PACKAGE_NAME}} {.content-item}
+
+{{PACKAGE_DESCRIPTION}}
+
+### Built with dataimago {.content-item}
+
+This package is built using the dataimago framework --- an AI-native application development framework for data science with ethical AI principles at its core.
+
+### R-First Workflows {.content-item}
+
+Familiar R interfaces wrap sophisticated web tools, providing modern development capabilities without leaving your preferred environment.
+
+:::
+:::
+::::
+::::::
+:::::::
+:::::::::
+
+:::::: {.lenis-slide}
+:::: {.cards-container}
+:::: {.cards-grid}
+
+::: {.feature-card}
+### R Package
+
+Complete function documentation and examples.
+
+[View Documentation](r_package.qmd)
+:::
+
+::: {.feature-card}
+### Ethical AI
+
+Built on dataimago's ethical AI framework with build-time enforcement.
+
+[Learn More](ethics.qmd)
+:::
+
+::: {.feature-card}
+### Design System
+
+Three-tier token architecture ensuring accessibility and cultural sensitivity.
+
+[Explore](design_system.qmd)
+:::
+
+::::
+::::
+::::::

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataimago/css",
-  "version": "0.1.0-alpha.18",
+  "version": "0.1.0-alpha.19",
   "description": "Compiled CSS and Tailwind preset for the dataimago ethical AI design system",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,7 @@
     "./quarto/*": "./dist/quarto/*",
     "./latex/*": "./dist/latex/*",
     "./dataviz/*": "./dist/dataviz/*",
+    "./templates/*": "./dist/templates/*",
     "./outputs.json": "./dist/outputs.json",
     "./package.json": "./package.json"
   },