@warpgogol/werkstatt-shared 0.2.0

package/src/ontology/biome-token-projection.ts

@@ -0,0 +1,229 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Single source of truth for the biome-YAML-field to --ds-* CSS custom property
+projection (RFC-0071). Consumed by biome.css.generate (codegen), biome.contract.validate
+(contract check), and biome.tokens.validate (drift detection). Replaces three
+divergent copies of the same mapping.
+</purpose>
+<non-goals>
+  <item>Do not validate token names against @warpgogol/werkstatt-site/tokens — that is the checks package's job.</item>
+  <item>Do not format CSS for emission — callers handle formatting.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial: consolidated BIOME_TO_TOKEN_MAP, BIOME_TO_CSS_VAR, and buildExpectedBiomeCss into one projection.</item>
+</CHANGE_SUMMARY>
+*/
+
+// ---------------------------------------------------------------------------
+// Primary mapping: biome dotted field path to CSS custom property name
+// ---------------------------------------------------------------------------
+
+export const BIOME_TO_TOKEN_MAP = {
+  // Palette — semantic color slots (RFC-0071)
+  "palette.brand": "--ds-color-primary",
+  "palette.brandHover": "--ds-color-secondary",
+  "palette.brandContrast": "--ds-color-text-inverse",
+  "palette.accent": "--ds-color-accent",
+  "palette.surface": "--ds-color-bg",
+  "palette.surfaceMuted": "--ds-color-surface",
+  "palette.ink": "--ds-color-text",
+  "palette.inkSoft": "--ds-color-text-muted",
+  "palette.inkMuted": "--ds-color-text-quiet",
+  "palette.divider": "--ds-color-border",
+  "palette.success": "--ds-color-success",
+  "palette.warning": "--ds-color-warning-strong",
+  "palette.danger": "--ds-color-danger",
+  "palette.info": "--ds-color-info",
+  // Components
+  "components.heroOverlay": "--ds-color-hero-overlay",
+  "components.heroText": "--ds-color-hero-text",
+  "components.surfaceGlass": "--ds-color-surface-glass",
+  "components.sectionAltBase": "--ds-color-section-alt-base",
+  "components.sectionAltText": "--ds-color-section-alt-text",
+  "components.sectionAltTextSoft": "--ds-color-section-alt-text-soft",
+  "components.sectionAltLink": "--ds-color-section-alt-link",
+  "components.sectionAltLinkVisited": "--ds-color-section-alt-link-visited",
+  "components.sectionAltLinkHover": "--ds-color-section-alt-link-hover",
+  "components.sectionAltAccent": "--ds-color-section-alt-accent",
+  "components.statsBg": "--ds-color-stats-bg",
+  "components.footerBg": "--ds-color-footer-bg",
+  "components.footerText": "--ds-color-footer-text",
+  "components.footerTextMuted": "--ds-color-footer-text-muted",
+  "components.cardBg": "--ds-color-card-bg",
+  "components.cardBorder": "--ds-color-card-border",
+  "components.cta": "--ds-color-cta",
+  "components.ctaHover": "--ds-color-cta-hover",
+  "components.ctaText": "--ds-color-cta-text",
+  "components.surfaceAlt": "--ds-color-surface-alt",
+  "components.textSoftOnDark": "--ds-color-text-soft-on-dark",
+  "components.textInverse84": "--ds-color-text-inverse-84",
+  "components.surfaceHover": "--ds-color-surface-hover",
+  "components.surfaceRaised": "--ds-color-surface-raised",
+  "components.accentContrast": "--ds-color-accent-contrast",
+  "components.accentHover": "--ds-color-accent-hover",
+  "components.bodyBg": "--ds-color-bg",
+  // Typography — full family + scale (RFC-0071 expansion)
+  "typography.headingFamily": "--ds-font-heading",
+  "typography.bodyFamily": "--ds-font-body",
+  "typography.monoFamily": "--ds-font-mono",
+  "typography.baseSize": "--ds-text-base",
+  "typography.lineHeightBody": "--ds-line-height-body",
+  "typography.lineHeightHeading": "--ds-line-height-heading",
+  "typography.lineHeightRelaxed": "--ds-line-height-relaxed",
+  "typography.measureBody": "--ds-size-container-measure-body",
+  "typography.measureHeading": "--ds-size-container-measure-heading",
+  // Spacing — base + layout (RFC-0071)
+  "spacing.base": "--ds-space-4",
+  "spacing.sectionPaddingY": "--ds-size-section-padding-y",
+  "spacing.containerMaxWidth": "--ds-size-container-max",
+  "spacing.containerNarrow": "--ds-size-container-narrow",
+  "spacing.gutter": "--ds-size-section-padding-x",
+  // Motion — duration set + easing (RFC-0071 expansion)
+  "motion.durationFast": "--ds-duration-fast",
+  "motion.durationMedium": "--ds-duration-medium",
+  "motion.durationSlow": "--ds-duration-slow",
+  "motion.easing": "--ds-ease-biome",
+  // Axes that surface as live tokens
+  "axes.cornerRadius": "--ds-radius-xs",
+  "axes.cornerRadiusFull": "--ds-radius-full",
+  "axes.borderWeight": "--ds-border-1",
+  // Font weights
+  "fontWeights.bold": "--ds-font-weight-bold",
+  // Geometry — diagram styling (RFC-0071)
+  "geometry.diagramLineWeight": "--ds-border-diagram-line",
+  "geometry.diagramAccentColor": "--ds-color-accent",
+  // RFC-0098: biome-scoped shadows (override studio defaults from tokens.css)
+  "shadows.sm": "--ds-shadow-sm",
+  "shadows.md": "--ds-shadow-md",
+  "shadows.lg": "--ds-shadow-lg",
+  "shadows.xl": "--ds-shadow-xl",
+  "shadows.glass": "--ds-shadow-glass",
+  "shadows.glow": "--ds-shadow-glow",
+  "shadows.header": "--ds-shadow-header",
+  "shadows.appeal": "--ds-shadow-appeal",
+  // RFC-0098: biome-scoped gradients (brand-derived; studio fallback is uncolored)
+  "gradients.accent": "--ds-gradient-accent",
+  "gradients.primary": "--ds-gradient-primary",
+  "gradients.vignetteDark": "--ds-gradient-vignette-dark",
+} as const satisfies Record<string, string>;
+
+// ---------------------------------------------------------------------------
+// Alias entries: one biome field produces an additional CSS var beyond the primary
+// ---------------------------------------------------------------------------
+
+export interface BiomeTokenAlias {
+  field: string;
+  token: string;
+}
+
+export const BIOME_TOKEN_ALIASES: readonly BiomeTokenAlias[] = [
+  { field: "palette.ink", token: "--ds-color-text-primary" },
+  { field: "palette.inkSoft", token: "--ds-color-text-secondary" },
+  { field: "typography.lineHeightBody", token: "--ds-line-height-normal" },
+  { field: "spacing.base", token: "--ds-size-1" },
+  { field: "axes.cornerRadius", token: "--ds-radius-md" },
+];
+
+// ---------------------------------------------------------------------------
+// Derived entries: computed from multiple biome fields
+// ---------------------------------------------------------------------------
+
+export interface BiomeTokenDerived {
+  token: string;
+  compute: (biome: Record<string, unknown>) => string | undefined;
+}
+
+export const BIOME_TOKEN_DERIVED: readonly BiomeTokenDerived[] = [
+  {
+    token: "--ds-text-sm",
+    compute: (biome) => {
+      const t = biome.typography as Record<string, string | number> | undefined;
+      if (!t?.baseSize || !t?.scaleRatio) return undefined;
+      const base = parseFloat(String(t.baseSize));
+      const ratio = parseFloat(String(t.scaleRatio));
+      if (isNaN(base) || isNaN(ratio)) return undefined;
+      return `${(base / ratio).toFixed(2)}px`;
+    },
+  },
+  {
+    token: "--ds-text-lg",
+    compute: (biome) => {
+      const t = biome.typography as Record<string, string | number> | undefined;
+      if (!t?.baseSize || !t?.scaleRatio) return undefined;
+      const base = parseFloat(String(t.baseSize));
+      const ratio = parseFloat(String(t.scaleRatio));
+      if (isNaN(base) || isNaN(ratio)) return undefined;
+      return `${(base * ratio).toFixed(2)}px`;
+    },
+  },
+  {
+    token: "--ds-text-xl",
+    compute: (biome) => {
+      const t = biome.typography as Record<string, string | number> | undefined;
+      if (!t?.baseSize || !t?.scaleRatio) return undefined;
+      const base = parseFloat(String(t.baseSize));
+      const ratio = parseFloat(String(t.scaleRatio));
+      if (isNaN(base) || isNaN(ratio)) return undefined;
+      return `${(base * ratio * ratio).toFixed(2)}px`;
+    },
+  },
+];
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Get a value from a nested biome object using a dotted path like "palette.brand". */
+export function getBiomeField(biome: Record<string, unknown>, field: string): unknown {
+  return field.split(".").reduce<unknown>((obj, key) => {
+    return obj && typeof obj === "object" ? (obj as Record<string, unknown>)[key] : undefined;
+  }, biome);
+}
+
+/**
+ * Project a parsed biome object into a Map of token name to value.
+ *
+ * Iterates the primary mapping, then aliases, then derived entries.
+ * Only includes tokens whose source field is present in the biome.
+ */
+export function projectBiomeToTokens(biome: Record<string, unknown>): Map<string, string> {
+  const result = new Map<string, string>();
+
+  for (const [field, token] of Object.entries(BIOME_TO_TOKEN_MAP)) {
+    const value = getBiomeField(biome, field);
+    if (value !== undefined && value !== null) {
+      result.set(token, String(value));
+    }
+  }
+
+  for (const { field, token } of BIOME_TOKEN_ALIASES) {
+    const value = getBiomeField(biome, field);
+    if (value !== undefined && value !== null) {
+      result.set(token, String(value));
+    }
+  }
+
+  for (const { token, compute } of BIOME_TOKEN_DERIVED) {
+    const value = compute(biome);
+    if (value !== undefined) {
+      result.set(token, value);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * All token names produced by the projection (primary + aliases + derived).
+ * Used by biome.contract.validate to check that every mapped token exists in
+ * the @warpgogol/werkstatt-site/tokens TOKEN_NAME_SET.
+ */
+export function getAllProjectedTokenNames(): readonly string[] {
+  const names = new Set<string>();
+  for (const token of Object.values(BIOME_TO_TOKEN_MAP)) names.add(token);
+  for (const { token } of BIOME_TOKEN_ALIASES) names.add(token);
+  for (const { token } of BIOME_TOKEN_DERIVED) names.add(token);
+  return [...names];
+}

package/src/ontology/biomes/check-concrete-blueprint.yaml

@@ -0,0 +1,118 @@
+id: check-concrete-blueprint
+version: 1.0.0
+displayName: Check · Concrete Blueprint
+family: check-quality-operator
+axes:
+  warmth: warm
+  contrast: high
+  density: airy
+  typographySharpness: sharp
+  diagramPresence: central
+  photoStance: founder-only
+  motionStance: restrained
+  textContrast: aa
+  cornerRadius: 2px
+  borderWeight: 1px
+palette:
+  brand: "#C0780A"
+  brandHover: "#A06008"
+  brandContrast: "#17191D"
+  accent: "#C0780A"
+  surface: "#F4F2EE"
+  surfaceMuted: "#E4E2DE"
+  ink: "#1B1D22"
+  inkSoft: "#373A40"
+  inkMuted: "#6C747B"
+  divider: "#C9C9C4"
+  success: "#3E7456"
+  warning: "#D9951B"
+  danger: "#A13F35"
+  info: "#516A84"
+components:
+  heroOverlay: linear-gradient(90deg, rgb(244 242 238 / 0.96) 0%, rgb(244 242 238
+    / 0.82) 45%, rgb(244 242 238 / 0) 60%, rgb(244 242 238 / 0) 100%)
+  heroText: "#1B1D22"
+  surfaceGlass: rgba(244, 242, 238, 0.96)
+  sectionAltBase: "#E4E2DE"
+  sectionAltText: "#1B1D22"
+  sectionAltTextSoft: "#373A40"
+  sectionAltLink: "#7A4D12"
+  sectionAltLinkHover: "#5E3909"
+  sectionAltLinkVisited: "#6A4E5E"
+  sectionAltAccent: "#C0780A"
+  cardBg: "#F8F7F4"
+  cardBorder: "#C9C9C4"
+  cta: "#C0780A"
+  ctaHover: "#C87D14"
+  ctaText: "#17191D"
+  surfaceAlt: "#EFEDE8"
+  textSoftOnDark: rgb(55 58 64 / 0.94)
+  textInverse84: rgb(27 29 34 / 0.84)
+typography:
+  headingFamily: "'Inter', system-ui, sans-serif"
+  bodyFamily: "'Inter', system-ui, sans-serif"
+  monoFamily: "'JetBrains Mono', ui-monospace, monospace"
+  scaleRatio: 1.22
+  baseSize: 17px
+  lineHeightBody: 1.55
+  lineHeightHeading: 1.08
+  measureBody: 66ch
+  measureHeading: 26ch
+  numericFeatures: tnum, lnum
+spacing:
+  base: 8px
+  sectionPaddingY: clamp(56px, 7vw, 104px)
+  containerMaxWidth: 960px
+  gutter: clamp(18px, 3vw, 36px)
+motion:
+  durationFast: 120ms
+  durationMedium: 200ms
+  durationSlow: 360ms
+  easing: cubic-bezier(0.2, 0.0, 0.0, 1.0)
+  reduceMotionRespect: true
+geometry:
+  diagramLineWeight: 1px
+  diagramAccentColor: "#C0780A"
+  decorativeAllowed: false
+shadows:
+  sm: 0 1px 3px rgb(27 29 34 / 0.08)
+  md: 0 10px 24px rgb(27 29 34 / 0.12)
+  lg: 0 18px 44px rgb(27 29 34 / 0.16)
+  xl: 0 34px 72px rgb(27 29 34 / 0.24)
+  glass: 0 14px 34px rgb(27 29 34 / 0.14)
+  glow: 0 0 30px rgb(227 154 36 / 0.26)
+  header: 0 8px 28px rgb(27 29 34 / 0.12)
+  appeal: 0 18px 42px rgb(27 29 34 / 0.16)
+gradients:
+  accent: "linear-gradient(135deg, #D89018 0%, #B07008 100%)"
+  primary: "linear-gradient(135deg, #C0780A 0%, #A06008 100%)"
+  vignetteDark: radial-gradient(circle at center, transparent 0%, rgb(27 29 34 / 0.34) 100%)
+siteBackground:
+  layers:
+    - kind: color
+      color: var(--ds-color-bg)
+    - kind: gradient
+      direction: radial
+      stops:
+        - at: 0
+          color: var(--ds-color-bg)
+          opacity: 0
+        - at: 1
+          color: rgb(27 29 34 / 0.18)
+          opacity: 1
+fonts:
+  - family: Inter
+    package: "@fontsource/inter"
+    weights: [400, 500, 600]
+constraints:
+  forbidStockPhotoTags:
+    - hard-hats
+    - generic-handshake
+    - high-five
+  forbidPhrases:
+    - günstig
+    - von 1 €/Tag
+    - Ergebnis garantiert
+  enforceTabularNumeralsIn:
+    - price
+    - stats

package/src/ontology/biomes/handwerk-material-warm.yaml

@@ -0,0 +1,135 @@
+id: handwerk-material-warm
+version: 1.0.0
+displayName: Handwerk · Concrete Blueprint
+family: handwerk-trust-engineering
+provenance:
+  client: warpgogol-handwerk
+  selectedConcept: concept-2
+  selectedDirection: 2
+  sourceFiles:
+    - 19-visual-dna.md
+    - 21-directions.md
+    - 24-concepts-concept-2.visual.json
+    - 26-localized-concept.webp
+    - 28-tone-of-voice.md
+axes:
+  warmth: warm
+  contrast: high
+  density: airy
+  typographySharpness: sharp
+  diagramPresence: central
+  photoStance: founder-only
+  motionStance: restrained
+  textContrast: aa
+  cornerRadius: 2px
+  borderWeight: 1px
+palette:
+  brand: "#8B5406"
+  brandHover: "#6B4205"
+  brandContrast: "#FFFFFF"
+  accent: "#8B5406"
+  surface: "#F4F2EE"
+  surfaceMuted: "#E4E2DE"
+  ink: "#1B1D22"
+  inkSoft: "#373A40"
+  inkMuted: "#5C646B"
+  divider: "#C9C9C4"
+  success: "#3E7456"
+  warning: "#D9951B"
+  danger: "#A13F35"
+  info: "#516A84"
+components:
+  heroOverlay: linear-gradient(90deg, rgb(244 242 238 / 0.96) 0%, rgb(244 242 238
+    / 0.82) 45%, rgb(244 242 238 / 0) 60%, rgb(244 242 238 / 0) 100%)
+  heroText: "#1B1D22"
+  surfaceGlass: rgba(244, 242, 238, 0.96)
+  sectionAltBase: "#E4E2DE"
+  sectionAltText: "#1B1D22"
+  sectionAltTextSoft: "#373A40"
+  sectionAltLink: "#7A4D12"
+  sectionAltLinkHover: "#5E3909"
+  sectionAltLinkVisited: "#6A4E5E"
+  sectionAltAccent: "#8B5406"
+  cardBg: "#F8F7F4"
+  cardBorder: "#C9C9C4"
+  cta: "#8B5406"
+  ctaHover: "#9D6208"
+  ctaText: "#FFFFFF"
+  surfaceAlt: "#EFEDE8"
+  textSoftOnDark: rgb(55 58 64 / 0.94)
+  textInverse84: rgb(27 29 34 / 0.84)
+typography:
+  headingFamily: "'Playfair Display', Georgia, serif"
+  bodyFamily: "'Inter', system-ui, sans-serif"
+  monoFamily: "'DM Mono', ui-monospace, monospace"
+  scaleRatio: 1.22
+  baseSize: 17px
+  lineHeightBody: 1.55
+  lineHeightHeading: 1.08
+  measureBody: 66ch
+  measureHeading: 26ch
+  numericFeatures: tnum, lnum
+spacing:
+  base: 8px
+  sectionPaddingY: clamp(56px, 7vw, 104px)
+  containerMaxWidth: 960px
+  gutter: clamp(18px, 3vw, 36px)
+motion:
+  durationFast: 120ms
+  durationMedium: 200ms
+  durationSlow: 360ms
+  easing: cubic-bezier(0.2, 0.0, 0.0, 1.0)
+  reduceMotionRespect: true
+geometry:
+  diagramLineWeight: 1px
+  diagramAccentColor: "#8B5406"
+  decorativeAllowed: false
+shadows:
+  sm: 0 1px 3px rgb(27 29 34 / 0.08)
+  md: 0 10px 24px rgb(27 29 34 / 0.12)
+  lg: 0 18px 44px rgb(27 29 34 / 0.16)
+  xl: 0 34px 72px rgb(27 29 34 / 0.24)
+  glass: 0 14px 34px rgb(27 29 34 / 0.14)
+  glow: 0 0 30px rgb(227 154 36 / 0.26)
+  header: 0 8px 28px rgb(27 29 34 / 0.12)
+  appeal: 0 18px 42px rgb(27 29 34 / 0.16)
+gradients:
+  accent: "linear-gradient(135deg, #A0620E 0%, #6B4205 100%)"
+  primary: "linear-gradient(135deg, #8B5406 0%, #6B4205 100%)"
+  vignetteDark: radial-gradient(circle at center, transparent 0%, rgb(27 29 34 / 0.34) 100%)
+siteBackground:
+  layers:
+    - kind: color
+      color: var(--ds-color-bg)
+    - kind: gradient
+      direction: radial
+      stops:
+        - at: 0
+          color: var(--ds-color-bg)
+          opacity: 0
+        - at: 1
+          color: rgb(27 29 34 / 0.18)
+          opacity: 1
+fonts:
+  - family: Inter
+    package: "@fontsource/inter"
+    weights: [400, 500, 600]
+  - family: Playfair Display
+    package: "@fontsource/playfair-display"
+    weights: [400, 700]
+    italicWeights: [400]
+  - family: DM Mono
+    package: "@fontsource/dm-mono"
+    weights: [300, 400, 500]
+constraints:
+  forbidStockPhotoTags:
+    - hard-hats
+    - generic-handshake
+    - high-five
+  forbidPhrases:
+    - günstig
+    - von 1 €/Tag
+    - Ergebnis garantiert
+  enforceTabularNumeralsIn:
+    - price
+    - stats

package/src/ontology/biomes/nonprofit-trust.yaml

@@ -0,0 +1,123 @@
+id: nonprofit-trust
+version: 1.0.0
+displayName: Nonprofit Trust
+family: charity-donation-trust
+axes:
+  warmth: warm
+  contrast: medium
+  density: comfortable
+  typographySharpness: soft
+  diagramPresence: supportive
+  photoStance: documentary
+  motionStance: restrained
+  textContrast: aa
+  cornerRadius: 6px
+  borderWeight: 1px
+palette:
+  brand: "#2D5016"
+  brandHover: "#244112"
+  brandContrast: "#FFFFFF"
+  accent: "#3D7A1A"
+  surface: "#F5F0E8"
+  surfaceMuted: "#ECE4D8"
+  ink: "#2C2C2C"
+  inkSoft: "#4A463F"
+  inkMuted: "#5A5A52"
+  divider: "#D9CFBF"
+  success: "#38A169"
+  warning: "#D97706"
+  danger: "#E53E3E"
+  info: "#2B6CB0"
+components:
+  heroOverlay: rgba(45, 80, 22, 0.6)
+  heroText: "#f7fafc"
+  surfaceGlass: rgba(245, 240, 232, 0.72)
+  sectionAltBase: "#2d5016"
+  sectionAltText: "#f5f0e8"
+  sectionAltTextSoft: "#d4e4c8"
+  sectionAltLink: "#fbb6ce"
+  sectionAltLinkVisited: "#ed64a6"
+  sectionAltLinkHover: "#ffffff"
+  sectionAltAccent: "#4a8c2a"
+  statsBg: "#3a6b1e"
+  footerBg: "#3a3a2a"
+  footerText: "#e8e4dc"
+  footerTextMuted: "#a8a498"
+  cardBg: "#ffffff"
+  cardBorder: rgba(45, 80, 22, 0.1)
+  cta: var(--ds-color-primary)
+  ctaHover: color-mix(in srgb, var(--ds-color-primary), black 30%)
+  ctaText: "#ffffff"
+  surfaceAlt: "#f0ebe3"
+  textSoftOnDark: "rgba(247, 250, 252, 0.84)"
+  textInverse84: "rgba(247, 250, 252, 0.84)"
+typography:
+  headingFamily: "'Lora', Georgia, serif"
+  bodyFamily: "'Inter', system-ui, sans-serif"
+  monoFamily: "'JetBrains Mono', 'Courier New', monospace"
+  scaleRatio: 1.2
+  baseSize: 17px
+  lineHeightBody: 1.6
+  lineHeightHeading: 1.15
+  measureBody: 68ch
+  measureHeading: 24ch
+  numericFeatures: tnum, lnum
+spacing:
+  base: 8px
+  sectionPaddingY: clamp(32px, 7vw, 64px)
+  containerMaxWidth: 1180px
+  containerNarrow: 720px
+  gutter: clamp(16px, 2vw, 32px)
+motion:
+  durationFast: 150ms
+  durationMedium: 240ms
+  durationSlow: 360ms
+  easing: cubic-bezier(0.16, 1, 0.3, 1)
+  reduceMotionRespect: true
+geometry:
+  diagramLineWeight: 1px
+  diagramAccentColor: "#3D7A1A"
+  decorativeAllowed: false
+shadows:
+  sm: 0 2px 8px rgb(26 32 44 / 0.08)
+  md: 0 4px 20px rgb(26 32 44 / 0.12)
+  lg: 0 8px 40px rgb(26 32 44 / 0.16)
+  xl: 0 24px 60px rgb(0 0 0 / 0.35)
+  glass: 0 4px 12px rgb(0 0 0 / 0.06)
+  glow: 0 0 28px rgb(28 69 50 / 0.12)
+  header: 0 6px 24px rgb(0 0 0 / 0.25)
+  appeal: 0 18px 40px rgb(15 23 42 / 0.08)
+gradients:
+  accent: linear-gradient(135deg, rgb(181 76 31) 0%, rgb(212 101 46) 100%)
+  primary: linear-gradient(135deg, rgb(26 67 50) 0%, rgb(45 90 69) 100%)
+  vignetteDark: radial-gradient(circle at center, transparent 0%, rgb(0 0 0 / 0.45) 100%)
+siteBackground:
+  layers:
+    - kind: color
+      color: var(--ds-color-bg)
+    - kind: gradient
+      direction: vertical
+      stops:
+        - at: 0
+          color: var(--ds-color-surface)
+          opacity: 1
+        - at: 1
+          color: var(--ds-color-bg)
+          opacity: 1
+fonts:
+  - family: Inter
+    package: "@fontsource/inter"
+    weights: [400, 500, 600]
+  - family: Lora
+    package: "@fontsource/lora"
+    weights: [400, 500, 600, 700]
+constraints:
+  forbidStockPhotoTags:
+    - crying-child-cliche
+    - generic-volunteer-circle
+  forbidPhrases:
+    - 100% guaranteed impact
+    - donate now or it is too late
+  enforceTabularNumeralsIn:
+    - stats
+    - donation

package/src/ontology/blueprints/offer.yaml

@@ -0,0 +1,39 @@
+# Blueprint: offer (RFC-0239)
+# The owning business's own services at /leistungen/ (de) and /uk/posluhy/ (uk).
+# Mode-polymorphic: Bodenstation = Service/studio; Sternsystem = LocalBusiness/client.
+# Gated by the offer entitlement (RFC-0240).
+id: offer
+entitlement: offer
+
+dataset:
+  collection: offers
+  status: active
+
+axes:
+  - id: offer
+    universe: { collection: offers, field: slug }
+    match: { recordField: slug }
+
+levels:
+  - depth: 0
+    slug: { de: leistungen/uebersicht, uk: posluhy/oglyad }
+    redirectToPageId: services
+    constellation: offer-root
+    geo: full
+    titleTemplate: { de: Leistungen, uk: Послуги }
+  - depth: 1
+    slug: { de: "leistungen/{offer}", uk: "posluhy/{offer}" }
+    constellation: offer-detail
+    geo: full
+    titleTemplate: { de: "{offer.name}", uk: "{offer.name}" }
+
+policy:
+  minRecordsPerDepth: { 0: 0, 1: 1 }
+  redirectPolicy: nearest-ancestor
+  trailingSlash: true
+  substanceMin: 24
+  maxThinShare: 0.6
+
+linking:
+  children: { limit: 12 }
+  siblings: { limit: 8 }

package/src/ontology/blueprints/prompts/local-market-signal.md

@@ -0,0 +1,13 @@
+# Prompt: local-market-signal (RFC-0197)
+
+Reviewed prompt template for the `localMarket` enriched field on the `website-local` Blueprint. Generates one short, location- and industry-specific paragraph of real local-market observation (an "Industry Intelligence / Local Market Signal" block) that raises page substance.
+
+## System
+
+Du schreibst eine kurze, sachliche lokale Marktbeobachtung (2–3 Sätze, max. 160 Tokens) für eine Website-Landingpage. Keine Werbefloskeln, keine erfundenen Zahlen. Beziehe dich konkret auf die Branche und die Stadt. Deutsch.
+
+## User template
+
+Branche: {industry.name} Stadt: {city.name} Lokaler Kontext: {city.localNote}
+
+Schreibe eine lokale Marktbeobachtung für {industry.name}-Betriebe in {city.name}.

package/src/ontology/blueprints/prompts/website-local-narrative.md

@@ -0,0 +1,24 @@
+# Prompt: website-local-narrative (RFC-0207)
+
+Reviewed prompt template for the `narrative` enriched field on the `website-local` Blueprint. Generates one bespoke, grammatically complete page narrative per (industry × city) tuple — the page H1, hero lead, hero tagline, and one short connective "bridge" section. The output replaces the template-glued title and removes the hero/intro duplication. Transcreated natively per language (the system prompt language is the target language — never a word-for-word translation of German).
+
+The output is frozen, stored with provenance + `approved: false`, and renders only after human review. The deterministic build never calls this prompt.
+
+## Output shape
+
+Frontmatter fields on the enriched entry: `h1`, `lead`, `tagline`, and `bridges` (a list of `{ heading, body }`). `h1` and `lead` are required; the baker drops an entry missing either.
+
+## System
+
+Du bist eine erfahrene Marketing-Texterin für lokale Handwerks- und Dienstleistungsbetriebe. Schreibe in der Zielsprache der Seite, grammatikalisch einwandfrei, konkret und ohne Werbefloskeln. Keine erfundenen Zahlen, keine Superlative ohne Beleg. Beziehe dich konkret auf die Branche und die Stadt. Liefere:
+
+- `h1`: eine vollständige, starke Überschrift (kein zusammengesetztes Schlagwort),
+- `lead`: einen Absatz (2–3 Sätze) als Hero-Lead,
+- `tagline`: einen kurzen, eigenständigen Claim (nicht identisch mit dem Lead),
+- `bridges`: einen verbindenden Abschnitt `{ heading, body }`, der Branche und Stadt verknüpft.
+
+## User template
+
+Branche: {industry.name} Stadt: {city.name} Branchen-Kontext: {industry.heroIntro} Lokaler Kontext: {city.localNote} Zielsprache: {lang}
+
+Schreibe das Seiten-Narrativ für {industry.name} in {city.name} in der Zielsprache {lang}.