@rathnasgala2/template 3.2.1 → 4.0.0

package/README.md

@@ -629,7 +629,7 @@ npm run verify
 hand-maintained) runs, in order: Prettier format check, ESLint,
 `tsc --checkJs --noEmit`, the dependency-cruiser
 architecture/module-tree-absence gate, `jscpd` duplication scan, the
-`contracts/*.jcs` canonical-form check, the no-local-schema-pin check,
+`contracts/*.jcs` canonical-form check, the no-local-schema-pin check, the
 `node --test`, the license inventory check, the SBOM currency check
 (`sbom:check` compares `sbom.cdx.json` against the current lockfile — it is not
 a presence check), the workflow-pin check, and `npm audit --audit-level=high`.
@@ -645,7 +645,7 @@ npm run architecture    # dependency-cruiser: core never imports src/modules, no
 npm run duplication     # jscpd, 3% / 50 tokens
 npm run contracts:generate  # (re)write contracts/*.jcs from their reviewed source modules
 npm run contracts:check     # fail if committed contracts drifted
-npm run schema-pin:check    # fail on a file: @rathnasgala2/schemas specifier
+npm run schema-pin:check    # require the exact registry @rathnasgala2/schemas release
 npm test                # node --test
 npm run licenses:generate   # (re)write THIRD_PARTY_LICENSES.json
 npm run licenses:check      # fail if it drifted from package-lock.json
@@ -656,6 +656,11 @@ npm run workflows:drift     # fail if workflow files diverge from their own base
 npm run audit               # npm audit --audit-level=high
 ```
 
+Source development does not require a sibling schema checkout. The exact
+`@rathnasgala2/schemas@3.8.0` release is installed from the npm registry, and
+the lockfile carries its registry integrity. The exact peer is the public
+consumer contract.
+
 ## Package layout
 
 ```text
@@ -679,17 +684,16 @@ editions: they are a rendered content kind (see Editions).
 
 ## Consuming `@rathnasgala2/schemas`
 
-This repository consumes `@rathnasgala2/schemas@3.3.0` from the public npm
-registry, declared as `"@rathnasgala2/schemas": "3.3.0"` (exact pin, no range)
-so `package-lock.json` records the resolved version and integrity hash. The
-LOCAL-1/LOCAL-39 local-tarball convention
-(`file:../../local-packages/rathnasgala2-schemas-*.tgz`) is retired for this
-package now that it publishes to the registry. The 2.8.0->2.11.0 convergence
-changes none of the four roots this renderer validates, for the same reason the
-2.7.0-2.8.0 delta below did not. Only the `"."` export (`validateGalaDocument`,
-`GALA_SCHEMA_IDS`) is consumed; the 2.6.0 `./runtime-origins` narrow export and
-every other addition through 2.6.1 (new OpenAPI operations, App route/catalog
-copy, the `PrincipalSummary`/`AuthenticatorSummary`/keyset field additions) are
+This source targets `@rathnasgala2/schemas@3.8.0` with an exact manifest pin.
+Generation-4 development verifies against the schema sibling/packed candidate.
+The historical `package-lock.json` is not a 3.8.0 registry claim: it must be
+regenerated, together with the SBOM, from the authoritative published 3.8.0
+artifact before release. The 2.8.0->2.11.0 convergence changes none of the four
+roots this renderer validates, for the same reason the 2.7.0-2.8.0 delta below
+did not. Only the `"."` export (`validateGalaDocument`, `GALA_SCHEMA_IDS`) is
+consumed; the 2.6.0 `./runtime-origins` narrow export and every other addition
+through 2.6.1 (new OpenAPI operations, App route/catalog copy, the
+`PrincipalSummary`/`AuthenticatorSummary`/keyset field additions) are
 App/API-surface changes this renderer does not read. The `"."` export's 2.2.2
 browser-safety refactor (Node builtins replaced with browser-safe equivalents
 behind the same public API) is byte-identical in behaviour for a Node consumer

package/contracts/theme-styling-contract.jcs

