@warpgogol/werkstatt-shared 0.2.0

package/src/ontology/growth/events/contact-whatsapp-click.yaml

@@ -0,0 +1,21 @@
+# Event: contact.whatsapp_click
+# RFC-0305 / Messkanon
+
+id: contact.whatsapp_click
+label: Contact WhatsApp Click
+description: >
+  A visitor clicked a WhatsApp contact affordance. Payload must identify only
+  the placement, not the target number or visitor.
+
+category: contact
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  placement:
+    type: string
+    description: Stable machine-readable UI placement
+    required: true

package/src/ontology/growth/events/cta-click.yaml

@@ -0,0 +1,30 @@
+# Event: cta-click
+# DNA-27 / RFC-0027
+#
+# Fired when a visitor clicks a call-to-action element.
+# The label field must be a stable machine-readable id (not display text).
+
+id: cta-click
+label: CTA Click
+description: >
+  A visitor clicked a call-to-action button or link. Use stable label values
+  (e.g. "hero-donate", "nav-spenden", "footer-contact") to enable funnel analysis.
+
+category: engagement
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  label:
+    type: string
+    description: >
+      Stable machine-readable id for the CTA (e.g. 'hero-donate', 'nav-spenden').
+      Must not change without a migration — used in funnel definitions.
+    required: true
+  href:
+    type: string
+    description: Absolute or relative href the CTA navigates to
+    required: false

package/src/ontology/growth/events/donation-confirmed.yaml

@@ -0,0 +1,32 @@
+# Event: donation-confirmed
+# DNA-27 / RFC-0027
+
+id: donation-confirmed
+label: Donation Confirmed
+description: >
+  A donation was confirmed by the payment provider or third-party platform.
+  This is the bottom-of-funnel conversion event — the strongest signal.
+  Emit only on confirmed payment, not on form submit.
+
+category: donation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  transactionId:
+    type: string
+    description: >
+      Opaque transaction id from the payment provider (e.g. Betterplace donation id).
+      Must not contain PII. Omit if not accessible from the client.
+    required: false
+  amountCents:
+    type: number
+    description: Confirmed donation amount in the smallest currency unit
+    required: false
+  currency:
+    type: string
+    description: "ISO 4217 currency code (e.g. 'EUR')"
+    required: false

package/src/ontology/growth/events/donation-form-start.yaml

@@ -0,0 +1,21 @@
+# Event: donation-form-start
+# DNA-27 / RFC-0027
+
+id: donation-form-start
+label: Donation Form Start
+description: >
+  A visitor started filling in the donation form (first interaction).
+  Step 2 in the donation funnel.
+
+category: donation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  formId:
+    type: string
+    description: "Stable id of the donation form (e.g. 'betterplace-iframe', 'donation-form')"
+    required: true

package/src/ontology/growth/events/donation-form-submit.yaml

@@ -0,0 +1,29 @@
+# Event: donation-form-submit
+# DNA-27 / RFC-0027
+
+id: donation-form-submit
+label: Donation Form Submit
+description: >
+  A visitor submitted the donation form. Step 3 in the donation funnel.
+  Does not imply payment confirmation — only that the form was submitted.
+
+category: donation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  formId:
+    type: string
+    description: Stable id of the donation form
+    required: true
+  amountCents:
+    type: number
+    description: Donation amount in the smallest currency unit (e.g. cents)
+    required: false
+  currency:
+    type: string
+    description: "ISO 4217 currency code (e.g. 'EUR')"
+    required: false

package/src/ontology/growth/events/donation-intent.yaml