@@ -1 +1 @@
-{"attributes":[{"match":"exact-value","name":"data-gala-page-kind","role":"semantic","values":["archive","article","author","error","index","page","profile","series","tag"]},{"match":"exact-value","name":"data-gala-resolved-color-mode","role":"state","values":["dark","light"]},{"match":"exact-value","name":"data-gala-slot","role":"semantic","values":["account-intent","article-end","article-footer-ad","article-preamble","conversation","edition-selector","footer-auxiliary","footer-profile","header-actions","newsletter"]},{"match":"presence","name":"data-gala-publication-root","role":"root","values":[]}],"catalogDigest":"sha256:a10fecf6d43e4392312158f15b66d55a9e2bd3c7816a0747eb2084735d336de5","classSelectors":["g-actions","g-article","g-article-cover","g-article-foot","g-article-grid","g-article-head","g-article-labels","g-article-meta","g-author-bio","g-author-card","g-author-name","g-avatar","g-badge","g-brand","g-brand-name","g-brand-tag","g-brand-text","g-btn","g-byline","g-byline-text","g-card","g-card-body","g-card-excerpt","g-card-foot","g-card-link","g-card-media","g-card-placeholder","g-card-row","g-card-top","g-chip","g-codebar","g-codebar-lang","g-codeblock","g-copy","g-copy-done","g-copy-idle","g-crumbs","g-dek","g-dot","g-eyebrow","g-footer","g-footer-about","g-footer-base","g-footer-brand","g-footer-col","g-footer-grid","g-grid","g-header","g-header-row","g-hero","g-hero-body","g-hero-media","g-icon","g-icon-btn","g-kbd","g-label","g-list","g-main","g-mark","g-menu","g-meta","g-mode-dark","g-mode-icon","g-mode-light","g-mode-system","g-more","g-nav","g-newsletter","g-pager","g-pager-link","g-pager-next","g-pagination","g-panel","g-panel-copy","g-pill","g-pill-count","g-pills","g-progress","g-prose","g-search","g-search-box","g-search-btn","g-search-empty","g-search-hit","g-search-hit-meta","g-search-hit-text","g-search-hit-title","g-search-input","g-search-results","g-section","g-section-head","g-series-box","g-series-card","g-series-here","g-series-list","g-series-n","g-series-tag","g-share","g-skip","g-social","g-sr","g-tag","g-tags","g-toast","g-toc","g-toc-list","g-toc-mobile","g-topic-head","g-topic-hero","g-topic-icon","g-topic-strip","g-wrap","language-bash","language-css","language-diff","language-java","language-javascript","language-json","language-jsx","language-markdown","language-markup","language-python","language-sql","language-tsx","language-typescript","language-yaml","token"],"combinators":[" "," > "," + "," ~ "],"composition":{"compoundOrder":["type","id","class","attribute","pseudo-class","pseudo-element"],"functionalPseudoKeywordArguments":["even","odd"],"functionalSelectorArguments":"compound-only","maximumFunctionalDepth":1,"nthExpressionProfile":"gala-positive-an-plus-b-v2","rootScope":"first-compound-required"},"contractVersion":"3.0.0","functionalPseudos":["is","where","not","nth-child","nth-last-child"],"idSelectors":["gala-appearance-color-mode","main-content"],"orderedLayers":["gala-base","gala-tokens","gala-components","gala-utilities","gala-print"],"profile":"gala-template-styling-contract-v2","pseudoClasses":["active","disabled","focus-visible","hover","visited"],"pseudoElements":["after","before","marker","selection"],"publicThemeSlotHooks":[{"hookId":"code-block","selectorAtom":"pre"},{"hookId":"code-inline","selectorAtom":"code"},{"hookId":"code-language-bash","selectorAtom":".language-bash"},{"hookId":"code-language-css","selectorAtom":".language-css"},{"hookId":"code-language-diff","selectorAtom":".language-diff"},{"hookId":"code-language-java","selectorAtom":".language-java"},{"hookId":"code-language-javascript","selectorAtom":".language-javascript"},{"hookId":"code-language-json","selectorAtom":".language-json"},{"hookId":"code-language-jsx","selectorAtom":".language-jsx"},{"hookId":"code-language-markdown","selectorAtom":".language-markdown"},{"hookId":"code-language-markup","selectorAtom":".language-markup"},{"hookId":"code-language-python","selectorAtom":".language-python"},{"hookId":"code-language-sql","selectorAtom":".language-sql"},{"hookId":"code-language-tsx","selectorAtom":".language-tsx"},{"hookId":"code-language-typescript","selectorAtom":".language-typescript"},{"hookId":"code-language-yaml","selectorAtom":".language-yaml"},{"hookId":"code-token","selectorAtom":".token"},{"hookId":"content-article","selectorAtom":"article"},{"hookId":"control-appearance-toggle","selectorAtom":"#gala-appearance-color-mode"},{"hookId":"control-button","selectorAtom":"button"},{"hookId":"disclosure-details","selectorAtom":"details"},{"hookId":"disclosure-summary","selectorAtom":"summary"},{"hookId":"heading-1","selectorAtom":"h1"},{"hookId":"heading-2","selectorAtom":"h2"},{"hookId":"heading-3","selectorAtom":"h3"},{"hookId":"heading-4","selectorAtom":"h4"},{"hookId":"heading-5","selectorAtom":"h5"},{"hookId":"heading-6","selectorAtom":"h6"},{"hookId":"landmark-footer","selectorAtom":"footer"},{"hookId":"landmark-header","selectorAtom":"header"},{"hookId":"landmark-main","selectorAtom":"main"},{"hookId":"landmark-main-content","selectorAtom":"#main-content"},{"hookId":"landmark-navigation","selectorAtom":"nav"},{"hookId":"landmark-section","selectorAtom":"section"},{"hookId":"media-figure","selectorAtom":"figure"},{"hookId":"media-image","selectorAtom":"img"},{"hookId":"page-archive","selectorAtom":"[data-gala-page-kind=\"archive\"]"},{"hookId":"page-article","selectorAtom":"[data-gala-page-kind=\"article\"]"},{"hookId":"page-author","selectorAtom":"[data-gala-page-kind=\"author\"]"},{"hookId":"page-error","selectorAtom":"[data-gala-page-kind=\"error\"]"},{"hookId":"page-index","selectorAtom":"[data-gala-page-kind=\"index\"]"},{"hookId":"page-page","selectorAtom":"[data-gala-page-kind=\"page\"]"},{"hookId":"page-profile","selectorAtom":"[data-gala-page-kind=\"profile\"]"},{"hookId":"page-series","selectorAtom":"[data-gala-page-kind=\"series\"]"},{"hookId":"page-tag","selectorAtom":"[data-gala-page-kind=\"tag\"]"},{"hookId":"prose-blockquote","selectorAtom":"blockquote"},{"hookId":"prose-divider","selectorAtom":"hr"},{"hookId":"prose-emphasis","selectorAtom":"em"},{"hookId":"prose-link","selectorAtom":"a"},{"hookId":"prose-list-item","selectorAtom":"li"},{"hookId":"prose-list-ordered","selectorAtom":"ol"},{"hookId":"prose-list-unordered","selectorAtom":"ul"},{"hookId":"prose-paragraph","selectorAtom":"p"},{"hookId":"prose-span","selectorAtom":"span"},{"hookId":"prose-strong","selectorAtom":"strong"},{"hookId":"prose-time","selectorAtom":"time"},{"hookId":"slot-account-intent","selectorAtom":"[data-gala-slot=\"account-intent\"]"},{"hookId":"slot-article-end","selectorAtom":"[data-gala-slot=\"article-end\"]"},{"hookId":"slot-article-footer-ad","selectorAtom":"[data-gala-slot=\"article-footer-ad\"]"},{"hookId":"slot-article-preamble","selectorAtom":"[data-gala-slot=\"article-preamble\"]"},{"hookId":"slot-conversation","selectorAtom":"[data-gala-slot=\"conversation\"]"},{"hookId":"slot-edition-selector","selectorAtom":"[data-gala-slot=\"edition-selector\"]"},{"hookId":"slot-footer-auxiliary","selectorAtom":"[data-gala-slot=\"footer-auxiliary\"]"},{"hookId":"slot-footer-profile","selectorAtom":"[data-gala-slot=\"footer-profile\"]"},{"hookId":"slot-header-actions","selectorAtom":"[data-gala-slot=\"header-actions\"]"},{"hookId":"slot-newsletter","selectorAtom":"[data-gala-slot=\"newsletter\"]"},{"hookId":"ui-actions","selectorAtom":".g-actions"},{"hookId":"ui-article","selectorAtom":".g-article"},{"hookId":"ui-article-cover","selectorAtom":".g-article-cover"},{"hookId":"ui-article-foot","selectorAtom":".g-article-foot"},{"hookId":"ui-article-grid","selectorAtom":".g-article-grid"},{"hookId":"ui-article-head","selectorAtom":".g-article-head"},{"hookId":"ui-article-labels","selectorAtom":".g-article-labels"},{"hookId":"ui-article-meta","selectorAtom":".g-article-meta"},{"hookId":"ui-author-bio","selectorAtom":".g-author-bio"},{"hookId":"ui-author-card","selectorAtom":".g-author-card"},{"hookId":"ui-author-name","selectorAtom":".g-author-name"},{"hookId":"ui-avatar","selectorAtom":".g-avatar"},{"hookId":"ui-badge","selectorAtom":".g-badge"},{"hookId":"ui-brand","selectorAtom":".g-brand"},{"hookId":"ui-brand-name","selectorAtom":".g-brand-name"},{"hookId":"ui-brand-tag","selectorAtom":".g-brand-tag"},{"hookId":"ui-brand-text","selectorAtom":".g-brand-text"},{"hookId":"ui-btn","selectorAtom":".g-btn"},{"hookId":"ui-byline","selectorAtom":".g-byline"},{"hookId":"ui-byline-text","selectorAtom":".g-byline-text"},{"hookId":"ui-card","selectorAtom":".g-card"},{"hookId":"ui-card-body","selectorAtom":".g-card-body"},{"hookId":"ui-card-excerpt","selectorAtom":".g-card-excerpt"},{"hookId":"ui-card-foot","selectorAtom":".g-card-foot"},{"hookId":"ui-card-link","selectorAtom":".g-card-link"},{"hookId":"ui-card-media","selectorAtom":".g-card-media"},{"hookId":"ui-card-placeholder","selectorAtom":".g-card-placeholder"},{"hookId":"ui-card-row","selectorAtom":".g-card-row"},{"hookId":"ui-card-top","selectorAtom":".g-card-top"},{"hookId":"ui-chip","selectorAtom":".g-chip"},{"hookId":"ui-codebar","selectorAtom":".g-codebar"},{"hookId":"ui-codebar-lang","selectorAtom":".g-codebar-lang"},{"hookId":"ui-codeblock","selectorAtom":".g-codeblock"},{"hookId":"ui-copy","selectorAtom":".g-copy"},{"hookId":"ui-copy-done","selectorAtom":".g-copy-done"},{"hookId":"ui-copy-idle","selectorAtom":".g-copy-idle"},{"hookId":"ui-crumbs","selectorAtom":".g-crumbs"},{"hookId":"ui-dek","selectorAtom":".g-dek"},{"hookId":"ui-dot","selectorAtom":".g-dot"},{"hookId":"ui-eyebrow","selectorAtom":".g-eyebrow"},{"hookId":"ui-footer","selectorAtom":".g-footer"},{"hookId":"ui-footer-about","selectorAtom":".g-footer-about"},{"hookId":"ui-footer-base","selectorAtom":".g-footer-base"},{"hookId":"ui-footer-brand","selectorAtom":".g-footer-brand"},{"hookId":"ui-footer-col","selectorAtom":".g-footer-col"},{"hookId":"ui-footer-grid","selectorAtom":".g-footer-grid"},{"hookId":"ui-grid","selectorAtom":".g-grid"},{"hookId":"ui-header","selectorAtom":".g-header"},{"hookId":"ui-header-row","selectorAtom":".g-header-row"},{"hookId":"ui-hero","selectorAtom":".g-hero"},{"hookId":"ui-hero-body","selectorAtom":".g-hero-body"},{"hookId":"ui-hero-media","selectorAtom":".g-hero-media"},{"hookId":"ui-icon","selectorAtom":".g-icon"},{"hookId":"ui-icon-btn","selectorAtom":".g-icon-btn"},{"hookId":"ui-kbd","selectorAtom":".g-kbd"},{"hookId":"ui-label","selectorAtom":".g-label"},{"hookId":"ui-list","selectorAtom":".g-list"},{"hookId":"ui-main","selectorAtom":".g-main"},{"hookId":"ui-mark","selectorAtom":".g-mark"},{"hookId":"ui-menu","selectorAtom":".g-menu"},{"hookId":"ui-meta","selectorAtom":".g-meta"},{"hookId":"ui-mode-dark","selectorAtom":".g-mode-dark"},{"hookId":"ui-mode-icon","selectorAtom":".g-mode-icon"},{"hookId":"ui-mode-light","selectorAtom":".g-mode-light"},{"hookId":"ui-mode-system","selectorAtom":".g-mode-system"},{"hookId":"ui-more","selectorAtom":".g-more"},{"hookId":"ui-nav","selectorAtom":".g-nav"},{"hookId":"ui-newsletter","selectorAtom":".g-newsletter"},{"hookId":"ui-pager","selectorAtom":".g-pager"},{"hookId":"ui-pager-link","selectorAtom":".g-pager-link"},{"hookId":"ui-pager-next","selectorAtom":".g-pager-next"},{"hookId":"ui-pagination","selectorAtom":".g-pagination"},{"hookId":"ui-panel","selectorAtom":".g-panel"},{"hookId":"ui-panel-copy","selectorAtom":".g-panel-copy"},{"hookId":"ui-pill","selectorAtom":".g-pill"},{"hookId":"ui-pill-count","selectorAtom":".g-pill-count"},{"hookId":"ui-pills","selectorAtom":".g-pills"},{"hookId":"ui-progress","selectorAtom":".g-progress"},{"hookId":"ui-prose","selectorAtom":".g-prose"},{"hookId":"ui-search","selectorAtom":".g-search"},{"hookId":"ui-search-box","selectorAtom":".g-search-box"},{"hookId":"ui-search-btn","selectorAtom":".g-search-btn"},{"hookId":"ui-search-empty","selectorAtom":".g-search-empty"},{"hookId":"ui-search-hit","selectorAtom":".g-search-hit"},{"hookId":"ui-search-hit-meta","selectorAtom":".g-search-hit-meta"},{"hookId":"ui-search-hit-text","selectorAtom":".g-search-hit-text"},{"hookId":"ui-search-hit-title","selectorAtom":".g-search-hit-title"},{"hookId":"ui-search-input","selectorAtom":".g-search-input"},{"hookId":"ui-search-results","selectorAtom":".g-search-results"},{"hookId":"ui-section","selectorAtom":".g-section"},{"hookId":"ui-section-head","selectorAtom":".g-section-head"},{"hookId":"ui-series-box","selectorAtom":".g-series-box"},{"hookId":"ui-series-card","selectorAtom":".g-series-card"},{"hookId":"ui-series-here","selectorAtom":".g-series-here"},{"hookId":"ui-series-list","selectorAtom":".g-series-list"},{"hookId":"ui-series-n","selectorAtom":".g-series-n"},{"hookId":"ui-series-tag","selectorAtom":".g-series-tag"},{"hookId":"ui-share","selectorAtom":".g-share"},{"hookId":"ui-skip","selectorAtom":".g-skip"},{"hookId":"ui-social","selectorAtom":".g-social"},{"hookId":"ui-sr","selectorAtom":".g-sr"},{"hookId":"ui-tag","selectorAtom":".g-tag"},{"hookId":"ui-tags","selectorAtom":".g-tags"},{"hookId":"ui-toast","selectorAtom":".g-toast"},{"hookId":"ui-toc","selectorAtom":".g-toc"},{"hookId":"ui-toc-list","selectorAtom":".g-toc-list"},{"hookId":"ui-toc-mobile","selectorAtom":".g-toc-mobile"},{"hookId":"ui-topic-head","selectorAtom":".g-topic-head"},{"hookId":"ui-topic-hero","selectorAtom":".g-topic-hero"},{"hookId":"ui-topic-icon","selectorAtom":".g-topic-icon"},{"hookId":"ui-topic-strip","selectorAtom":".g-topic-strip"},{"hookId":"ui-wrap","selectorAtom":".g-wrap"}],"publicationRootSelector":"[data-gala-publication-root]","resolvedPaletteSelectors":{"dark":"[data-gala-publication-root][data-gala-resolved-color-mode=\"dark\"]","light":"[data-gala-publication-root][data-gala-resolved-color-mode=\"light\"]"},"stylesheetLayers":{"components":"gala-components","print":"gala-print","tokens":"gala-tokens","utilities":"gala-utilities"},"templatePackage":"@rathnasgala2/template","templateVersion":"3.0.0","typeSelectors":["a","article","blockquote","button","code","details","em","figure","footer","h1","h2","h3","h4","h5","h6","header","hr","img","li","main","nav","ol","p","pre","section","span","strong","summary","time","ul"]}
+{"attributes":[{"match":"exact-value","name":"data-gala-article-layout","role":"semantic","values":["editorial","full-bleed","issue","prose","technical"]},{"match":"exact-value","name":"data-gala-author-layout","role":"semantic","values":["biography","portfolio","portrait","profile"]},{"match":"exact-value","name":"data-gala-density","role":"semantic","values":["comfortable","compact","spacious"]},{"match":"exact-value","name":"data-gala-footer-layout","role":"semantic","values":["compact","expanded"]},{"match":"exact-value","name":"data-gala-header-layout","role":"semantic","values":["compact","masthead","minimal","publication","utility"]},{"match":"exact-value","name":"data-gala-home-layout","role":"semantic","values":["chronological","gallery","magazine","newspaper","topic-index"]},{"match":"exact-value","name":"data-gala-listing-layout","role":"semantic","values":["dated-rows","image-grid","issues","rows"]},{"match":"exact-value","name":"data-gala-media-ratio","role":"semantic","values":["landscape","mixed"]},{"match":"exact-value","name":"data-gala-page-kind","role":"semantic","values":["archive","article","author","error","index","page","profile","series","tag"]},{"match":"exact-value","name":"data-gala-profile","role":"semantic","values":["developer","editorial","newsletter","personal","visual"]},{"match":"exact-value","name":"data-gala-resolved-color-mode","role":"state","values":["dark","light"]},{"match":"exact-value","name":"data-gala-slot","role":"semantic","values":["account-intent","article-end","article-footer-ad","article-preamble","conversation","edition-selector","footer-auxiliary","footer-profile","header-actions","newsletter"]},{"match":"presence","name":"data-gala-publication-root","role":"root","values":[]}],"catalogDigest":"sha256:63a76754b591a3cda91a4be1f43bdb3fe1d44cf4f9be766154f3944a043399b5","classSelectors":["g-actions","g-article","g-article-cover","g-article-cover-full-bleed","g-article-foot","g-article-grid","g-article-head","g-article-labels","g-article-meta","g-author-bio","g-author-card","g-author-name","g-avatar","g-badge","g-brand","g-brand-name","g-brand-tag","g-brand-text","g-btn","g-byline","g-byline-text","g-card","g-card-body","g-card-excerpt","g-card-foot","g-card-link","g-card-media","g-card-placeholder","g-card-row","g-card-top","g-chip","g-codebar","g-codebar-lang","g-codeblock","g-copy","g-copy-done","g-copy-idle","g-crumbs","g-date-stamp","g-dated-list","g-dated-row","g-dek","g-dot","g-eyebrow","g-footer","g-footer-about","g-footer-base","g-footer-brand","g-footer-col","g-footer-grid","g-grid","g-header","g-header-row","g-hero","g-hero-body","g-hero-media","g-icon","g-icon-btn","g-kbd","g-label","g-list","g-main","g-mark","g-menu","g-meta","g-mode-dark","g-mode-icon","g-mode-light","g-mode-system","g-more","g-nav","g-newsletter","g-pager","g-pager-link","g-pager-next","g-pagination","g-panel","g-panel-copy","g-pill","g-pill-count","g-pills","g-progress","g-prose","g-search","g-search-box","g-search-btn","g-search-empty","g-search-hit","g-search-hit-meta","g-search-hit-text","g-search-hit-title","g-search-input","g-search-results","g-section","g-section-head","g-series-box","g-series-card","g-series-here","g-series-list","g-series-n","g-series-tag","g-share","g-skip","g-social","g-sr","g-tag","g-tags","g-toast","g-toc","g-toc-list","g-toc-mobile","g-topic-head","g-topic-hero","g-topic-icon","g-topic-strip","g-wrap","language-bash","language-css","language-diff","language-java","language-javascript","language-json","language-jsx","language-markdown","language-markup","language-python","language-sql","language-tsx","language-typescript","language-yaml","token"],"combinators":[" "," > "," + "," ~ "],"composition":{"compoundOrder":["type","id","class","attribute","pseudo-class","pseudo-element"],"functionalPseudoKeywordArguments":["even","odd"],"functionalSelectorArguments":"compound-only","maximumFunctionalDepth":1,"nthExpressionProfile":"gala-positive-an-plus-b-v2","rootScope":"first-compound-required"},"contractVersion":"4.0.0","functionalPseudos":["is","where","not","nth-child","nth-last-child"],"idSelectors":["gala-appearance-color-mode","main-content"],"orderedLayers":["gala-base","gala-tokens","gala-components","gala-utilities","gala-print"],"profile":"gala-template-styling-contract-v2","pseudoClasses":["active","disabled","focus-visible","hover","visited"],"pseudoElements":["after","before","marker","selection"],"publicThemeSlotHooks":[{"hookId":"code-block","selectorAtom":"pre"},{"hookId":"code-inline","selectorAtom":"code"},{"hookId":"code-language-bash","selectorAtom":".language-bash"},{"hookId":"code-language-css","selectorAtom":".language-css"},{"hookId":"code-language-diff","selectorAtom":".language-diff"},{"hookId":"code-language-java","selectorAtom":".language-java"},{"hookId":"code-language-javascript","selectorAtom":".language-javascript"},{"hookId":"code-language-json","selectorAtom":".language-json"},{"hookId":"code-language-jsx","selectorAtom":".language-jsx"},{"hookId":"code-language-markdown","selectorAtom":".language-markdown"},{"hookId":"code-language-markup","selectorAtom":".language-markup"},{"hookId":"code-language-python","selectorAtom":".language-python"},{"hookId":"code-language-sql","selectorAtom":".language-sql"},{"hookId":"code-language-tsx","selectorAtom":".language-tsx"},{"hookId":"code-language-typescript","selectorAtom":".language-typescript"},{"hookId":"code-language-yaml","selectorAtom":".language-yaml"},{"hookId":"code-token","selectorAtom":".token"},{"hookId":"composition-article-layout-editorial","selectorAtom":"[data-gala-article-layout=\"editorial\"]"},{"hookId":"composition-article-layout-full-bleed","selectorAtom":"[data-gala-article-layout=\"full-bleed\"]"},{"hookId":"composition-article-layout-issue","selectorAtom":"[data-gala-article-layout=\"issue\"]"},{"hookId":"composition-article-layout-prose","selectorAtom":"[data-gala-article-layout=\"prose\"]"},{"hookId":"composition-article-layout-technical","selectorAtom":"[data-gala-article-layout=\"technical\"]"},{"hookId":"composition-author-layout-biography","selectorAtom":"[data-gala-author-layout=\"biography\"]"},{"hookId":"composition-author-layout-portfolio","selectorAtom":"[data-gala-author-layout=\"portfolio\"]"},{"hookId":"composition-author-layout-portrait","selectorAtom":"[data-gala-author-layout=\"portrait\"]"},{"hookId":"composition-author-layout-profile","selectorAtom":"[data-gala-author-layout=\"profile\"]"},{"hookId":"composition-density-comfortable","selectorAtom":"[data-gala-density=\"comfortable\"]"},{"hookId":"composition-density-compact","selectorAtom":"[data-gala-density=\"compact\"]"},{"hookId":"composition-density-spacious","selectorAtom":"[data-gala-density=\"spacious\"]"},{"hookId":"composition-footer-layout-compact","selectorAtom":"[data-gala-footer-layout=\"compact\"]"},{"hookId":"composition-footer-layout-expanded","selectorAtom":"[data-gala-footer-layout=\"expanded\"]"},{"hookId":"composition-header-layout-compact","selectorAtom":"[data-gala-header-layout=\"compact\"]"},{"hookId":"composition-header-layout-masthead","selectorAtom":"[data-gala-header-layout=\"masthead\"]"},{"hookId":"composition-header-layout-minimal","selectorAtom":"[data-gala-header-layout=\"minimal\"]"},{"hookId":"composition-header-layout-publication","selectorAtom":"[data-gala-header-layout=\"publication\"]"},{"hookId":"composition-header-layout-utility","selectorAtom":"[data-gala-header-layout=\"utility\"]"},{"hookId":"composition-home-layout-chronological","selectorAtom":"[data-gala-home-layout=\"chronological\"]"},{"hookId":"composition-home-layout-gallery","selectorAtom":"[data-gala-home-layout=\"gallery\"]"},{"hookId":"composition-home-layout-magazine","selectorAtom":"[data-gala-home-layout=\"magazine\"]"},{"hookId":"composition-home-layout-newspaper","selectorAtom":"[data-gala-home-layout=\"newspaper\"]"},{"hookId":"composition-home-layout-topic-index","selectorAtom":"[data-gala-home-layout=\"topic-index\"]"},{"hookId":"composition-listing-layout-dated-rows","selectorAtom":"[data-gala-listing-layout=\"dated-rows\"]"},{"hookId":"composition-listing-layout-image-grid","selectorAtom":"[data-gala-listing-layout=\"image-grid\"]"},{"hookId":"composition-listing-layout-issues","selectorAtom":"[data-gala-listing-layout=\"issues\"]"},{"hookId":"composition-listing-layout-rows","selectorAtom":"[data-gala-listing-layout=\"rows\"]"},{"hookId":"composition-media-ratio-landscape","selectorAtom":"[data-gala-media-ratio=\"landscape\"]"},{"hookId":"composition-media-ratio-mixed","selectorAtom":"[data-gala-media-ratio=\"mixed\"]"},{"hookId":"composition-profile-developer","selectorAtom":"[data-gala-profile=\"developer\"]"},{"hookId":"composition-profile-editorial","selectorAtom":"[data-gala-profile=\"editorial\"]"},{"hookId":"composition-profile-newsletter","selectorAtom":"[data-gala-profile=\"newsletter\"]"},{"hookId":"composition-profile-personal","selectorAtom":"[data-gala-profile=\"personal\"]"},{"hookId":"composition-profile-visual","selectorAtom":"[data-gala-profile=\"visual\"]"},{"hookId":"content-article","selectorAtom":"article"},{"hookId":"control-appearance-toggle","selectorAtom":"#gala-appearance-color-mode"},{"hookId":"control-button","selectorAtom":"button"},{"hookId":"disclosure-details","selectorAtom":"details"},{"hookId":"disclosure-summary","selectorAtom":"summary"},{"hookId":"heading-1","selectorAtom":"h1"},{"hookId":"heading-2","selectorAtom":"h2"},{"hookId":"heading-3","selectorAtom":"h3"},{"hookId":"heading-4","selectorAtom":"h4"},{"hookId":"heading-5","selectorAtom":"h5"},{"hookId":"heading-6","selectorAtom":"h6"},{"hookId":"landmark-footer","selectorAtom":"footer"},{"hookId":"landmark-header","selectorAtom":"header"},{"hookId":"landmark-main","selectorAtom":"main"},{"hookId":"landmark-main-content","selectorAtom":"#main-content"},{"hookId":"landmark-navigation","selectorAtom":"nav"},{"hookId":"landmark-section","selectorAtom":"section"},{"hookId":"media-figure","selectorAtom":"figure"},{"hookId":"media-image","selectorAtom":"img"},{"hookId":"page-archive","selectorAtom":"[data-gala-page-kind=\"archive\"]"},{"hookId":"page-article","selectorAtom":"[data-gala-page-kind=\"article\"]"},{"hookId":"page-author","selectorAtom":"[data-gala-page-kind=\"author\"]"},{"hookId":"page-error","selectorAtom":"[data-gala-page-kind=\"error\"]"},{"hookId":"page-index","selectorAtom":"[data-gala-page-kind=\"index\"]"},{"hookId":"page-page","selectorAtom":"[data-gala-page-kind=\"page\"]"},{"hookId":"page-profile","selectorAtom":"[data-gala-page-kind=\"profile\"]"},{"hookId":"page-series","selectorAtom":"[data-gala-page-kind=\"series\"]"},{"hookId":"page-tag","selectorAtom":"[data-gala-page-kind=\"tag\"]"},{"hookId":"prose-blockquote","selectorAtom":"blockquote"},{"hookId":"prose-divider","selectorAtom":"hr"},{"hookId":"prose-emphasis","selectorAtom":"em"},{"hookId":"prose-link","selectorAtom":"a"},{"hookId":"prose-list-item","selectorAtom":"li"},{"hookId":"prose-list-ordered","selectorAtom":"ol"},{"hookId":"prose-list-unordered","selectorAtom":"ul"},{"hookId":"prose-paragraph","selectorAtom":"p"},{"hookId":"prose-span","selectorAtom":"span"},{"hookId":"prose-strong","selectorAtom":"strong"},{"hookId":"prose-time","selectorAtom":"time"},{"hookId":"slot-account-intent","selectorAtom":"[data-gala-slot=\"account-intent\"]"},{"hookId":"slot-article-end","selectorAtom":"[data-gala-slot=\"article-end\"]"},{"hookId":"slot-article-footer-ad","selectorAtom":"[data-gala-slot=\"article-footer-ad\"]"},{"hookId":"slot-article-preamble","selectorAtom":"[data-gala-slot=\"article-preamble\"]"},{"hookId":"slot-conversation","selectorAtom":"[data-gala-slot=\"conversation\"]"},{"hookId":"slot-edition-selector","selectorAtom":"[data-gala-slot=\"edition-selector\"]"},{"hookId":"slot-footer-auxiliary","selectorAtom":"[data-gala-slot=\"footer-auxiliary\"]"},{"hookId":"slot-footer-profile","selectorAtom":"[data-gala-slot=\"footer-profile\"]"},{"hookId":"slot-header-actions","selectorAtom":"[data-gala-slot=\"header-actions\"]"},{"hookId":"slot-newsletter","selectorAtom":"[data-gala-slot=\"newsletter\"]"},{"hookId":"ui-actions","selectorAtom":".g-actions"},{"hookId":"ui-article","selectorAtom":".g-article"},{"hookId":"ui-article-cover","selectorAtom":".g-article-cover"},{"hookId":"ui-article-cover-full-bleed","selectorAtom":".g-article-cover-full-bleed"},{"hookId":"ui-article-foot","selectorAtom":".g-article-foot"},{"hookId":"ui-article-grid","selectorAtom":".g-article-grid"},{"hookId":"ui-article-head","selectorAtom":".g-article-head"},{"hookId":"ui-article-labels","selectorAtom":".g-article-labels"},{"hookId":"ui-article-meta","selectorAtom":".g-article-meta"},{"hookId":"ui-author-bio","selectorAtom":".g-author-bio"},{"hookId":"ui-author-card","selectorAtom":".g-author-card"},{"hookId":"ui-author-name","selectorAtom":".g-author-name"},{"hookId":"ui-avatar","selectorAtom":".g-avatar"},{"hookId":"ui-badge","selectorAtom":".g-badge"},{"hookId":"ui-brand","selectorAtom":".g-brand"},{"hookId":"ui-brand-name","selectorAtom":".g-brand-name"},{"hookId":"ui-brand-tag","selectorAtom":".g-brand-tag"},{"hookId":"ui-brand-text","selectorAtom":".g-brand-text"},{"hookId":"ui-btn","selectorAtom":".g-btn"},{"hookId":"ui-byline","selectorAtom":".g-byline"},{"hookId":"ui-byline-text","selectorAtom":".g-byline-text"},{"hookId":"ui-card","selectorAtom":".g-card"},{"hookId":"ui-card-body","selectorAtom":".g-card-body"},{"hookId":"ui-card-excerpt","selectorAtom":".g-card-excerpt"},{"hookId":"ui-card-foot","selectorAtom":".g-card-foot"},{"hookId":"ui-card-link","selectorAtom":".g-card-link"},{"hookId":"ui-card-media","selectorAtom":".g-card-media"},{"hookId":"ui-card-placeholder","selectorAtom":".g-card-placeholder"},{"hookId":"ui-card-row","selectorAtom":".g-card-row"},{"hookId":"ui-card-top","selectorAtom":".g-card-top"},{"hookId":"ui-chip","selectorAtom":".g-chip"},{"hookId":"ui-codebar","selectorAtom":".g-codebar"},{"hookId":"ui-codebar-lang","selectorAtom":".g-codebar-lang"},{"hookId":"ui-codeblock","selectorAtom":".g-codeblock"},{"hookId":"ui-copy","selectorAtom":".g-copy"},{"hookId":"ui-copy-done","selectorAtom":".g-copy-done"},{"hookId":"ui-copy-idle","selectorAtom":".g-copy-idle"},{"hookId":"ui-crumbs","selectorAtom":".g-crumbs"},{"hookId":"ui-date-stamp","selectorAtom":".g-date-stamp"},{"hookId":"ui-dated-list","selectorAtom":".g-dated-list"},{"hookId":"ui-dated-row","selectorAtom":".g-dated-row"},{"hookId":"ui-dek","selectorAtom":".g-dek"},{"hookId":"ui-dot","selectorAtom":".g-dot"},{"hookId":"ui-eyebrow","selectorAtom":".g-eyebrow"},{"hookId":"ui-footer","selectorAtom":".g-footer"},{"hookId":"ui-footer-about","selectorAtom":".g-footer-about"},{"hookId":"ui-footer-base","selectorAtom":".g-footer-base"},{"hookId":"ui-footer-brand","selectorAtom":".g-footer-brand"},{"hookId":"ui-footer-col","selectorAtom":".g-footer-col"},{"hookId":"ui-footer-grid","selectorAtom":".g-footer-grid"},{"hookId":"ui-grid","selectorAtom":".g-grid"},{"hookId":"ui-header","selectorAtom":".g-header"},{"hookId":"ui-header-row","selectorAtom":".g-header-row"},{"hookId":"ui-hero","selectorAtom":".g-hero"},{"hookId":"ui-hero-body","selectorAtom":".g-hero-body"},{"hookId":"ui-hero-media","selectorAtom":".g-hero-media"},{"hookId":"ui-icon","selectorAtom":".g-icon"},{"hookId":"ui-icon-btn","selectorAtom":".g-icon-btn"},{"hookId":"ui-kbd","selectorAtom":".g-kbd"},{"hookId":"ui-label","selectorAtom":".g-label"},{"hookId":"ui-list","selectorAtom":".g-list"},{"hookId":"ui-main","selectorAtom":".g-main"},{"hookId":"ui-mark","selectorAtom":".g-mark"},{"hookId":"ui-menu","selectorAtom":".g-menu"},{"hookId":"ui-meta","selectorAtom":".g-meta"},{"hookId":"ui-mode-dark","selectorAtom":".g-mode-dark"},{"hookId":"ui-mode-icon","selectorAtom":".g-mode-icon"},{"hookId":"ui-mode-light","selectorAtom":".g-mode-light"},{"hookId":"ui-mode-system","selectorAtom":".g-mode-system"},{"hookId":"ui-more","selectorAtom":".g-more"},{"hookId":"ui-nav","selectorAtom":".g-nav"},{"hookId":"ui-newsletter","selectorAtom":".g-newsletter"},{"hookId":"ui-pager","selectorAtom":".g-pager"},{"hookId":"ui-pager-link","selectorAtom":".g-pager-link"},{"hookId":"ui-pager-next","selectorAtom":".g-pager-next"},{"hookId":"ui-pagination","selectorAtom":".g-pagination"},{"hookId":"ui-panel","selectorAtom":".g-panel"},{"hookId":"ui-panel-copy","selectorAtom":".g-panel-copy"},{"hookId":"ui-pill","selectorAtom":".g-pill"},{"hookId":"ui-pill-count","selectorAtom":".g-pill-count"},{"hookId":"ui-pills","selectorAtom":".g-pills"},{"hookId":"ui-progress","selectorAtom":".g-progress"},{"hookId":"ui-prose","selectorAtom":".g-prose"},{"hookId":"ui-search","selectorAtom":".g-search"},{"hookId":"ui-search-box","selectorAtom":".g-search-box"},{"hookId":"ui-search-btn","selectorAtom":".g-search-btn"},{"hookId":"ui-search-empty","selectorAtom":".g-search-empty"},{"hookId":"ui-search-hit","selectorAtom":".g-search-hit"},{"hookId":"ui-search-hit-meta","selectorAtom":".g-search-hit-meta"},{"hookId":"ui-search-hit-text","selectorAtom":".g-search-hit-text"},{"hookId":"ui-search-hit-title","selectorAtom":".g-search-hit-title"},{"hookId":"ui-search-input","selectorAtom":".g-search-input"},{"hookId":"ui-search-results","selectorAtom":".g-search-results"},{"hookId":"ui-section","selectorAtom":".g-section"},{"hookId":"ui-section-head","selectorAtom":".g-section-head"},{"hookId":"ui-series-box","selectorAtom":".g-series-box"},{"hookId":"ui-series-card","selectorAtom":".g-series-card"},{"hookId":"ui-series-here","selectorAtom":".g-series-here"},{"hookId":"ui-series-list","selectorAtom":".g-series-list"},{"hookId":"ui-series-n","selectorAtom":".g-series-n"},{"hookId":"ui-series-tag","selectorAtom":".g-series-tag"},{"hookId":"ui-share","selectorAtom":".g-share"},{"hookId":"ui-skip","selectorAtom":".g-skip"},{"hookId":"ui-social","selectorAtom":".g-social"},{"hookId":"ui-sr","selectorAtom":".g-sr"},{"hookId":"ui-tag","selectorAtom":".g-tag"},{"hookId":"ui-tags","selectorAtom":".g-tags"},{"hookId":"ui-toast","selectorAtom":".g-toast"},{"hookId":"ui-toc","selectorAtom":".g-toc"},{"hookId":"ui-toc-list","selectorAtom":".g-toc-list"},{"hookId":"ui-toc-mobile","selectorAtom":".g-toc-mobile"},{"hookId":"ui-topic-head","selectorAtom":".g-topic-head"},{"hookId":"ui-topic-hero","selectorAtom":".g-topic-hero"},{"hookId":"ui-topic-icon","selectorAtom":".g-topic-icon"},{"hookId":"ui-topic-strip","selectorAtom":".g-topic-strip"},{"hookId":"ui-wrap","selectorAtom":".g-wrap"}],"publicationRootSelector":"[data-gala-publication-root]","resolvedPaletteSelectors":{"dark":"[data-gala-publication-root][data-gala-resolved-color-mode=\"dark\"]","light":"[data-gala-publication-root][data-gala-resolved-color-mode=\"light\"]"},"stylesheetLayers":{"components":"gala-components","print":"gala-print","tokens":"gala-tokens","utilities":"gala-utilities"},"templatePackage":"@rathnasgala2/template","templateVersion":"4.0.0","typeSelectors":["a","article","blockquote","button","code","details","em","figure","footer","h1","h2","h3","h4","h5","h6","header","hr","img","li","main","nav","ol","p","pre","section","span","strong","summary","time","ul"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/template",
-  "version": "3.2.1",
+  "version": "4.0.0",
   "description": "Deterministic Eleventy-backed static publication renderer for Galascribe portable repositories.",
   "type": "module",
   "license": "Apache-2.0",
@@ -72,11 +72,13 @@
   "dependencies": {
     "@11ty/eleventy": "3.1.6",
     "@11ty/eleventy-plugin-syntaxhighlight": "5.0.2",
-    "@rathnasgala2/schemas": "3.3.0",
     "jpeg-js": "0.4.4",
     "markdown-it": "14.3.1",
     "sanitize-html": "2.17.7"
   },
+  "peerDependencies": {
+    "@rathnasgala2/schemas": "3.8.0"
+  },
   "devDependencies": {
     "@cyclonedx/cyclonedx-npm": "6.0.1",
     "@eslint/js": "10.0.1",

package/src/core/index.js

@@ -139,6 +139,7 @@ import {
   defaultThemeStylesheetLinksHtml,
   loadThemeAssets,
 } from './internal/theme-assets.js';
+import { EDITORIAL_COMPOSITION } from './internal/template-composition.js';
 import { resolveTextDirection } from './internal/text-direction.js';
 import {
   escapeHtml,
@@ -189,7 +190,7 @@ export const TEMPLATE_PACKAGE_NAME = '@rathnasgala2/template';
  *
  * @type {string}
  */
-export const TEMPLATE_PACKAGE_VERSION = '2.1.0';
+export const TEMPLATE_PACKAGE_VERSION = '4.0.0';
 
 /**
  * Validate the caller-supplied render options, independent of build-input
@@ -391,6 +392,22 @@ export async function renderPublication(buildInput, options) {
   const urlPrefix = derivePublicBasePath(validatedInput.baseUrl, '/');
   const homeRoute = joinPublicRoute(publicBasePath, '/');
 
+  // Admit the selected generation-4 theme and its complete structural
+  // composition before any output directory is created. Theme-less calls
+  // use the renderer's Editorial composition and the conventional print
+  // stylesheet link; a supplied theme never receives that fallback.
+  const themeAssetsResult = options.themeDirectory
+    ? await loadThemeAssets({
+        themeDirectory: path.resolve(options.themeDirectory),
+        basePath: validatedInput.basePath,
+        publicBasePath,
+      })
+    : undefined;
+  const themeStylesheetLinksHtml = themeAssetsResult
+    ? themeAssetsResult.linkTagsHtml
+    : defaultThemeStylesheetLinksHtml(publicBasePath);
+  const composition = themeAssetsResult?.composition ?? EDITORIAL_COMPOSITION;
+
   const appearanceControlHtml = renderAppearanceControl({
     messages: siteMessages,
   });
@@ -495,6 +512,8 @@ export async function renderPublication(buildInput, options) {
     showAttribution:
       validatedInput.appearance.attribution?.showMadeWith !== false,
     messages: siteMessages,
+    profile: composition.profile,
+    footerLayout: composition.footerLayout,
   });
 
   /**
@@ -522,6 +541,8 @@ export async function renderPublication(buildInput, options) {
       searchIndexHref,
       appearanceControlHtml,
       messages: siteMessages,
+      profile: composition.profile,
+      headerLayout: composition.headerLayout,
     });
 
   // The site-wide feeds, resolved once so every page's feed-discovery
@@ -540,22 +561,6 @@ export async function renderPublication(buildInput, options) {
     `/${GALA_BASE_STYLESHEET_PATH}`,
   );
 
-  // The selected theme package's copied stylesheets/passive assets and the
-  // ordered `<link>` markup every generated page's `<head>` inserts.
-  // Run before page assembly (same reasoning as the media pipeline above):
-  // every page's `data.themeStylesheetLinksHtml` needs the same one
-  // already-rendered fragment.
-  const themeAssetsResult = options.themeDirectory
-    ? await loadThemeAssets({
-        themeDirectory: path.resolve(options.themeDirectory),
-        basePath: validatedInput.basePath,
-        publicBasePath,
-      })
-    : undefined;
-  const themeStylesheetLinksHtml = themeAssetsResult
-    ? themeAssetsResult.linkTagsHtml
-    : defaultThemeStylesheetLinksHtml(publicBasePath);
-
   /** @type {{virtualPath: string, content: string, permalink: string, layout?: string, data?: Record<string, unknown>}[]} */
   const contentPages = [];
   /** @type {{joinedSource: string, joinedTarget: string, publicTarget: string, filePath: string}[]} */
@@ -567,6 +572,7 @@ export async function renderPublication(buildInput, options) {
     mediaAssets,
     mediaDimensions,
     interactions: interactionsOn ? interactionsModule : undefined,
+    composition,
   });
   /** @type {Set<string>} output paths of the interaction-bearing routes */
   const interactionBearingPaths = new Set();
@@ -629,6 +635,7 @@ export async function renderPublication(buildInput, options) {
         cspMetaTag,
         baseStylesheetHref: baseStylesheetHrefValue,
         themeStylesheetLinksHtml,
+        composition,
       },
     });
   });
@@ -701,6 +708,7 @@ export async function renderPublication(buildInput, options) {
       cspMetaTag,
       baseStylesheetHref: baseStylesheetHrefValue,
       themeStylesheetLinksHtml,
+      composition,
     },
   });
 

package/src/core/internal/appearance/base-layer.js

@@ -259,7 +259,7 @@ export const GALA_BASE_COMPONENT_CSS = `
     outline-offset: 3px;
   }
   [data-gala-publication-root] img { display: block; max-width: 100%; height: auto; }
-  [data-gala-publication-root] a { color: inherit; text-decoration: none; }
+  [data-gala-publication-root] :where(a) { color: inherit; text-decoration: none; }
   [data-gala-publication-root] h1, [data-gala-publication-root] h2, [data-gala-publication-root] h3, [data-gala-publication-root] p { margin: 0; }
   [data-gala-publication-root] button { font: inherit; color: inherit; }
   [data-gala-publication-root] ul, [data-gala-publication-root] ol { margin: 0; padding: 0; list-style: none; }
@@ -483,6 +483,12 @@ export const GALA_BASE_COMPONENT_CSS = `
   .g-card-row .g-card-media, .g-card-row .g-card-placeholder { aspect-ratio: 16 / 9; height: 100%; border-bottom: 0; border-right: var(--gala-border-media-divider); }
   .g-card-row .g-card-body { padding: clamp(1rem, 2.5vw, 1.75rem); }
   .g-card-row h2, .g-card-row h3 { font-size: clamp(1.3rem, 1rem + 1vw, 1.75rem); }