@@ -0,0 +1,29 @@
+# Event: donation-intent
+# DNA-27 / RFC-0027
+#
+# Top-of-funnel signal: visitor expressed intent to donate (clicked a donate CTA,
+# scrolled to the donation section, or opened the donation form page).
+
+id: donation-intent
+label: Donation Intent
+description: >
+  A visitor expressed intent to donate. This is the first step in the donation
+  funnel and is a top-of-funnel conversion signal. Emit when the visitor
+  reaches the donation page or clicks a primary donate CTA.
+
+category: donation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  amountCents:
+    type: number
+    description: Intended donation amount in the smallest currency unit (e.g. cents). 0 or absent if unknown at this stage.
+    required: false
+  currency:
+    type: string
+    description: "ISO 4217 currency code (e.g. 'EUR'). Absent if not yet selected."
+    required: false

package/src/ontology/growth/events/form-error.yaml

@@ -0,0 +1,27 @@
+# Event: form-error
+# DNA-27 / RFC-0027
+
+id: form-error
+label: Form Error
+description: >
+  A form validation error was shown to the visitor. Use errorCode to categorise
+  the failure type for funnel drop-off analysis.
+
+category: engagement
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  formId:
+    type: string
+    description: Stable machine-readable form identifier
+    required: true
+  errorCode:
+    type: string
+    description: >
+      Machine-readable error code (e.g. 'required-field-missing', 'invalid-email',
+      'network-error'). Must not contain PII.
+    required: true

package/src/ontology/growth/events/form-start.yaml

@@ -0,0 +1,21 @@
+# Event: form-start
+# DNA-27 / RFC-0027
+
+id: form-start
+label: Form Start
+description: >
+  A visitor began interacting with a form (first focus or first keystroke).
+  Pair with form-submit and form-error for funnel analysis.
+
+category: engagement
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  formId:
+    type: string
+    description: "Stable machine-readable form identifier (e.g. 'contact-form', 'donation-form')"
+    required: true

package/src/ontology/growth/events/form-submit.yaml

@@ -0,0 +1,21 @@
+# Event: form-submit
+# DNA-27 / RFC-0027
+
+id: form-submit
+label: Form Submit
+description: >
+  A visitor submitted a form successfully (client-side validation passed and the
+  submit button was activated). Does not imply server-side success.
+
+category: engagement
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  formId:
+    type: string
+    description: Stable machine-readable form identifier
+    required: true

package/src/ontology/growth/events/outbound-click.yaml

@@ -0,0 +1,25 @@
+# Event: outbound-click
+# DNA-27 / RFC-0027
+
+id: outbound-click
+label: Outbound Link Click
+description: >
+  A visitor clicked a link that navigates to an external domain.
+  Useful for tracking traffic sent to Betterplace, GlobalGiving, partner sites, etc.
+
+category: navigation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: Active locale
+    required: true
+  href:
+    type: string
+    description: "Full URL the visitor navigated to (e.g. 'https://www.betterplace.org/...')"
+    required: true
+  label:
+    type: string
+    description: Human label of the link as shown to the visitor
+    required: false

package/src/ontology/growth/events/page-view.yaml

@@ -0,0 +1,24 @@
+# Event: page-view
+# DNA-27 / RFC-0027
+#
+# Fired automatically by bootGrowthLayer() after init() resolves.
+# Application code does not emit this event manually.
+
+id: page-view
+label: Page View
+description: >
+  A visitor loaded and rendered a page. Emitted once per page load by
+  bootGrowthLayer(). Not emitted by application code.
+
+category: navigation
+autoEmit: true
+
+payload:
+  locale:
+    type: string
+    description: "Active locale at page load time (e.g. 'de', 'en')"
+    required: true
+  path:
+    type: string
+    description: "Pathname of the page (e.g. '/de/spenden-kontakt')"
+    required: true

package/src/ontology/growth/events/passport-view.yaml

@@ -0,0 +1,28 @@
+# Event: passport-view
+# DNA-27 / RFC-0028
+#
+# Fired when a visitor loads the /cosmic/passport page.
+# Emitted by the PassportHeader (Methone) moon via emit() after render.
+
+id: passport-view
+label: Passport View
+description: >
+  A visitor opened the Cosmic Passport page. Emitted once per page load by
+  the passport-header moon component.
+
+category: navigation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: "Active locale at view time (e.g. 'de', 'en')"
+    required: true
+  appId:
+    type: string
+    description: "The app identifier from the passport (e.g. 'my-app')"
+    required: true
+  nebulaScore:
+    type: number
+    description: "Composite Nebula Score (0-100) from the passport, if available"
+    required: false

package/src/ontology/growth/events/star-map-navigate.yaml

@@ -0,0 +1,30 @@
+# Event: star-map-navigate
+# DNA-27 / RFC-0028
+#
+# Fired when a visitor opens the /cosmic/star-map page or interacts with the
+# embedded star map SVG within the passport page.
+# Emitted by the passport-star-map (Adrastea) moon component.
+
+id: star-map-navigate
+label: Star Map Navigate
+description: >
+  A visitor viewed or interacted with the Cosmic Star Map. Emitted once per
+  page load on the /cosmic/star-map route, or when the inline star map is
+  expanded on the passport page.
+
+category: navigation
+autoEmit: false
+
+payload:
+  locale:
+    type: string
+    description: "Active locale at navigation time (e.g. 'de', 'en')"
+    required: true
+  appId:
+    type: string
+    description: "The app identifier (e.g. 'my-app')"
+    required: true
+  source:
+    type: string
+    description: "Where the map was triggered: 'star-map-page' or 'passport-inline'"
+    required: true

package/src/ontology/index.ts