+  .g-dated-list { gap: 0; }
+  .g-dated-row { display: grid; grid-template-columns: minmax(8rem, 1fr) minmax(0, 5fr); gap: clamp(1rem, 3vw, 2rem); align-items: start; padding-block: var(--gala-space-4); border-top: var(--gala-border-row-divider); }
+  .g-date-stamp { padding-top: var(--gala-space-3); color: var(--gala-color-text-muted); font-family: var(--gala-font-ui); font-size: .8125rem; font-variant-numeric: tabular-nums; }
+  .g-dated-row .g-card-row { grid-template-columns: minmax(0, 1fr); padding: 0; border-bottom: 0; box-shadow: none; }
+  .g-dated-row .g-card-row .g-card-media, .g-dated-row .g-card-row .g-card-placeholder { display: none; }
+  .g-dated-row .g-card-foot .g-meta > time:first-child, .g-dated-row .g-card-foot .g-meta > time:first-child + .g-dot { display: none; }
 
   /* ---------- series ---------- */
   .g-series-card {
@@ -527,6 +533,12 @@ export const GALA_BASE_COMPONENT_CSS = `
   [data-gala-slot="edition-selector"] { display: grid; grid-template-columns: minmax(0, 1fr); gap: var(--gala-space-2); min-width: 0; max-width: 100%; }
   .g-article-cover { margin-block: 0; }
   .g-article-cover img { width: 100%; height: auto; aspect-ratio: 21 / 9; object-fit: cover; border-radius: var(--gala-radius-large); border: var(--gala-border-card); box-shadow: var(--gala-shadow-card); filter: var(--gala-media-filter); }
+  .g-article-cover-full-bleed { width: 100%; max-width: none; margin: 0; padding-inline: 0; }
+  .g-article-cover-full-bleed img { aspect-ratio: 16 / 9; border-inline: 0; border-radius: 0; }
+  [data-gala-media-ratio="mixed"] .g-hero-media { aspect-ratio: 3 / 2; }
+  [data-gala-media-ratio="mixed"] .g-grid > .g-card:nth-child(3n + 1) :is(.g-card-media, .g-card-placeholder) { aspect-ratio: 4 / 5; }
+  [data-gala-media-ratio="mixed"] .g-grid > .g-card:nth-child(3n + 2) :is(.g-card-media, .g-card-placeholder) { aspect-ratio: 3 / 2; }
+  [data-gala-media-ratio="mixed"] .g-grid > .g-card:nth-child(3n) :is(.g-card-media, .g-card-placeholder) { aspect-ratio: 1; }
   .g-article-grid { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, var(--gala-content-measure)) minmax(0, 1fr); gap: clamp(1.5rem, 4vw, 3.5rem); padding-block: clamp(2rem, 5vw, 3.5rem) var(--gala-space-4); }
   .g-article-grid > .g-prose { grid-column: 2; }
   .g-toc { position: sticky; top: 6rem; align-self: start; justify-self: end; width: min(100%, 15rem); display: grid; gap: var(--gala-space-3); }
@@ -810,6 +822,8 @@ export const GALA_BASE_COMPONENT_CSS = `
     .g-grid { grid-template-columns: minmax(0, 1fr); }
     .g-card-row { grid-template-columns: minmax(0, 1fr); }
     .g-card-row .g-card-media, .g-card-row .g-card-placeholder { border-right: 0; border-bottom: var(--gala-border-media-divider); height: auto; }
+    .g-dated-row { grid-template-columns: minmax(0, 1fr); gap: var(--gala-space-2); }
+    .g-date-stamp { padding-top: 0; }
     .g-pager { grid-template-columns: minmax(0, 1fr); }
     .g-pager-next { grid-column: 1; }
     .g-article-cover img { aspect-ratio: 16 / 10; }
@@ -832,7 +846,7 @@ export const GALA_BASE_COMPONENT_CSS = `
       @keyframes g-read { from { transform: scaleX(0); } to { transform: scaleX(1); } }
     }
     @supports (animation-timeline: view()) {
-      .g-grid > .g-card, .g-list > .g-card, .g-panel, .g-series-card, .g-author-card, .g-series-box, .g-prose > pre, .g-codeblock, .g-prose > figure, .g-prose > blockquote {
+      .g-grid > .g-card, .g-list > .g-card, .g-dated-row, .g-panel, .g-series-card, .g-author-card, .g-series-box, .g-prose > pre, .g-codeblock, .g-prose > figure, .g-prose > blockquote {
         animation: g-reveal linear both; animation-timeline: view(); animation-range: entry 0% entry 55%;
       }
       @keyframes g-reveal { from { opacity: .15; transform: translateY(28px) scale(.985); } }

package/src/core/internal/appearance/styling-contract.js

@@ -74,15 +74,19 @@ import {
   APPEARANCE_TOGGLE_ID,
 } from './contract.js';
 import { PAGE_KIND_ATTRIBUTE, PAGE_KIND_VALUES } from '../page-kinds.js';
+import {
+  COMPOSITION_ATTRIBUTES,
+  COMPOSITION_ATTRIBUTE_CATALOG,
+} from '../template-composition.js';
 import { SLOT_NAMES } from '../skeleton.js';
 import { canonicalizeJcs, domainDigest } from '../canonical-jcs.js';
 
 /** @type {string} */
 export const TEMPLATE_STYLING_CONTRACT_PACKAGE = '@rathnasgala2/template';
 /** @type {string} */
-export const TEMPLATE_STYLING_CONTRACT_VERSION = '3.0.0';
+export const TEMPLATE_STYLING_CONTRACT_VERSION = '4.0.0';
 /** @type {string} */
-export const TEMPLATE_STYLING_CONTRACT_TEMPLATE_VERSION = '3.0.0';
+export const TEMPLATE_STYLING_CONTRACT_TEMPLATE_VERSION = '4.0.0';
 
 /** @type {string} the `main-content` landmark's fixed `id`. */
 const MAIN_CONTENT_ID = 'main-content';
@@ -278,6 +282,9 @@ export const COMPONENT_CLASS_GROUPS = Object.freeze({
     'g-section-head',
     'g-grid',
     'g-list',
+    'g-dated-list',
+    'g-dated-row',
+    'g-date-stamp',
     'g-pills',
     'g-pill',
     'g-pill-count',
@@ -343,6 +350,7 @@ export const COMPONENT_CLASS_GROUPS = Object.freeze({
     'g-article-meta',
     'g-share',
     'g-article-cover',
+    'g-article-cover-full-bleed',
     'g-article-grid',
     'g-toc',
     'g-toc-list',
@@ -468,6 +476,13 @@ const ATTRIBUTE_VALUE_HOOKS = Object.freeze([
       kind: /** @type {const} */ ('attribute'),
     }),
   ),
+  ...COMPOSITION_ATTRIBUTES.map(({ field, name, value }) =>
+    Object.freeze({
+      hookId: `composition-${field.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-${value}`,
+      selectorAtom: `[${name}="${value}"]`,
+      kind: /** @type {const} */ ('attribute'),
+    }),
+  ),
 ]);
 
 /** @type {readonly StyleHookDefinition[]} every public hook, unsorted. */
@@ -524,6 +539,12 @@ export function buildTemplateStylingContract() {
       values: sortedUniqueBytes(PAGE_KIND_VALUES),
       role: 'semantic',
     },
+    ...COMPOSITION_ATTRIBUTE_CATALOG.map(({ name, values }) => ({
+      name,
+      match: 'exact-value',
+      values: sortedUniqueBytes(values),
+      role: 'semantic',
+    })),
   ].sort((a, b) => {
     const bufferA = Buffer.from(canonicalizeJcs(a), 'utf8');
     const bufferB = Buffer.from(canonicalizeJcs(b), 'utf8');
@@ -648,7 +669,7 @@ export function assertTemplateStylingContractShape(contract) {
   if (contract.profile !== 'gala-template-styling-contract-v2') {
     fail('profile');
   }
-  if (contract.contractVersion !== '3.0.0') fail('contractVersion');
+  if (contract.contractVersion !== '4.0.0') fail('contractVersion');
   if (contract.templatePackage !== '@rathnasgala2/template') {
     fail('templatePackage');
   }

package/src/core/internal/chrome.js

@@ -52,6 +52,8 @@ function renderMark(name, mark) {
  * @param {string} [options.appearanceControlHtml] the already-rendered
  *   appearance control, inserted into the `header-actions` slot
  * @param {Readonly<Record<string, string | ((...args: string[]) => string)>>} options.messages
+ * @param {string} options.profile the admitted composition profile
+ * @param {string} options.headerLayout the admitted composition's header layout
  * @returns {string} the rendered header
  */
 export function renderHeader({
@@ -66,6 +68,8 @@ export function renderHeader({
   searchIndexHref,
   appearanceControlHtml,
   messages,
+  profile,
+  headerLayout,
 }) {
   const label = (/** @type {string} */ key) =>
     escapeHtml(/** @type {string} */ (messages[key]));
@@ -74,19 +78,28 @@ export function renderHeader({
       ? `<details class="g-menu"><summary>${icon('menu')}<span class="g-sr">${label('menuSummaryLabel')}</span></summary>` +
         `<ul>${navItems.map((item) => renderNavItem(item, currentRoute, urlPrefix)).join('')}</ul></details>`
       : '';
-  return (
-    `<header class="g-header"><div class="g-wrap g-header-row">` +
+  const brand =
     `<a class="g-brand" href="${escapeHtml(homeRoute)}">${renderMark(publicationName, brandMark)}` +
     `<span class="g-brand-text"><span class="g-brand-name">${escapeHtml(publicationName)}</span>` +
-    `<span class="g-brand-tag">${escapeHtml(tagline)}</span></span></a>` +
-    navHtml +
+    `<span class="g-brand-tag">${escapeHtml(tagline)}</span></span></a>`;
+  const actions =
     `<div class="g-actions">` +
     `<button class="g-search-btn" type="button" hidden data-action="search" data-search-index="${escapeHtml(searchIndexHref)}" aria-label="${label('searchButtonAriaLabel')}">` +
     `${icon('search')}<span>${label('searchButtonLabel')}</span></button>` +
     renderSlot('header-actions', { html: appearanceControlHtml }) +
     menu +
-    `</div></div></header>`
-  );
+    `</div>`;
+  const content =
+    profile === 'newsletter'
+      ? actions + brand + navHtml
+      : profile === 'visual'
+        ? brand + actions + navHtml
+        : profile === 'personal'
+          ? navHtml + brand + actions
+          : profile === 'developer'
+            ? navHtml + actions + brand
+            : brand + navHtml + actions;
+  return `<header class="g-header" data-gala-header-layout="${escapeHtml(headerLayout)}"><div class="g-wrap g-header-row">${content}</div></header>`;
 }
 
 /**
@@ -146,6 +159,8 @@ function renderSocialLinks(socialLinks, rssHref, messages) {
  *   attribution line renders: the build input's
  *   `appearance.attribution.showMadeWith`, shown when absent
  * @param {Readonly<Record<string, string | ((...args: string[]) => string)>>} options.messages
+ * @param {string} options.profile the admitted composition profile
+ * @param {string} options.footerLayout the admitted composition's footer layout
  * @returns {string} the rendered footer
  */
 export function renderFooter({
@@ -163,6 +178,8 @@ export function renderFooter({
   copyrightText,
   showAttribution,
   messages,
+  profile,
+  footerLayout,
 }) {
   const label = (/** @type {string} */ key) =>
     escapeHtml(/** @type {string} */ (messages[key]));
@@ -176,20 +193,31 @@ export function renderFooter({
       ? ''
       : `<nav class="g-footer-col" aria-label="${label(labelKey)}"><p class="g-label">${label(labelKey)}</p>` +
         `<ul>${items.map((item) => renderNavItem(item, undefined, urlPrefix)).join('')}</ul></nav>`;
-  return (
-    `<footer class="g-footer"><div class="g-wrap g-footer-grid">` +
+  const brand =
     `<div class="g-footer-brand">` +
     `<a class="g-brand" href="${escapeHtml(homeRoute)}">${renderMark(publicationName, brandMark)}` +
     `<span class="g-brand-name">${escapeHtml(publicationName)}</span></a>` +
     `<p class="g-footer-about">${escapeHtml(description)}</p>` +
     renderSocialLinks(socialLinks, rssHref, messages) +
-    `</div>` +
-    column('exploreColumnLabel', primaryItems) +
-    column('footerNavigationLabel', footerItems) +
+    `</div>`;
+  const primary = column('exploreColumnLabel', primaryItems);
+  const secondary = column('footerNavigationLabel', footerItems);
+  const profileCard =
     `<div class="g-footer-col">` +
     renderSlot('footer-profile', { html: authorHtml + footerProfileHtml }) +
-    `</div>` +
-    `</div>` +
+    `</div>`;
+  const grid =
+    profile === 'newsletter'
+      ? brand + profileCard + primary + secondary
+      : profile === 'visual'
+        ? brand + primary + profileCard + secondary
+        : profile === 'personal'
+          ? profileCard + brand + primary + secondary
+          : profile === 'developer'
+            ? primary + secondary + brand + profileCard
+            : brand + primary + secondary + profileCard;
+  return (
+    `<footer class="g-footer" data-gala-footer-layout="${escapeHtml(footerLayout)}"><div class="g-wrap g-footer-grid">${grid}</div>` +
     renderSlot('footer-auxiliary') +
     renderSlot('account-intent') +
     renderSlot('conversation') +

package/src/core/internal/eleventy-render.js

@@ -172,7 +172,7 @@ const SKELETON_LAYOUT_SOURCE = [
   '<link rel="stylesheet" href="{{ baseStylesheetHref }}">',
   '{{ themeStylesheetLinksHtml | safe }}',
   '</head>',
-  `<body ${PAGE_KIND_ATTRIBUTE}="{{ pageKind }}">`,
+  `<body ${PAGE_KIND_ATTRIBUTE}="{{ pageKind }}" data-gala-profile="{{ composition.profile }}" data-gala-home-layout="{{ composition.homeLayout }}" data-gala-article-layout="{{ composition.articleLayout }}" data-gala-author-layout="{{ composition.authorLayout }}" data-gala-listing-layout="{{ composition.listingLayout }}" data-gala-header-layout="{{ composition.headerLayout }}" data-gala-footer-layout="{{ composition.footerLayout }}" data-gala-media-ratio="{{ composition.mediaRatio }}" data-gala-density="{{ composition.density }}">`,
   '{{ content | safe }}',
   '</body>',
   '</html>',

package/src/core/internal/page-kinds.js

@@ -88,6 +88,10 @@ import { getMessages } from './messages.js';
 import { resolveTextDirection } from './text-direction.js';
 import { deriveAuthorSlugs, routeSegmentForLabel } from './route-labels.js';
 import { derivePublicBasePath, joinPublicRoute } from './route.js';
+import {
+  assertSupportedComposition,
+  EDITORIAL_COMPOSITION,
+} from './template-composition.js';
 
 /** Listing page size (index and per-year archive pages). Scoped decision:
  * this renderer has no externally fixed page size; 10 is a deterministic,
@@ -383,11 +387,46 @@ export function homeDocumentTitle(name, tagline) {
  * @param {import('../../../types/index.d.ts').InteractionsModule} [options.interactions]
  *   the validated interactions module; when set, every article page carries
  *   the interactions section and is interaction-bearing
+ * @param {unknown} [options.composition] the schema-validated structural
+ *   composition selected by the theme; defaults to Editorial only for
+ *   theme-less renderer use
  * @returns {GeneratedPage[]} every generated page, in a stable, deterministic
  *   order
  */
 export function buildGeneratedPages(validatedInput, options) {
   const { publication, authors, content, basePath, baseUrl } = validatedInput;
+  const composition = assertSupportedComposition(
+    options.composition ?? EDITORIAL_COMPOSITION,
+  );
+  /**
+   * Preserve every content region while giving each article direction its
+   * own reading sequence and semantic container.
+   *
+   * @param {{head: string, cover: string, toc: string, prose: string, foot: string}} parts
+   * @returns {string}
+   */
+  const articleStructure = ({ head, cover, toc, prose, foot }) => {
+    /**
+     * @param {string} contents rendered article regions
+     * @param {string} [element] semantic wrapper element
+     * @returns {string}
+     */
+    const grid = (contents, element = 'div') =>
+      `<${element} class="g-wrap g-article-grid">${contents}</${element}>`;
+    if (composition.profile === 'newsletter') {
+      return `<section>${head}${cover}${grid(prose + toc, 'section')}${foot}</section>`;
+    }
+    if (composition.profile === 'visual') {
+      return `<div>${cover}${head}${grid(prose + toc)}</div>${foot}`;
+    }
+    if (composition.profile === 'personal') {
+      return `<section>${head}${cover}${grid(prose)}${toc ? grid(toc, 'section') : ''}${foot}</section>`;
+    }
+    if (composition.profile === 'developer') {
+      return `<div>${head}${cover}${grid(toc + prose, 'section')}${foot}</div>`;
+    }
+    return head + cover + grid(toc + prose) + foot;
+  };
   const interactionsModule = interactionsActive(options.interactions)
     ? options.interactions
     : undefined;
@@ -612,13 +651,32 @@ export function buildGeneratedPages(validatedInput, options) {
    * @param {string} [afterHtml] markup after the list (pagination)
    * @returns {string}
    */
-  const rowList = (items, afterHtml = '') =>
-    `<section class="g-wrap g-section">` +
-    (items.length > 0
-      ? `<div class="g-list">${items.map((record) => cardOf(record, 'row', 2)).join('')}</div>`
-      : `<p>${text('emptyListingLabel')}</p>`) +
-    afterHtml +
-    `</section>`;
+  const rowList = (items, afterHtml = '') => {
+    const grid = composition.listingLayout === 'image-grid';
+    const issueCards = composition.listingLayout === 'issues';
+    const datedRows = composition.listingLayout === 'dated-rows';
+    const outer =
+      composition.profile === 'personal' || composition.profile === 'developer'
+        ? 'div'
+        : 'section';
+    const contents =
+      items.length > 0
+        ? datedRows
+          ? `<div class="g-list g-dated-list">${items
+              .map(
+                (record) =>
+                  `<div class="g-dated-row"><time class="g-date-stamp" datetime="${escapeHtml(record.frontmatter.publishedAt)}">` +
+                  `${call('formatDate', record.frontmatter.publishedAt)}</time>${cardOf(record, 'row', 2)}</div>`,
+              )
+              .join('')}</div>`
+          : `<div class="${grid ? 'g-grid' : 'g-list'}">${items
+              .map((record) =>
+                cardOf(record, grid || issueCards ? 'grid' : 'row', 2),
+              )
+              .join('')}</div>`
+        : `<p>${text('emptyListingLabel')}</p>`;
+    return `<${outer} class="g-wrap g-section" data-gala-listing-layout="${composition.listingLayout}">${contents}${afterHtml}</${outer}>`;
+  };
 
   /**
    * One listing page's metadata: bare title, `<title>`, description,
@@ -710,6 +768,28 @@ export function buildGeneratedPages(validatedInput, options) {
         ? `<p class="g-dek">${escapeHtml(author.biography)}</p>`
         : '') +
       links;
+    const authorHead = listingHead({
+      breadcrumbHtml: crumbs(
+        [{ label: /** @type {string} */ (messages.authorsSectionLabel) }],
+        [{ label: author.displayName }],
+      ),
+      kicker: /** @type {string} */ (messages.authorKickerLabel),
+      count: authored.length,
+      title: author.displayName,
+      descriptionHtml: intro,
+      markHtml: avatar(author),
+    });
+    const authoredList = rowList(authored);
+    const authorContents =
+      composition.profile === 'newsletter'
+        ? `<section>${authorHead}${authoredList}</section>`
+        : composition.profile === 'visual'
+          ? `<div>${authorHead}<section>${authoredList}</section></div>`
+          : composition.profile === 'personal'
+            ? `<section>${authorHead}<div>${authoredList}</div></section>`
+            : composition.profile === 'developer'
+              ? `<div>${authorHead}<div>${authoredList}</div></div>`
+              : authorHead + authoredList;
     pages.push({
       kind: 'author',
       route: authorRoute(author),
@@ -737,17 +817,9 @@ export function buildGeneratedPages(validatedInput, options) {
         }),
       ),
       bodyHtml:
-        listingHead({
-          breadcrumbHtml: crumbs(
-            [{ label: /** @type {string} */ (messages.authorsSectionLabel) }],
-            [{ label: author.displayName }],
-          ),
-          kicker: /** @type {string} */ (messages.authorKickerLabel),
-          count: authored.length,
-          title: author.displayName,
-          descriptionHtml: intro,
-          markHtml: avatar(author),
-        }) + rowList(authored),
+        `<div data-gala-author-layout="${composition.authorLayout}">` +
+        authorContents +
+        `</div>`,
     });
   }
 
@@ -822,7 +894,7 @@ export function buildGeneratedPages(validatedInput, options) {
       editionSelector +
       `</div>`;
     const cover = hero
-      ? `<figure class="g-wrap g-article-cover">${renderImage({ image: hero, alt: heroMedia?.role === 'decorative' ? '' : (heroMedia?.alt ?? ''), priority: true })}</figure>`
+      ? `<figure class="${composition.articleLayout === 'full-bleed' ? 'g-article-cover g-article-cover-full-bleed' : 'g-wrap g-article-cover'}">${renderImage({ image: hero, alt: heroMedia?.role === 'decorative' ? '' : (heroMedia?.alt ?? ''), priority: true })}</figure>`
       : '';
     const tocNav = contents
       ? `<nav class="g-toc" aria-label="${text('onThisPageLabel')}"><p class="g-label">${icon('list')}${text('onThisPageLabel')}</p>${contents}</nav>`
@@ -1001,8 +1073,8 @@ export function buildGeneratedPages(validatedInput, options) {
       interactionBearing: Boolean(interactions),
       lastModified: contentLastModified(frontmatter),
       bodyHtml:
-        `<article class="g-article">${isArticle || isEdition ? '<div class="g-progress" aria-hidden="true"></div>' : ''}${head}${cover}` +
-        `<div class="g-wrap g-article-grid">${tocNav}${prose}</div>${foot}</article>` +
+        `<article class="g-article" data-gala-article-layout="${composition.articleLayout}">${isArticle || isEdition ? '<div class="g-progress" aria-hidden="true"></div>' : ''}` +
+        `${articleStructure({ head, cover, toc: tocNav, prose, foot })}</article>` +
         after +
         (isArticle ? newsletterHtml : ''),
     });
@@ -1093,15 +1165,49 @@ export function buildGeneratedPages(validatedInput, options) {
         ? `<section class="g-wrap g-section"><div class="g-section-head"><h2>${text('moreArticlesHeading')}</h2></div>` +
           `<div class="g-list">${items.map((r) => cardOf(r, 'row')).join('')}</div>${pagination}</section>`
         : '';
-    const bodyHtml =
-      pageNumber === 1
+    const homeParts =
+      composition.profile === 'newsletter'
         ? homeHeading +
-          homeFeatured +
           homeTags +
+          homeFeatured +
           homeLatest +
-          homeSeries +
           moreList +
+          homeSeries +
           newsletterHtml
+        : composition.profile === 'visual'
+          ? homeHeading +
+            homeFeatured +
+            homeLatest +
+            homeSeries +
+            homeTags +
+            moreList +
+            newsletterHtml
+          : composition.profile === 'personal'
+            ? homeHeading +
+              homeLatest +
+              homeFeatured +
+              moreList +
+              homeTags +
+              homeSeries +
+              newsletterHtml
+            : composition.profile === 'developer'
+              ? homeHeading +
+                homeTags +
+                homeLatest +
+                homeSeries +
+                homeFeatured +
+                moreList +
+                newsletterHtml
+              : homeHeading +
+                homeFeatured +
+                homeTags +
+                homeLatest +
+                homeSeries +
+                moreList +
+                newsletterHtml;
+    const bodyHtml =
+      pageNumber === 1
+        ? `<div data-gala-home-layout="${composition.homeLayout}">${homeParts}</div>`
         : listingHead({
             breadcrumbHtml: crumbs([
               { label: /** @type {string} */ (messages.indexHeading) },

package/src/core/internal/template-composition.js

@@ -0,0 +1,185 @@
+/**
+ * Generation-4 template composition admission.
+ *
+ * A composition is one complete, immutable product direction. Admission is
+ * deliberately by exact object equality so fields from different directions
+ * cannot be combined into renderer states that were never designed or tested.
+ */
+
+/** The immutable generation-4 composition schema identity. */
+export const TEMPLATE_COMPOSITION_SCHEMA_ID =
+  'urn:gala:schema:template-composition:2.0.0';
+
+const SCHEMA_FIELDS = Object.freeze({
+  schemaId: TEMPLATE_COMPOSITION_SCHEMA_ID,
+  schemaVersion: '2.0.0',
+});
+
+/** The complete Editorial composition. */
+export const EDITORIAL_COMPOSITION = Object.freeze({
+  ...SCHEMA_FIELDS,
+  profile: 'editorial',
+  homeLayout: 'magazine',
+  articleLayout: 'editorial',
+  authorLayout: 'portrait',
+  listingLayout: 'rows',
+  headerLayout: 'masthead',
+  footerLayout: 'expanded',
+  mediaRatio: 'landscape',
+  density: 'comfortable',
+});
+
+/** The complete Newsletter composition. */
+export const NEWSLETTER_COMPOSITION = Object.freeze({
+  ...SCHEMA_FIELDS,
+  profile: 'newsletter',
+  homeLayout: 'newspaper',
+  articleLayout: 'issue',
+  authorLayout: 'profile',
+  listingLayout: 'issues',
+  headerLayout: 'publication',
+  footerLayout: 'expanded',
+  mediaRatio: 'landscape',
+  density: 'comfortable',
+});
+
+/** The complete Visual composition. */
+export const VISUAL_COMPOSITION = Object.freeze({
+  ...SCHEMA_FIELDS,
+  profile: 'visual',
+  homeLayout: 'gallery',
+  articleLayout: 'full-bleed',
+  authorLayout: 'portfolio',
+  listingLayout: 'image-grid',
+  headerLayout: 'minimal',
+  footerLayout: 'compact',
+  mediaRatio: 'mixed',
+  density: 'comfortable',
+});
+
+/** The complete Personal composition. */
+export const PERSONAL_COMPOSITION = Object.freeze({
+  ...SCHEMA_FIELDS,
+  profile: 'personal',
+  homeLayout: 'chronological',
+  articleLayout: 'prose',
+  authorLayout: 'biography',
+  listingLayout: 'dated-rows',
+  headerLayout: 'compact',
+  footerLayout: 'compact',
+  mediaRatio: 'landscape',
+  density: 'spacious',
+});
+
+/** The complete Developer composition. */
+export const DEVELOPER_COMPOSITION = Object.freeze({
+  ...SCHEMA_FIELDS,
+  profile: 'developer',
+  homeLayout: 'topic-index',
+  articleLayout: 'technical',
+  authorLayout: 'biography',
+  listingLayout: 'rows',
+  headerLayout: 'utility',
+  footerLayout: 'compact',
+  mediaRatio: 'landscape',
+  density: 'compact',
+});
+
+/** Every complete composition implemented by generation 4. */
+export const SUPPORTED_COMPOSITIONS = Object.freeze([
+  EDITORIAL_COMPOSITION,
+  NEWSLETTER_COMPOSITION,
+  VISUAL_COMPOSITION,
+  PERSONAL_COMPOSITION,
+  DEVELOPER_COMPOSITION,
+]);
+
+/** @type {Readonly<Record<string, (typeof SUPPORTED_COMPOSITIONS)[number]>>} */
+const COMPOSITION_BY_PROFILE = Object.freeze(
+  Object.fromEntries(
+    SUPPORTED_COMPOSITIONS.map((composition) => [
+      composition.profile,
+      composition,
+    ]),
+  ),
+);
+
+const COMPOSITION_ATTRIBUTE_NAMES = Object.freeze({
+  profile: 'data-gala-profile',
+  homeLayout: 'data-gala-home-layout',
+  articleLayout: 'data-gala-article-layout',
+  authorLayout: 'data-gala-author-layout',
+  listingLayout: 'data-gala-listing-layout',
+  headerLayout: 'data-gala-header-layout',
+  footerLayout: 'data-gala-footer-layout',
+  mediaRatio: 'data-gala-media-ratio',
+  density: 'data-gala-density',
+});
+
+/** @typedef {(typeof SUPPORTED_COMPOSITIONS)[number]} SupportedComposition */
+/** @typedef {Exclude<keyof SupportedComposition, 'schemaId' | 'schemaVersion'>} CompositionField */
+
+/** Public semantic attribute catalogs corresponding to composition fields. */
+export const COMPOSITION_ATTRIBUTE_CATALOG = Object.freeze(
+  /** @type {readonly [CompositionField, string][]} */ (
+    Object.entries(COMPOSITION_ATTRIBUTE_NAMES)
+  ).map(([field, name]) =>
+    Object.freeze({
+      field,
+      name,
+      values: Object.freeze([
+        ...new Set(
+          SUPPORTED_COMPOSITIONS.map((composition) => composition[field]),
+        ),
+      ]),
+    }),
+  ),
+);
+
+/** Every public semantic attribute/value pair themes may select. */
+export const COMPOSITION_ATTRIBUTES = Object.freeze(
+  COMPOSITION_ATTRIBUTE_CATALOG.flatMap(({ field, name, values }) =>
+    values.map((value) => Object.freeze({ field, name, value })),
+  ),
+);
+
+/**
+ * Admit exactly one complete composition implemented by this renderer.
+ *
+ * @param {unknown} candidate a complete template-composition document
+ * @returns {(typeof SUPPORTED_COMPOSITIONS)[number]} canonical composition
+ */
+export function assertSupportedComposition(candidate) {
+  if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {
+    throw new Error(
+      `composition must be a complete ${TEMPLATE_COMPOSITION_SCHEMA_ID} document`,
+    );
+  }
+  const composition = /** @type {Record<string, unknown>} */ (candidate);
+  const selected =
+    typeof composition.profile === 'string' &&
+    Object.hasOwn(COMPOSITION_BY_PROFILE, composition.profile)
+      ? COMPOSITION_BY_PROFILE[composition.profile]
+      : undefined;
+  if (!selected) {
+    throw new Error(
+      `composition.profile (${JSON.stringify(composition.profile)}) is not implemented by this renderer`,
+    );
+  }
+  const expectedKeys = Object.keys(selected).sort();
+  const actualKeys = Object.keys(composition).sort();
+  if (JSON.stringify(actualKeys) !== JSON.stringify(expectedKeys)) {
+    throw new Error(
+      `composition must contain exactly ${expectedKeys.join(', ')}`,
+    );
+  }
+  for (const [key, expected] of Object.entries(selected)) {
+    if (composition[key] !== expected) {
+      throw new Error(
+        `composition.${key} (${JSON.stringify(composition[key])}) is not ` +
+          `implemented for ${selected.profile}; expected ${JSON.stringify(expected)}`,
+      );
+    }
+  }
+  return selected;
+}

package/src/core/internal/theme-assets.js

@@ -85,8 +85,9 @@ import { sanitizeThemeSvg } from './media/theme-svg-sanitizer.js';
 import { projectFixedAssetPath } from './route.js';
 import { satisfiesTemplateRange } from './semver-range.js';
 import { escapeHtml } from './skeleton.js';
+import { assertSupportedComposition } from './template-composition.js';
 
-/** @type {string} the `urn:gala:schema:theme-contract:2.0.0` schema id
+/** @type {string} the immutable `urn:gala:schema:theme-contract:2.0.0` schema id
  * every consumed `theme.json` is validated against (TPL-H1). */
 const THEME_CONTRACT_SCHEMA_ID = 'urn:gala:schema:theme-contract:2.0.0';
 
@@ -415,7 +416,7 @@ function assertThemeContractIntegrity(themeJson) {
   if (!validation.valid) {
     throw new ThemeAssetError(
       'THEME_CONTRACT_SCHEMA_INVALID',
-      `theme.json failed urn:gala:schema:theme-contract:2.0.0 validation ` +
+      `theme.json failed ${THEME_CONTRACT_SCHEMA_ID} validation ` +
         `(${validation.diagnostics.length} diagnostic(s)): ` +
         JSON.stringify(validation.diagnostics),
     );
@@ -458,6 +459,14 @@ function assertThemeContractIntegrity(themeJson) {
         `(${TEMPLATE_STYLING_CONTRACT_TEMPLATE_VERSION})`,
     );
   }
+  try {
+    assertSupportedComposition(themeJson.composition);
+  } catch (error) {
+    throw new ThemeAssetError(
+      'THEME_COMPOSITION_UNSUPPORTED',
+      /** @type {Error} */ (error).message,
+    );
+  }
 }
 
 /**
@@ -490,6 +499,7 @@ function subresourceIntegrityAttribute(bytes) {
  *   files: {path: string, bytes: Buffer}[],
  *   assets: import('../../../types/index.d.ts').ManifestAssetEntry[],
  *   linkTagsHtml: string,
+ *   composition: (typeof import('./template-composition.js').SUPPORTED_COMPOSITIONS)[number],
  * }>} the files to write (already `basePath`-joined), their manifest rows
  *   (same joined paths), and the ready-to-insert `<link>` markup
  */
@@ -611,7 +621,12 @@ export async function loadThemeAssets({
     });
   }
 
-  return { files, assets, linkTagsHtml: linkTags.join('') };
+  return {
+    files,
+    assets,
+    linkTagsHtml: linkTags.join(''),
+    composition: assertSupportedComposition(themeJson.composition),
+  };
 }
 
 /**