@@ -0,0 +1,165 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Master barrel for @warpgogol/werkstatt-shared/ontology — re-exports all public APIs from the
+enums, manifest, and cosmic sub-modules so consumers can import from the
+package root or sub-paths.
+</purpose>
+<non-goals>
+  <item>Do not add business logic here — keep as a pure re-export barrel.</item>
+  <item>Do not re-export internal helpers (semver/kebab validators).</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial barrel created as part of Wave 1 (RFC-0023 rollout).</item>
+  <item>Wave 1 (RFC-0025): Added cosmic catalog re-exports (DNA-23).</item>
+</CHANGE_SUMMARY>
+*/
+
+// ---------------------------------------------------------------------------
+// Enums — Layer
+// ---------------------------------------------------------------------------
+export { LayerValues, layerSchema } from "./enums.ts";
+export type { Layer } from "./enums.ts";
+
+// ---------------------------------------------------------------------------
+// Enums — SemanticRole (RFC-0084: open, archetype-derived; type alias only)
+// ---------------------------------------------------------------------------
+export type { SemanticRole } from "./enums.ts";
+
+// ---------------------------------------------------------------------------
+// Enums — ComponentRole
+// ---------------------------------------------------------------------------
+export { ComponentRoleValues, componentRoleSchema } from "./enums.ts";
+export type { ComponentRole } from "./enums.ts";
+
+// ---------------------------------------------------------------------------
+// Enums — Industry
+// ---------------------------------------------------------------------------
+export { IndustryValues, industrySchema, IndustryLabels } from "./enums.ts";
+export type { Industry } from "./enums.ts";
+
+// ---------------------------------------------------------------------------
+// Manifest schema + types
+// ---------------------------------------------------------------------------
+export {
+  KNOWN_INTENTS,
+  pageManifestSchema,
+  sectionManifestSchema,
+  componentManifestSchema,
+  manifestSchema,
+} from "./manifest.ts";
+export type {
+  KnownIntent,
+  PageManifest,
+  SectionManifest,
+  ComponentManifest,
+  Manifest,
+} from "./manifest.ts";
+
+// ---------------------------------------------------------------------------
+// Schemas — Constellation, Biome, SiteFamily, SystemManifest (DNA-23, RFC-0025, RFC-0071)
+// ---------------------------------------------------------------------------
+export {
+  constellationSchema,
+  constellationSlotSchema,
+  biomeSchema,
+  biomeAxesSchema,
+  biomeConstraintsSchema,
+  biomeFontEntrySchema,
+  biomeFontsSchema,
+  biomeGeometrySchema,
+  biomeMotionSchema,
+  biomePaletteSchema,
+  biomeProvenanceSchema,
+  biomeSiteBackgroundSchema,
+  biomeSpacingSchema,
+  biomeTypographySchema,
+  siteFamilySchema,
+  siteFamilyDetectionSchema,
+  siteFamilyRecipeSchema,
+  SiteFamilyContract,
+  sectionArchetypeSchema,
+  systemManifestSchema,
+} from "./schemas/index.ts";
+export type {
+  Constellation,
+  ConstellationSlot,
+  Biome,
+  BiomeAxes,
+  BiomeConstraints,
+  BiomeFontEntry,
+  BiomeFontsConfig,
+  BiomeGeometry,
+  BiomeMotion,
+  BiomePalette,
+  BiomeProvenance,
+  BiomeSiteBackground,
+  BiomeSpacing,
+  BiomeTypography,
+  SiteFamily,
+  SiteFamilyDetection,
+  SiteFamilyRecipe,
+  SectionArchetypeContract,
+  SectionArchetypeId,
+  SectionArchetypeLayoutHint,
+  SystemManifest,
+  SystemPagePin,
+  SystemPlanetPin,
+} from "./schemas/index.ts";
+
+// ---------------------------------------------------------------------------
+// Schemas — PageEntry, BlockEntry (DNA-24, RFC-0026)
+// ---------------------------------------------------------------------------
+export { PageEntrySchema, BlockEntrySchema } from "./schemas/index.ts";
+export type { PageEntry, BlockEntry } from "./schemas/index.ts";
+// getSectionPropsSchema is NOT re-exported from the root barrel — it imports
+// node:fs/promises. Import from @warpgogol/werkstatt-shared/ontology/schemas/manifest-resolver.
+
+// ---------------------------------------------------------------------------
+// Schemas — Capability catalog (RFC-0288)
+// ---------------------------------------------------------------------------
+export { capabilityInputOutputSchema, capabilityRecordSchema } from "./schemas/index.ts";
+export type { CapabilityInputOutputSchema, CapabilityRecord } from "./schemas/index.ts";
+
+// ---------------------------------------------------------------------------
+// Shared section props fragments (RFC-0101, RFC-0102, RFC-0103)
+// ---------------------------------------------------------------------------
+export {
+  SHARED_SECTION_PROPS,
+  isSharedSectionPropsId,
+  composeManifestPropsSchema,
+  sharedSectionPropsChangelog,
+} from "./shared-section-props/index.ts";
+export type {
+  JsonSchemaFragment,
+  SharedSectionPropsId,
+  SharedSectionPropsRef,
+} from "./shared-section-props/index.ts";
+
+// ---------------------------------------------------------------------------
+// Cosmic catalogs (DNA-23, RFC-0025)
+// ---------------------------------------------------------------------------
+export {
+  StarCatalog,
+  starNameSchema,
+  PlanetCatalog,
+  planetNameSchema,
+  MoonCatalog,
+  moonNameSchema,
+  cosmicNameSchema,
+} from "./cosmic/index.ts";
+export type { StarName, PlanetName, MoonName, CosmicName } from "./cosmic/index.ts";
+
+// ---------------------------------------------------------------------------
+// Biome token projection (RFC-0071 consolidated mapping)
+// ---------------------------------------------------------------------------
+export {
+  BIOME_TO_TOKEN_MAP,
+  BIOME_TOKEN_ALIASES,
+  BIOME_TOKEN_DERIVED,
+  getBiomeField,
+  projectBiomeToTokens,
+  getAllProjectedTokenNames,
+} from "./biome-token-projection.ts";
+export type { BiomeTokenAlias, BiomeTokenDerived } from "./biome-token-projection.ts";