@dealsystem/site 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (182) hide show
  1. package/README.md +145 -2
  2. package/agent-files/claude/skills/angebote-einbauen/SKILL.md +30 -0
  3. package/agent-files/claude/skills/bild-einbauen/SKILL.md +43 -0
  4. package/agent-files/claude/skills/domain-verbinden/SKILL.md +23 -0
  5. package/agent-files/claude/skills/extern-einbinden/SKILL.md +37 -0
  6. package/agent-files/claude/skills/formular-anbinden/SKILL.md +34 -0
  7. package/agent-files/claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
  8. package/agent-files/claude/skills/funnel-mehrstufig/SKILL.md +101 -0
  9. package/agent-files/claude/skills/neue-seite/SKILL.md +47 -0
  10. package/agent-files/claude/skills/prueffehler-beheben/SKILL.md +31 -0
  11. package/agent-files/claude/skills/termin-buchung/SKILL.md +51 -0
  12. package/agent-files/claude/skills/veroeffentlichen/SKILL.md +32 -0
  13. package/agent-files/cursor/rules/dealsystem.mdc +7 -0
  14. package/agent-files/manifest.json +93 -0
  15. package/contract/README.md +41 -0
  16. package/contract/ds-content.v1.json +2355 -0
  17. package/contract/external-presets.v1.json +65 -0
  18. package/contract/funnel-code-config.md +87 -0
  19. package/contract/site-api.v1.json +3916 -0
  20. package/dist/client/altcha-workers.d.ts +10 -0
  21. package/dist/client/attribution.d.ts +119 -0
  22. package/dist/client/attribution.js +341 -0
  23. package/dist/client/bookingClient.svelte.d.ts +166 -0
  24. package/dist/client/bookingClient.svelte.js +369 -0
  25. package/dist/client/bookingTime.d.ts +46 -0
  26. package/dist/client/bookingTime.js +109 -0
  27. package/dist/client/captcha.d.ts +26 -0
  28. package/dist/client/captcha.js +71 -0
  29. package/dist/client/captchaSession.d.ts +21 -0
  30. package/dist/client/captchaSession.js +105 -0
  31. package/dist/client/collections.d.ts +34 -0
  32. package/dist/client/collections.js +40 -0
  33. package/dist/client/externalScript.d.ts +20 -0
  34. package/dist/client/externalScript.js +36 -0
  35. package/dist/client/funnelState.svelte.d.ts +47 -0
  36. package/dist/client/funnelState.svelte.js +81 -0
  37. package/dist/client/leadClient.svelte.d.ts +131 -0
  38. package/dist/client/leadClient.svelte.js +250 -0
  39. package/dist/client/pageview.d.ts +7 -0
  40. package/dist/client/pageview.js +44 -0
  41. package/dist/client/siteApi.d.ts +211 -0
  42. package/dist/client/siteApi.js +320 -0
  43. package/dist/client/tracking.d.ts +18 -0
  44. package/dist/client/tracking.js +93 -0
  45. package/dist/client/validation.d.ts +10 -0
  46. package/dist/client/validation.js +66 -0
  47. package/dist/components/Booker.svelte +729 -0
  48. package/dist/components/Booker.svelte.d.ts +42 -0
  49. package/dist/components/CollectionList.svelte +122 -0
  50. package/dist/components/CollectionList.svelte.d.ts +65 -0
  51. package/dist/components/ConsentGate.svelte +68 -0
  52. package/dist/components/ConsentGate.svelte.d.ts +44 -0
  53. package/dist/components/CookieBanner.svelte +303 -0
  54. package/dist/components/CookieBanner.svelte.d.ts +29 -0
  55. package/dist/components/Datenschutz.svelte +84 -0
  56. package/dist/components/Datenschutz.svelte.d.ts +26 -0
  57. package/dist/components/Embed.svelte +263 -0
  58. package/dist/components/Embed.svelte.d.ts +41 -0
  59. package/dist/components/ExternalScript.svelte +94 -0
  60. package/dist/components/ExternalScript.svelte.d.ts +41 -0
  61. package/dist/components/Impressum.svelte +59 -0
  62. package/dist/components/Impressum.svelte.d.ts +25 -0
  63. package/dist/components/LeadForm.svelte +475 -0
  64. package/dist/components/LeadForm.svelte.d.ts +35 -0
  65. package/dist/components/LeadHoneypot.svelte +43 -0
  66. package/dist/components/LeadHoneypot.svelte.d.ts +18 -0
  67. package/dist/components/Link.svelte +48 -0
  68. package/dist/components/Link.svelte.d.ts +30 -0
  69. package/dist/components/MapEmbed.svelte +154 -0
  70. package/dist/components/MapEmbed.svelte.d.ts +28 -0
  71. package/dist/components/MediaImage.svelte +218 -0
  72. package/dist/components/MediaImage.svelte.d.ts +128 -0
  73. package/dist/components/MediaVideo.svelte +103 -0
  74. package/dist/components/MediaVideo.svelte.d.ts +20 -0
  75. package/dist/components/RichText.svelte +105 -0
  76. package/dist/components/RichText.svelte.d.ts +55 -0
  77. package/dist/components/Seo.svelte +89 -0
  78. package/dist/components/Seo.svelte.d.ts +45 -0
  79. package/dist/components/SiteFooterLegal.svelte +75 -0
  80. package/dist/components/SiteFooterLegal.svelte.d.ts +22 -0
  81. package/dist/components/SiteHead.svelte +79 -0
  82. package/dist/components/SiteHead.svelte.d.ts +32 -0
  83. package/dist/components/Text.svelte +100 -0
  84. package/dist/components/Text.svelte.d.ts +55 -0
  85. package/dist/components/Tracking.svelte +30 -0
  86. package/dist/components/Tracking.svelte.d.ts +14 -0
  87. package/dist/components/Zeitfenster.svelte +92 -0
  88. package/dist/components/Zeitfenster.svelte.d.ts +34 -0
  89. package/dist/components/legal.d.ts +12 -0
  90. package/dist/components/legal.js +27 -0
  91. package/dist/config/index.d.ts +121 -0
  92. package/dist/config/index.js +602 -0
  93. package/dist/config/static/index.d.ts +3 -0
  94. package/dist/config/static/index.js +5 -0
  95. package/dist/config/static/lines.d.ts +9 -0
  96. package/dist/config/static/lines.js +22 -0
  97. package/dist/config/static/literal.d.ts +45 -0
  98. package/dist/config/static/literal.js +175 -0
  99. package/dist/config/static/siteConfig.d.ts +39 -0
  100. package/dist/config/static/siteConfig.js +150 -0
  101. package/dist/consent/consent.svelte.d.ts +91 -0
  102. package/dist/consent/consent.svelte.js +221 -0
  103. package/dist/content/index.d.ts +123 -0
  104. package/dist/content/index.js +247 -0
  105. package/dist/contentBlock.d.ts +45 -0
  106. package/dist/contentBlock.js +78 -0
  107. package/dist/csp/index.d.ts +27 -0
  108. package/dist/csp/index.js +74 -0
  109. package/dist/external/csp.d.ts +25 -0
  110. package/dist/external/csp.js +104 -0
  111. package/dist/external/hosts.d.ts +30 -0
  112. package/dist/external/hosts.js +128 -0
  113. package/dist/external/presets.d.ts +54 -0
  114. package/dist/external/presets.js +212 -0
  115. package/dist/external/resolve.d.ts +39 -0
  116. package/dist/external/resolve.js +254 -0
  117. package/dist/index.d.ts +32 -0
  118. package/dist/index.js +32 -0
  119. package/dist/internal/consentNeed.d.ts +21 -0
  120. package/dist/internal/consentNeed.js +50 -0
  121. package/dist/internal/dealsystem-legal-imprint.d.ts +2 -0
  122. package/dist/internal/dealsystem-legal-imprint.js +5 -0
  123. package/dist/internal/dealsystem-legal-privacy.d.ts +2 -0
  124. package/dist/internal/dealsystem-legal-privacy.js +5 -0
  125. package/dist/internal/dealsystem-site-data.d.ts +3 -0
  126. package/dist/internal/dealsystem-site-data.js +2 -0
  127. package/dist/internal/imprint.d.ts +4 -0
  128. package/dist/internal/imprint.js +10 -0
  129. package/dist/internal/mediaImage.d.ts +15 -0
  130. package/dist/internal/mediaImage.js +22 -0
  131. package/dist/internal/privacy.d.ts +4 -0
  132. package/dist/internal/privacy.js +10 -0
  133. package/dist/internal/providers.d.ts +9 -0
  134. package/dist/internal/providers.js +44 -0
  135. package/dist/internal/reload.d.ts +2 -0
  136. package/dist/internal/reload.js +5 -0
  137. package/dist/internal/seo.d.ts +41 -0
  138. package/dist/internal/seo.js +79 -0
  139. package/dist/internal/siteData.d.ts +7 -0
  140. package/dist/internal/siteData.js +39 -0
  141. package/dist/internal/usage.d.ts +7 -0
  142. package/dist/internal/usage.js +13 -0
  143. package/dist/keys.d.ts +20 -0
  144. package/dist/keys.js +58 -0
  145. package/dist/leadmagnet.d.ts +16 -0
  146. package/dist/leadmagnet.js +28 -0
  147. package/dist/paths.d.ts +8 -0
  148. package/dist/paths.js +9 -0
  149. package/dist/richtext/escape.d.ts +4 -0
  150. package/dist/richtext/escape.js +18 -0
  151. package/dist/richtext/server.d.ts +16 -0
  152. package/dist/richtext/server.js +123 -0
  153. package/dist/schedule.d.ts +23 -0
  154. package/dist/schedule.js +67 -0
  155. package/dist/slots.d.ts +9 -0
  156. package/dist/slots.js +38 -0
  157. package/dist/snapshot.d.ts +14 -0
  158. package/dist/snapshot.js +214 -0
  159. package/dist/types.d.ts +550 -0
  160. package/dist/types.js +4 -0
  161. package/dist/version.d.ts +2 -0
  162. package/dist/version.js +2 -0
  163. package/dist/vite/index.d.ts +85 -0
  164. package/dist/vite/index.js +641 -0
  165. package/dist/vite/scan.d.ts +47 -0
  166. package/dist/vite/scan.js +355 -0
  167. package/dist/vite/zeitfenster.d.ts +18 -0
  168. package/dist/vite/zeitfenster.js +76 -0
  169. package/docs/ablauf.md +167 -0
  170. package/docs/agents-block.md +100 -0
  171. package/docs/befehle.md +103 -0
  172. package/docs/extern.md +143 -0
  173. package/docs/gestaltung.md +139 -0
  174. package/docs/inhalte.md +224 -0
  175. package/docs/komponenten.md +1273 -0
  176. package/docs/konfiguration.md +310 -0
  177. package/docs/llms.txt +19 -0
  178. package/docs/rechtstexte.md +84 -0
  179. package/docs/regeln.md +108 -0
  180. package/docs/seo.md +55 -0
  181. package/docs/termine.md +73 -0
  182. package/package.json +115 -5
@@ -0,0 +1,1273 @@
1
+ <!-- Erzeugt von scripts/build-agent-docs.mjs. Nicht von Hand ändern. -->
2
+
3
+ # Bausteine von @dealsystem/site 0.2.0
4
+
5
+ Alle Bausteine kommen aus einem Import: `import { … } from '@dealsystem/site'`.
6
+ Pflichtangaben sind im Typ ohne `?` notiert; fehlt eine, meldet `npm run check` einen Fehler.
7
+
8
+ ## Text
9
+
10
+ Ein kurzer Text (Überschrift, Satz, Beschriftung), den der Kunde im CRM ändern
11
+ kann.
12
+ Angezeigt wird der Text aus dem CRM, sonst `default`.
13
+
14
+ `key` und `default` müssen feste Zeichenketten sein (keine Variablen): der
15
+ Build liest sie aus dem Quelltext und meldet sie ans CRM.
16
+
17
+ `key` hat zwei bis fünf Teile mit Punkten. Der erste Teil, meist die Seite,
18
+ besteht nur aus Kleinbuchstaben und Ziffern, ohne Bindestrich: für die Seite
19
+ `/ueber-uns` also `ueberuns.team.titel`, nicht `ueber-uns.team.titel`. Die
20
+ weiteren Teile dürfen Bindestriche haben (`start.ueber-uns`). Das gilt für alle
21
+ Schlüssel von `<Text>`, `<RichText>`, `<Link>` und `<MediaImage>`.
22
+
23
+ ```svelte
24
+ <Text key="start.hero.titel" default="Wir kaufen Ihr Haus" as="h1" label="Überschrift" group="Startseite" />
25
+ ```
26
+
27
+ Mehrere Zeilen: `multiline` und den Text in geschweiften Klammern, dann ist
28
+ `\n` ein Zeilenumbruch. In `default="…"` wäre `\n` kein Umbruch, sondern
29
+ stünde wörtlich auf der Seite (`dealsystem check` warnt, CNT-003).
30
+
31
+ ```svelte
32
+ <Text key="kontakt.zeiten" multiline default={'Mo bis Fr 9 bis 18 Uhr\nSa nach Vereinbarung'} />
33
+ ```
34
+
35
+ Eigenschaften:
36
+
37
+ ```ts
38
+ /** HTML-Elemente, die `<Text>` ausgeben kann. */
39
+ export type TextElement =
40
+ | 'span'
41
+ | 'p'
42
+ | 'h1'
43
+ | 'h2'
44
+ | 'h3'
45
+ | 'h4'
46
+ | 'h5'
47
+ | 'h6'
48
+ | 'strong'
49
+ | 'em'
50
+ | 'small'
51
+ | 'div'
52
+ | 'li'
53
+ | 'blockquote'
54
+ | 'figcaption'
55
+ | 'dt'
56
+ | 'dd';
57
+
58
+ export interface TextProps {
59
+ /** Eindeutiger Schlüssel, z. B. `start.hero.titel`: Teile mit Punkten, der erste ohne Bindestrich (`ueberuns.team.titel`). */
60
+ key: string;
61
+ /** Text, solange im CRM nichts anderes eingetragen ist. */
62
+ default: string;
63
+ /** HTML-Element. Standard `span`. Je Seite genau eine `h1`. */
64
+ as?: TextElement;
65
+ /** Mehrzeiliger Text: Zeilenumbrüche bleiben erhalten. */
66
+ multiline?: boolean;
67
+ /** Beschriftung im CRM, z. B. „Überschrift“. */
68
+ label?: string;
69
+ /** Gruppe im CRM, z. B. „Startseite“. */
70
+ group?: string;
71
+ /** Hinweis für den Kunden im CRM. */
72
+ help?: string;
73
+ /** Höchstlänge im CRM. */
74
+ maxLength?: number;
75
+ /** Der Kunde darf den Text im CRM nicht leeren. */
76
+ required?: boolean;
77
+ /** Frühere Schlüssel dieses Textes, damit Änderungen des Kunden beim Umbenennen bleiben. */
78
+ aliases?: readonly string[];
79
+ class?: string;
80
+ id?: string;
81
+ }
82
+ ```
83
+
84
+ ## RichText
85
+
86
+ Formatierter Text: Absätze, Überschriften, Listen, Links. Das ist die einzige
87
+ Stelle, an der HTML aus dem CRM ausgegeben wird. `{@html}` schreibt die Seite nie.
88
+
89
+ Als Text, den der Kunde im CRM ändern kann (`key` und `default` als feste
90
+ Zeichenketten):
91
+
92
+ ```svelte
93
+ <RichText key="start.ueber-uns" default="Wir sind **seit 2010** in Leipzig tätig." />
94
+ ```
95
+
96
+ Liste oder mehrere Absätze: den Text in geschweifte Klammern, dann ist `\n`
97
+ ein Zeilenumbruch und `\n\n` ein neuer Absatz. In `default="…"` stünde `\n`
98
+ wörtlich auf der Seite (`dealsystem check` warnt, CNT-003).
99
+
100
+ ```svelte
101
+ <RichText
102
+ key="ankauf.ablauf"
103
+ default={'1. Sie schicken uns die Eckdaten.\n2. Wir prüfen und melden uns.\n3. Sie erhalten ein Angebot.\n\nDer Ablauf ist für Sie kostenlos.'}
104
+ />
105
+ ```
106
+
107
+ Für ein Richtext-Feld eines CMS-Eintrags:
108
+
109
+ ```svelte
110
+ <RichText content={angebot.data.beschreibung} />
111
+ ```
112
+
113
+ Eigenschaften:
114
+
115
+ ```ts
116
+ export type RichTextProps = { class?: string } & (
117
+ | {
118
+ /** Eindeutiger Schlüssel, z. B. `start.ueber-uns`. */
119
+ key: string;
120
+ /** Markdown, solange im CRM nichts anderes eingetragen ist. */
121
+ default: string;
122
+ /** Beschriftung im CRM. */
123
+ label?: string;
124
+ /** Gruppe im CRM. */
125
+ group?: string;
126
+ /** Hinweis für den Kunden im CRM. */
127
+ help?: string;
128
+ /** Der Kunde darf den Text im CRM nicht leeren. */
129
+ required?: boolean;
130
+ /** Frühere Schlüssel dieses Textes. */
131
+ aliases?: readonly string[];
132
+ content?: undefined;
133
+ }
134
+ | {
135
+ /** Richtext-Feld eines Eintrags aus `getCollection()`, `getEntry()` oder `loadCollection()`. */
136
+ content: SafeHtml | null | undefined;
137
+ key?: undefined;
138
+ }
139
+ );
140
+ ```
141
+
142
+ ## Link
143
+
144
+ Ein Link, dessen Ziel und Beschriftung der Kunde im CRM ändern kann. Gedacht
145
+ z. B. für die wichtigste Schaltfläche der Startseite; für gewöhnliche Links
146
+ reicht `<a href>`.
147
+
148
+ `key` und `default` müssen fest im Quelltext stehen (keine Variablen).
149
+
150
+ ```svelte
151
+ <Link key="start.hero.knopf" default={{ href: '/kontakt', label: 'Kontakt aufnehmen' }} label="Schaltfläche" group="Startseite" />
152
+ ```
153
+
154
+ Eigenschaften:
155
+
156
+ ```ts
157
+ export interface LinkProps {
158
+ /** Eindeutiger Schlüssel, z. B. `start.hero.knopf`. */
159
+ key: string;
160
+ /** Ziel und Beschriftung, solange im CRM nichts anderes eingetragen ist. */
161
+ default: ContentSlotLinkValue;
162
+ /** Beschriftung im CRM. */
163
+ label?: string;
164
+ /** Gruppe im CRM. */
165
+ group?: string;
166
+ /** Hinweis für den Kunden im CRM. */
167
+ help?: string;
168
+ /** Frühere Schlüssel dieses Links. */
169
+ aliases?: readonly string[];
170
+ class?: string;
171
+ }
172
+ ```
173
+
174
+ ## MediaImage
175
+
176
+ Ein Bild, immer mit Alternativtext. `<img>` wird auf der Seite nie direkt
177
+ geschrieben, immer `<MediaImage>`.
178
+ `alt` beschreibt, was auf dem Bild zu sehen ist. Nur bei reinem Schmuck:
179
+ `alt="" decorative`.
180
+
181
+ Lokales Bild (`width` und `height` sind die echten Maße der Datei):
182
+
183
+ ```svelte
184
+ <script lang="ts">
185
+ import { MediaImage } from '@dealsystem/site';
186
+ import heroBild from '$lib/assets/bilder/hero.jpg';
187
+ </script>
188
+
189
+ <MediaImage src={heroBild} alt="Sanierter Altbau in Leipzig" width={1600} height={1067} sizes="100vw" priority />
190
+ ```
191
+
192
+ Bild aus dem CMS (der Alternativtext kommt aus dem CMS):
193
+
194
+ ```svelte
195
+ <MediaImage media={angebot.media.bilder[0]} sizes="(min-width: 800px) 50vw, 100vw" />
196
+ ```
197
+
198
+ Bild, das der Kunde selbst austauschen kann (Porträt, Team, Titelbild): mit
199
+ `key` und `default`. Nach dem Hochladen tauscht er es im CRM unter Eigene
200
+ Website → Inhalte. `key`, `label`, `group` und `help` müssen feste
201
+ Zeichenketten in Anführungszeichen sein; mit einer Variablen scheitern Build
202
+ und `dealsystem check` (QUA-006). `default` ist das Bild aus dem Projekt:
203
+ ein Import (wie unten) oder ein Pfad unter `static/` (`default="/bilder/haus.jpg"`).
204
+ Dann zeigt das CRM es als Vorschau; bei `?enhanced` oder einer Variablen nicht.
205
+
206
+ ```svelte
207
+ <script lang="ts">
208
+ import { MediaImage } from '@dealsystem/site';
209
+ import portrait from '$lib/assets/bilder/inhaber.jpg';
210
+ </script>
211
+
212
+ <MediaImage
213
+ key="team.inhaber.foto"
214
+ default={portrait}
215
+ width={1200}
216
+ height={1500}
217
+ alt="Porträt des Inhabers vor dem Büro"
218
+ label="Foto des Inhabers"
219
+ group="Über uns"
220
+ help="Hochformat, am besten mit Gesicht in der Mitte."
221
+ sizes="(min-width: 60rem) 33vw, 100vw"
222
+ />
223
+ ```
224
+
225
+ Eigenschaften:
226
+
227
+ ```ts
228
+ /** Ein leerer Alternativtext ist nur zusammen mit `decorative` erlaubt. */
229
+ type DescribingAlt<A extends string> = A extends ''
230
+ ? 'Fehler: alt darf nicht leer sein. Beschreibe das Bild, oder setze alt="" zusammen mit decorative.'
231
+ : A;
232
+
233
+ type AltProps<A extends string> =
234
+ | {
235
+ /** Beschreibt das Bild für Menschen, die es nicht sehen. */
236
+ alt: DescribingAlt<A>;
237
+ decorative?: false;
238
+ }
239
+ | {
240
+ alt: '';
241
+ /** Reiner Schmuck: Vorleseprogramme überspringen das Bild. */
242
+ decorative: true;
243
+ };
244
+
245
+ interface CommonProps {
246
+ /** Anzeigebreite für die Auswahl der Bildgröße, z. B. `(min-width: 800px) 50vw, 100vw`. Standard `100vw`. */
247
+ sizes?: string;
248
+ /** Für das wichtigste Bild im sichtbaren Bereich: wird sofort geladen. */
249
+ priority?: boolean;
250
+ class?: string;
251
+ }
252
+
253
+ export type MediaImageProps<A extends string = string> = CommonProps &
254
+ (
255
+ | ({
256
+ /** Lokales Bild: Import mit `?enhanced` oder Pfad aus `static/`. */
257
+ src: EnhancedPicture | string;
258
+ /** Breite in Pixeln. Nur nötig, wenn `src` ein Pfad ist. */
259
+ width?: number;
260
+ /** Höhe in Pixeln. Nur nötig, wenn `src` ein Pfad ist. */
261
+ height?: number;
262
+ key?: undefined;
263
+ media?: undefined;
264
+ } & AltProps<A>)
265
+ | ({
266
+ /** Schlüssel des Bild-Slots, z. B. `start.hero.bild`. */
267
+ key: string;
268
+ /** Bild, solange im CRM kein anderes gewählt ist. */
269
+ default: EnhancedPicture | string;
270
+ width?: number;
271
+ height?: number;
272
+ /** Beschriftung im CRM. */
273
+ label?: string;
274
+ /** Gruppe im CRM. */
275
+ group?: string;
276
+ /** Hinweis für den Kunden im CRM. */
277
+ help?: string;
278
+ /** Frühere Schlüssel dieses Bildes. */
279
+ aliases?: readonly string[];
280
+ src?: undefined;
281
+ media?: undefined;
282
+ } & AltProps<A>)
283
+ | {
284
+ /** Bild aus einem CMS-Eintrag. Fehlt es, wird nichts ausgegeben. */
285
+ media: MediaRef | null | undefined;
286
+ /** Ersetzt den Alternativtext aus dem CMS. */
287
+ alt?: string;
288
+ decorative?: boolean;
289
+ src?: undefined;
290
+ key?: undefined;
291
+ }
292
+ );
293
+ ```
294
+
295
+ ## MediaVideo
296
+
297
+ Ein Video aus dem CMS, mit Bedienelementen und ohne automatischen Start.
298
+ `title` benennt das Video für Vorleseprogramme. Kommt das Video von einem
299
+ anderen Anbieter, wird es erst nach der Einwilligung „Externe Inhalte“ geladen.
300
+
301
+ ```svelte
302
+ <MediaVideo media={angebot.media.video[0]} title="Rundgang durch die Wohnung" />
303
+ ```
304
+
305
+ Eigenschaften:
306
+
307
+ ```ts
308
+ export interface MediaVideoProps {
309
+ /** Video aus einem CMS-Eintrag. Fehlt es, wird nichts ausgegeben. */
310
+ media: MediaRef | null | undefined;
311
+ /** Kurzer Name des Videos, z. B. „Rundgang“. */
312
+ title: string;
313
+ class?: string;
314
+ }
315
+ ```
316
+
317
+ ## LeadForm
318
+
319
+ Ein Formular aus `dealsystem.config.ts`. Die Felder, Beschriftungen,
320
+ Fehlermeldungen, der Spam-Schutz und der Versand an das CRM sind eingebaut.
321
+ Schreibe kein eigenes `<form>` und kein eigenes `fetch`.
322
+
323
+ ```svelte
324
+ <LeadForm funnel="kontakt" submitLabel="Anfrage senden" successMessage="Danke, wir melden uns." />
325
+ ```
326
+
327
+ Neue Felder trägst du in `dealsystem.config.ts` unter `funnels.<schlüssel>.fields` ein.
328
+ Farben und Rundungen steuerst du mit CSS-Variablen, z. B. `--ds-color-primary`.
329
+
330
+ Eigenschaften:
331
+
332
+ ```ts
333
+ export interface LeadFormProps {
334
+ /** Schlüssel des Formulars aus `dealsystem.config.ts`, z. B. `kontakt`. */
335
+ funnel: FunnelKey;
336
+ /** Text der Schaltfläche. Standard „Absenden“. */
337
+ submitLabel?: string;
338
+ /**
339
+ * Text nach erfolgreichem Versand. Standard „Vielen Dank. Ihre Anfrage ist bei uns angekommen.“; verspricht
340
+ * das Formular eine Datei (`leadmagnet`), kündigt der Standard sie per E-Mail an.
341
+ */
342
+ successMessage?: string;
343
+ /** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
344
+ privacyHref?: string;
345
+ /** Eigene Anzeige nach erfolgreichem Versand, statt `successMessage`. */
346
+ success?: Snippet;
347
+ /** Wird nach erfolgreichem Versand aufgerufen, z. B. für eine Weiterleitung. */
348
+ onsuccess?: () => void;
349
+ class?: string;
350
+ }
351
+
352
+ type AutoFill =
353
+ 'given-name' | 'family-name' | 'email' | 'tel' | 'address-line1' | 'postal-code' | 'address-level2';
354
+ ```
355
+
356
+ ## LeadHoneypot
357
+
358
+ Bot-Falle für ein Formular mit `createLeadClient()`: ein Feld, das Menschen nicht
359
+ sehen und nicht erreichen. Füllt ein Programm es aus, nimmt DealSystem die
360
+ Anfrage still nicht an. Gehört einmal in die eigene Oberfläche, am besten in
361
+ das `<form>`. `<LeadForm>` bringt es schon mit.
362
+
363
+ ```svelte
364
+ <LeadHoneypot client={lead} />
365
+ ```
366
+
367
+ Eigenschaften:
368
+
369
+ ```ts
370
+ export interface LeadHoneypotProps {
371
+ /** Der Client aus `createLeadClient()`. */
372
+ client: Pick<LeadClient, 'setHoneypot'>;
373
+ }
374
+ ```
375
+
376
+ ## Booker
377
+
378
+ Terminbuchung auf der Seite: Tag wählen, Uhrzeit wählen, Angaben, Bestätigung. Die freien Zeiten,
379
+ Buchungsfragen, der Spam-Schutz und die Buchung im CRM sind eingebaut. Kein iframe, kein eigenes `fetch`.
380
+
381
+ ```svelte
382
+ <Booker booking="erstgespraech" />
383
+ ```
384
+
385
+ Den Schlüssel trägst du in `dealsystem.config.ts` unter `booking` ein. Die Terminart (Dauer, Arbeitszeiten,
386
+ Fragen) richtet der Kunde im CRM unter Termine ein; erfinde keine. Zeiten erscheinen in der Zeitzone des
387
+ Besuchers, die des Kalenders steht als Hinweis dabei. Farben und Rundungen wie bei `<LeadForm>` über
388
+ CSS-Variablen, z. B. `--ds-color-primary`.
389
+
390
+ Eigenschaften:
391
+
392
+ ```ts
393
+ export interface BookerProps {
394
+ /** Schlüssel aus `booking` in `dealsystem.config.ts`, z. B. `erstgespraech`. */
395
+ booking: BookingKey;
396
+ /** So viele Tage zeigt der erste Abruf, Standard 14 (höchstens 31). „Weitere Termine“ lädt nach. */
397
+ days?: number;
398
+ /** Ebene der Schritt-Überschriften, Standard 2. */
399
+ headingLevel?: 2 | 3 | 4;
400
+ /** Text der Schaltfläche. Standard „Termin buchen“. */
401
+ submitLabel?: string;
402
+ /** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
403
+ privacyHref?: string;
404
+ /** Eigene Anzeige nach der Buchung; bekommt Datum und Uhrzeit als Text. */
405
+ success?: Snippet<[{ when: string; dryRun: boolean }]>;
406
+ /** Wird nach der Buchung aufgerufen. */
407
+ onbooked?: (booked: { start: string; end: string | null; dryRun: boolean }) => void;
408
+ class?: string;
409
+ }
410
+ ```
411
+
412
+ ## CollectionList
413
+
414
+ Liste der Einträge einer Sammlung. Das Snippet `item` bestimmt, wie ein
415
+ Eintrag aussieht.
416
+
417
+ Empfohlen: Einträge beim Build laden und übergeben. Dann stehen sie im
418
+ fertigen HTML und Suchmaschinen sehen sie.
419
+
420
+ ```svelte
421
+ <script lang="ts">
422
+ import { CollectionList, MediaImage } from '@dealsystem/site';
423
+ let { data } = $props(); // aus +page.server.ts: { angebote: await getCollection('angebote') }
424
+ </script>
425
+
426
+ <CollectionList collection="angebote" entries={data.angebote} limit={12}>
427
+ {#snippet item(angebot)}
428
+ <a href="/angebote/{angebot.slug}">
429
+ <MediaImage media={angebot.media.bilder[0]} sizes="33vw" />
430
+ {angebot.data.titel}
431
+ </a>
432
+ {/snippet}
433
+ </CollectionList>
434
+ ```
435
+
436
+ Ohne `entries` lädt die Liste die Einträge erst im Browser über die Site-API:
437
+ ohne `limit` die neuesten 20, mit `limit` bis zu 100.
438
+
439
+ Eigenschaften:
440
+
441
+ ```ts
442
+ export interface CollectionListProps<K extends CollectionKey> {
443
+ /** Schlüssel der Sammlung aus `dealsystem.config.ts`. */
444
+ collection: K;
445
+ /** Einträge aus `getCollection()`. Ohne Angabe wird im Browser geladen. */
446
+ entries?: CollectionEntry<K>[];
447
+ /** Höchstzahl der angezeigten Einträge. */
448
+ limit?: number;
449
+ /** Darstellung eines Eintrags. */
450
+ item: Snippet<[CollectionEntry<K>]>;
451
+ /** Anzeige, wenn es keine Einträge gibt. */
452
+ empty?: Snippet;
453
+ class?: string;
454
+ }
455
+ ```
456
+
457
+ ## MapEmbed
458
+
459
+ Eine Karte von OpenStreetMap mit einer Markierung, z. B. für die Anfahrt. Sie
460
+ braucht keinen Eintrag unter `external`. Google Maps geht über `<Embed>` mit
461
+ der Vorlage `google-maps`. Die Karte lädt erst, wenn der Besucher zustimmt; vorher steht
462
+ dort ein Hinweis mit der Schaltfläche „Karte anzeigen“. Der Link „Karte in
463
+ OpenStreetMap öffnen“ funktioniert immer.
464
+
465
+ `lat` und `lon` sind die Koordinaten des Ortes als Dezimalzahlen. Kennst du sie
466
+ nicht, frag den Kunden danach oder verlinke stattdessen die Adresse; rate sie nie.
467
+
468
+ ```svelte
469
+ <MapEmbed lat={53.8676} lon={10.6866} title="Unser Büro in der Lübecker Altstadt" />
470
+ ```
471
+
472
+ Eigenschaften:
473
+
474
+ ```ts
475
+ export interface MapEmbedProps {
476
+ /** Breitengrad des Ortes, z. B. `53.8676`. */
477
+ lat: number;
478
+ /** Längengrad des Ortes, z. B. `10.6866`. */
479
+ lon: number;
480
+ /** Was die Karte zeigt, z. B. „Unser Büro in der Lübecker Altstadt“. Für Vorleseprogramme. */
481
+ title: string;
482
+ /** Zoomstufe von 3 (Kontinent) bis 18 (Hausnummer). Standard 16. */
483
+ zoom?: number;
484
+ class?: string;
485
+ }
486
+ ```
487
+
488
+ ## Embed
489
+
490
+ Bettet einen fremden Dienst ein: YouTube, Vimeo, Google Maps, Calendly oder
491
+ einen anderen Anbieter. Vor der Einwilligung steht dort ein Platzhalter mit
492
+ Titel, Anbieter und „Video laden“; erst danach lädt der Rahmen. Der Link zum
493
+ Anbieter funktioniert immer.
494
+
495
+ `id` ist ein Schlüssel aus `external` in `dealsystem.config.ts`. Die Adresse
496
+ darfst du so kopieren, wie der Kunde sie schickt, z. B.
497
+ `https://www.youtube.com/watch?v=…`; das SDK macht daraus die Einbettung
498
+ (YouTube ohne Cookies, Vimeo mit `dnt=1`). Vorschaubilder von YouTube lädt der
499
+ Platzhalter nicht; für ein Bild davor nimm `poster` mit einem Bild aus
500
+ `static/`. Anleitung: `extern.md`.
501
+
502
+ ```svelte
503
+ <Embed id="video" src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Rundgang durch das Haus" />
504
+ ```
505
+
506
+ ```ts
507
+ // dealsystem.config.ts
508
+ external: { video: { preset: 'youtube' } },
509
+ ```
510
+
511
+ Eigenschaften:
512
+
513
+ ```ts
514
+ export interface EmbedProps {
515
+ /** Schlüssel aus `external` in `dealsystem.config.ts`, z. B. `video`. */
516
+ id: ExternalKey;
517
+ /** Adresse beim Anbieter, z. B. `https://www.youtube.com/watch?v=…` oder `https://vimeo.com/123456789`. */
518
+ src: string;
519
+ /** Was zu sehen ist, z. B. „Rundgang durch das Haus“. Für Vorleseprogramme und den Platzhalter. */
520
+ title: string;
521
+ /** Seitenverhältnis, z. B. `16 / 9` (Video) oder `4 / 3`. Standard aus der Vorlage. */
522
+ aspect?: string;
523
+ /** Feste Höhe statt Seitenverhältnis, z. B. `700px` (Terminbuchung). */
524
+ height?: string;
525
+ /** Bild im Platzhalter, ein Pfad der eigenen Seite (`/bilder/vorschau.jpg`). Nie ein Bild des Anbieters. */
526
+ poster?: string;
527
+ class?: string;
528
+ }
529
+ ```
530
+
531
+ ## ExternalScript
532
+
533
+ Lädt ein fremdes Skript (Chat, Tag-Manager, Widget) erst, wenn der Besucher der
534
+ Kategorie aus der Deklaration zugestimmt hat. Je Seite höchstens einmal; nach
535
+ einem Widerruf lädt die Seite neu, damit das Skript weg ist. Zeigt selbst nichts.
536
+
537
+ `id` ist ein Schlüssel aus `external` in `dealsystem.config.ts`; `src` muss zu
538
+ einem Host unter `script` passen oder ein Pfad der eigenen Seite sein
539
+ (`/scripts/gtm.js` aus `static/`). Inline-Code gibt es nicht: Ein Snippet des
540
+ Anbieters legst du als Datei unter `static/scripts/` ab. Anleitung: `extern.md`.
541
+
542
+ ```svelte
543
+ <ExternalScript id="chat" src="https://js.hs-scripts.com/1234567.js" attrs={{ id: 'hs-script-loader', defer: true }} />
544
+ ```
545
+
546
+ ```ts
547
+ // dealsystem.config.ts
548
+ external: {
549
+ chat: {
550
+ category: 'marketing',
551
+ provider: 'HubSpot, Inc., USA',
552
+ purpose: 'Live-Chat mit dem Vertrieb',
553
+ privacyUrl: 'https://legal.hubspot.com/de/privacy-policy',
554
+ script: ['https://js.hs-scripts.com'],
555
+ connect: ['https://*.hubspot.com'],
556
+ },
557
+ },
558
+ ```
559
+
560
+ Eigenschaften:
561
+
562
+ ```ts
563
+ export interface ExternalScriptProps {
564
+ /** Schlüssel aus `external` in `dealsystem.config.ts`, z. B. `chat`. */
565
+ id: ExternalKey;
566
+ /** Adresse des Skripts beim Anbieter oder Pfad der eigenen Seite (`/scripts/gtm.js`). */
567
+ src: string;
568
+ /** `async`, `defer`, `id`, `type`, `crossorigin`, `referrerpolicy` und `data-*`. Ohne Angabe: `async`. */
569
+ attrs?: ExternalScriptAttrs;
570
+ }
571
+ ```
572
+
573
+ ## CookieBanner
574
+
575
+ Hinweis zur Einwilligung. Gehört einmal in `src/routes/+layout.svelte`.
576
+ Er erscheint nur, wenn die Seite etwas nutzt, das eine Einwilligung braucht:
577
+ Tracking mit Kennung aus dem CRM, `<ConsentGate>`, `<MapEmbed>` oder ein Video
578
+ eines anderen Anbieters. Sonst bleibt er unsichtbar, und es wird nichts gespeichert.
579
+ „Alle ablehnen“ und „Alle akzeptieren“ sind gleich gestaltet. Die Wahl wird im
580
+ Browser gespeichert; ändern lässt sie sich über „Cookie-Einstellungen“ in
581
+ `<SiteFooterLegal />`.
582
+
583
+ ```svelte
584
+ <CookieBanner />
585
+ ```
586
+
587
+ Gefragt wird nach den Zwecken, die die Seite gerade braucht. Fest vorgeben lassen sie sich so:
588
+
589
+ ```svelte
590
+ <CookieBanner categories={['marketing']} />
591
+ ```
592
+
593
+ Eigenschaften:
594
+
595
+ ```ts
596
+ export interface CookieBannerProps {
597
+ /** Zwecke, nach denen gefragt wird. Standard: die, die Bausteine auf der Seite brauchen. */
598
+ categories?: readonly ConsentCategory[];
599
+ /** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
600
+ privacyHref?: string;
601
+ }
602
+ ```
603
+
604
+ ## ConsentGate
605
+
606
+ Zeigt seinen Inhalt erst, wenn der Besucher dem Zweck zugestimmt hat. Vorher
607
+ wird der Inhalt gar nicht erzeugt, auch nicht beim Build.
608
+
609
+ Für fremde Dienste brauchst du `<ConsentGate>` meist nicht: Videos, Karten und
610
+ Terminbuchung bindest du mit `<Embed>` ein, fremde Skripte mit
611
+ `<ExternalScript>`, Tracking mit `<Tracking />`. Diese Bausteine fragen selbst
612
+ nach der Einwilligung. Jeder fremde Host muss unter `external` in
613
+ `dealsystem.config.ts` stehen, sonst blockiert ihn der Browser
614
+ (`npx dealsystem check` meldet es, `SEC-008`). Anleitung: `extern.md`.
615
+
616
+ ```svelte
617
+ <ConsentGate category="marketing">
618
+ <Tracking />
619
+ </ConsentGate>
620
+ ```
621
+
622
+ Eigener Inhalt, der erst nach der Zustimmung erscheinen soll, mit Ersatz davor:
623
+
624
+ ```svelte
625
+ <ConsentGate category="media">
626
+ <Embed id="video" src="https://www.youtube.com/watch?v=…" title="Rundgang" />
627
+ {#snippet fallback({ accept })}
628
+ <p>Hier steht nach Ihrer Zustimmung ein Video von YouTube.</p>
629
+ <button type="button" onclick={accept}>Video anzeigen</button>
630
+ {/snippet}
631
+ </ConsentGate>
632
+ ```
633
+
634
+ Eigenschaften:
635
+
636
+ ```ts
637
+ export interface ConsentGateProps {
638
+ /** Zweck: `statistics`, `marketing` oder `media`. */
639
+ category: ConsentCategory;
640
+ /** Inhalt, der erst nach der Einwilligung entsteht. */
641
+ children: Snippet;
642
+ /** Ersatz ohne Einwilligung. `accept` stimmt genau diesem Zweck zu. */
643
+ fallback?: Snippet<[{ accept: () => void }]>;
644
+ }
645
+ ```
646
+
647
+ ## Tracking
648
+
649
+ Bindet Meta Pixel und Google Tag ein. Die IDs stehen im CRM unter
650
+ Eigene Website → Einstellungen, nie im Code. Geladen wird erst nach der Einwilligung
651
+ „Marketing“. Eigene Pixel-Snippets sind nicht erlaubt.
652
+
653
+ ```svelte
654
+ <ConsentGate category="marketing">
655
+ <Tracking />
656
+ </ConsentGate>
657
+ ```
658
+
659
+
660
+ ## Impressum
661
+
662
+ Das Impressum der Seite. Gibt den Text aus, den der Kunde im CRM unter
663
+ Eigene Website → Rechtliches eingetragen hat. Der Text steht nie im Code, und die
664
+ Komponente erzeugt keinen eigenen. Gehört auf `src/routes/impressum/+page.svelte`.
665
+
666
+ Fehlt der Text noch, zeigt die Vorschau einen Hinweis, wo er einzutragen ist.
667
+ Live schalten lässt sich die Seite erst mit Text.
668
+
669
+ ```svelte
670
+ <svelte:head>
671
+ <title>Impressum</title>
672
+ <meta name="description" content="Impressum und Anbieterkennzeichnung." />
673
+ </svelte:head>
674
+
675
+ <Impressum />
676
+ ```
677
+
678
+ Eigenschaften:
679
+
680
+ ```ts
681
+ export interface ImpressumProps {
682
+ /** Ebene der Überschrift „Impressum“. Standard 1 (die `h1` der Seite). */
683
+ headingLevel?: 1 | 2;
684
+ class?: string;
685
+ }
686
+ ```
687
+
688
+ ## Datenschutz
689
+
690
+ Die Datenschutzerklärung der Seite. Gibt den Text aus, den der Kunde im CRM
691
+ unter Eigene Website → Rechtliches eingetragen hat. Der Text steht nie im Code, und
692
+ die Komponente erzeugt keinen eigenen. Gehört auf
693
+ `src/routes/datenschutz/+page.svelte`.
694
+
695
+ Fehlt der Text noch, zeigt die Vorschau einen Hinweis, wo er einzutragen ist.
696
+ Live schalten lässt sich die Seite erst mit Text.
697
+
698
+ ```svelte
699
+ <svelte:head>
700
+ <title>Datenschutz</title>
701
+ <meta name="description" content="Datenschutzerklärung dieser Website." />
702
+ </svelte:head>
703
+
704
+ <Datenschutz />
705
+ ```
706
+
707
+ Eigenschaften:
708
+
709
+ ```ts
710
+ export interface DatenschutzProps {
711
+ /** Ebene der Überschrift „Datenschutzerklärung“. Standard 1 (die `h1` der Seite). */
712
+ headingLevel?: 1 | 2;
713
+ class?: string;
714
+ }
715
+ ```
716
+
717
+ ## SiteFooterLegal
718
+
719
+ Die Pflicht-Links jeder Seite: Impressum, Datenschutz und „Cookie-Einstellungen“
720
+ (Widerruf der Einwilligung). Gehört in den Footer von `src/routes/+layout.svelte`.
721
+ „Cookie-Einstellungen“ erscheint nur, wenn es etwas einzustellen gibt (wie beim
722
+ `<CookieBanner />`).
723
+
724
+ ```svelte
725
+ <footer>
726
+ <SiteFooterLegal />
727
+ </footer>
728
+ ```
729
+
730
+ Eigenschaften:
731
+
732
+ ```ts
733
+ export interface SiteFooterLegalProps {
734
+ /** Adresse des Impressums. Standard `/impressum`. */
735
+ impressumHref?: string;
736
+ /** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
737
+ datenschutzHref?: string;
738
+ class?: string;
739
+ }
740
+ ```
741
+
742
+ ## Seo
743
+
744
+ Titel, Beschreibung und Vorschaubild einer Seite: `<title>`, `meta description`,
745
+ die Angaben für WhatsApp, Facebook und LinkedIn (`og:*`) und `twitter:card`.
746
+ Gehört einmal auf jede Seite, statt `<title>` und `meta description` selbst in
747
+ `<svelte:head>` zu schreiben. Sonst stünden die Tags doppelt da, und der Kunde
748
+ könnte sie im CRM nicht ändern.
749
+
750
+ Was gilt, wird je Angabe entschieden: was der Kunde im CRM unter Eigene Website
751
+ → Einstellungen → Google und Teilen für diese Seite eingetragen hat, sonst
752
+ `title`/`description`/`image` von hier, sonst seine Vorgabe für alle Seiten,
753
+ beim Titel zuletzt der Name der Website. Alles wird als Text ausgegeben, nie als
754
+ HTML.
755
+
756
+ ```svelte
757
+ <script lang="ts">
758
+ import { Seo } from '@dealsystem/site';
759
+ let { data } = $props();
760
+ </script>
761
+
762
+ <Seo
763
+ title="Kontakt – {data.site.name}"
764
+ description="Schreiben Sie uns. Wir melden uns schnell bei Ihnen zurück."
765
+ />
766
+ ```
767
+
768
+ Auf einer Detailseite mit Bild aus dem CMS:
769
+
770
+ ```svelte
771
+ <Seo title={angebot.data.titel} description={angebot.data.kurztext} image={angebot.media.bilder[0]} />
772
+ ```
773
+
774
+ Eigenschaften:
775
+
776
+ ```ts
777
+ export interface SeoProps {
778
+ /** Titel dieser Seite (Tab, Google), solange im CRM keiner eingetragen ist. Je Seite ein eigener. */
779
+ title?: string | null;
780
+ /** Beschreibung für Google und Vorschauen, ein bis zwei Sätze. */
781
+ description?: string | null;
782
+ /** Vorschaubild beim Teilen: Bild aus dem CMS oder Pfad bzw. Import eines Bildes im Projekt. */
783
+ image?: MediaRef | string | null;
784
+ /** Was auf dem Vorschaubild zu sehen ist (nur nötig, wenn `image` ein Pfad ist). */
785
+ imageAlt?: string | null;
786
+ }
787
+ ```
788
+
789
+ ## SiteHead
790
+
791
+ Angaben im Kopf jeder Seite, die für die ganze Website gelten. Gehört einmal in
792
+ `src/routes/+layout.svelte`.
793
+
794
+ - Favicon: Hat der Kunde im CRM unter Eigene Website → Einstellungen → Google und
795
+ Teilen eins hochgeladen, gelten dessen Größen (32 px im Tab, 180 px für iOS,
796
+ 192 und 512 px im Web-Manifest). Sonst das Favicon aus dem Code, das du mit
797
+ `favicon` angibst. Schreib den Favicon-Link nicht zusätzlich in `src/app.html`.
798
+ - „Nicht bei Google anzeigen“: Hat der Kunde das eingestellt, steht auf jeder
799
+ Seite `<meta name="robots" content="noindex">`.
800
+
801
+ - Inhaltsblock: Die Texte und Bilder aus dem CRM (Content-Slots) stehen einmal
802
+ je Seite als `<script type="application/json" id="ds-content">` im Kopf. Der
803
+ Browser liest sie dort, nicht aus dem JS-Bundle. So kann DealSystem einen
804
+ geänderten Text in die fertige Seite schreiben, ohne sie neu zu bauen.
805
+
806
+ Titel und Beschreibung je Seite setzt `<Seo>`.
807
+
808
+ Außerdem meldet `<SiteHead>` jeden Seitenaufruf für die Statistik im CRM: Pfad,
809
+ Einstieg und Kampagne. Die Besuchs-ID geht nur mit Einwilligung „Marketing“ mit.
810
+
811
+ ```svelte
812
+ <SiteHead favicon="/favicon.svg" />
813
+ ```
814
+
815
+ Eigenschaften:
816
+
817
+ ```ts
818
+ export interface SiteHeadProps {
819
+ /** Favicon aus dem Projekt (Pfad unter `static/`), solange im CRM keins hochgeladen ist. */
820
+ favicon?: string;
821
+ }
822
+ ```
823
+
824
+ ## Zeitfenster
825
+
826
+ Zeigt seinen Inhalt nur in einem Zeitraum, z. B. eine Anmeldung bis zum Beginn
827
+ eines Webinars. `ab` gehört dazu, `bis` nicht mehr. Eine Grenze reicht.
828
+
829
+ Zeitpunkte immer mit Zeitzone: `+01:00` im Winter, `+02:00` im Sommer (deutsche
830
+ Zeit), oder `Z` für UTC. Ohne Zeitzone bricht der Build ab (`QUA-009`).
831
+
832
+ ```svelte
833
+ <Zeitfenster bis="2026-12-01T18:00:00+01:00">
834
+ <Text key="start.webinar.anmeldung" default="Jetzt anmelden: Webinar am 1. Dezember" />
835
+ </Zeitfenster>
836
+ <Zeitfenster ab="2026-12-01T18:00:00+01:00" bis="2026-12-01T19:30:00+01:00">
837
+ <Text key="start.webinar.live" default="Das Webinar läuft gerade" />
838
+ </Zeitfenster>
839
+ ```
840
+
841
+ So wirkt es: Beim Bauen entscheidet die Uhrzeit des Builds, was im HTML steht.
842
+ Im Browser schaltet der Baustein sofort um, wenn eine Grenze erreicht ist.
843
+ DealSystem baut die Seite zu jeder Grenze neu, damit auch das HTML (Google,
844
+ Vorschauen) nach wenigen Minuten stimmt. Dafür müssen `ab` und `bis` feste
845
+ Zeichenketten sein, keine Variablen.
846
+
847
+ Eigenschaften:
848
+
849
+ ```ts
850
+ export interface ZeitfensterProps {
851
+ /** Ab diesem Zeitpunkt sichtbar, mit Zeitzone, z. B. `2026-12-01T18:00:00+01:00`. */
852
+ ab?: string;
853
+ /** Bis zu diesem Zeitpunkt sichtbar (ausschließlich), mit Zeitzone. */
854
+ bis?: string;
855
+ /** Inhalt im Zeitraum. */
856
+ children: Snippet;
857
+ }
858
+ ```
859
+
860
+ ## consent
861
+
862
+ ### consent
863
+
864
+ Zustand der Einwilligung. Reaktiv: in Markup und `$derived` verwendbar.
865
+ Vor der Entscheidung des Besuchers ist nichts erlaubt.
866
+
867
+ - `consent.has(zweck)` – hat der Besucher diesem Zweck zugestimmt?
868
+ - `consent.openSettings()` – den Hinweis erneut öffnen (Widerruf)
869
+ - `consent.grant(zweck)` – einem Zweck zustimmen, z. B. über „Karte anzeigen“
870
+ - `consent.acceptAll()`, `consent.rejectAll()`, `consent.save([zwecke])`
871
+ - `consent.decided` – hat der Besucher schon gewählt?
872
+
873
+ ```ts
874
+ <script>
875
+ import { consent } from '@dealsystem/site';
876
+ </script>
877
+
878
+ <button type="button" onclick={() => consent.openSettings()}>Cookie-Einstellungen</button>
879
+ {#if consent.has('media')}<p>Karte wird angezeigt.</p>{/if}
880
+ ```
881
+
882
+ ### ConsentCategory
883
+
884
+ Zwecke, für die eine Einwilligung nötig ist:
885
+ `statistics` (Reichweitenmessung), `marketing` (Werbe-Pixel, Kampagnen),
886
+ `media` (eingebettete Inhalte Dritter wie Karten oder Videos).
887
+
888
+ ```ts
889
+ type ConsentCategory = 'statistics' | 'marketing' | 'media';
890
+ ```
891
+
892
+ ## Eigene Formular-Oberfläche
893
+
894
+ Für mehrstufige Funnels, Rechner und Quiz. Vorlage: Skill `funnel-mehrstufig`.
895
+
896
+ ### createLeadClient()
897
+
898
+ Formular ohne `<LeadForm>`: für eigene Oberflächen wie mehrstufige Funnels. Nimmt den Schlüssel aus
899
+ `dealsystem.config.ts`. Kein eigenes `fetch` an DealSystem, das ist verboten (`SEC-004`).
900
+
901
+ Zeig bei jedem Fehler außer `validation` den Ausweichkontakt `res.fallback` (`QUA-008`) und
902
+ setz `<LeadHoneypot client={lead} />` in die Oberfläche (Bot-Falle). Nach Erfolg passt `lead.successMessage`;
903
+ verspricht das Formular eine Datei (`leadmagnet`), kündigt dieser Text sie an.
904
+
905
+ ```ts
906
+ <script lang="ts">
907
+ import { createLeadClient, LeadHoneypot } from '@dealsystem/site';
908
+ import { onMount } from 'svelte';
909
+
910
+ const lead = createLeadClient('bewertung');
911
+ onMount(() => () => lead.destroy());
912
+ let email = $state('');
913
+ let result = $state<Awaited<ReturnType<typeof lead.submit>> | null>(null);
914
+
915
+ // Eigenes <form>: Enter sendet, der Browser prüft `required`. Ohne `action`, Absenden nur hier (SEC-007).
916
+ async function senden(event: SubmitEvent) {
917
+ event.preventDefault();
918
+ result = await lead.submit({ email });
919
+ }
920
+ </script>
921
+
922
+ <form onsubmit={senden}>
923
+ <label for="email">E-Mail</label>
924
+ <input id="email" type="email" autocomplete="email" required bind:value={email} onfocus={() => lead.prepare()} />
925
+ <LeadHoneypot client={lead} />
926
+ <button type="submit">Senden</button>
927
+ </form>
928
+ {#if result && !result.ok}
929
+ <p role="alert">{result.message}</p>
930
+ {#if result.fallback?.phone}<a href="tel:{result.fallback.phone}">{result.fallback.phone}</a>{/if}
931
+ {/if}
932
+ ```
933
+
934
+ ```ts
935
+ function createLeadClient<K extends FunnelKey>(
936
+ funnel: K,
937
+ options: LeadClientOptions = {},
938
+ ): LeadClient<K>;
939
+ ```
940
+
941
+ ### LeadResult
942
+
943
+ Ergebnis von `submit()`.
944
+
945
+ ```ts
946
+ type LeadResult =
947
+ | {
948
+ ok: true;
949
+ /** `true` in der Vorschau: geprüft, aber nicht gespeichert. Zeig dann einen Hinweis. */
950
+ dryRun: boolean;
951
+ submissionId: string;
952
+ }
953
+ | {
954
+ ok: false;
955
+ reason: 'validation';
956
+ /** Text für Besucher, auf Deutsch. */
957
+ message: string;
958
+ /** Je abgelehntem Feld ein Text, z. B. `{ email: 'Bitte geben Sie …' }`. */
959
+ fields: Record<string, string>;
960
+ fallback: null;
961
+ /** @internal Fehler der Site-API, wenn der Server abgelehnt hat. */
962
+ error: SiteApiError | null;
963
+ }
964
+ | {
965
+ ok: false;
966
+ reason: Exclude<LeadFailureReason, 'validation'>;
967
+ message: string;
968
+ fields: Record<string, never>;
969
+ /** Telefon und E-Mail aus dem CRM. Zeig sie, damit der Besucher trotzdem anfragen kann. */
970
+ fallback: LeadFallback;
971
+ retryAfterSeconds: number | null;
972
+ /** @internal */
973
+ error: SiteApiError;
974
+ };
975
+ ```
976
+
977
+ ### LeadFailureReason
978
+
979
+ Warum eine Einsendung nicht angekommen ist.
980
+
981
+ ```ts
982
+ type LeadFailureReason =
983
+ /** Angaben fehlen oder passen nicht: `fields` nennt je Feld den Text, `message` den für das ganze Formular. */
984
+ | 'validation'
985
+ /** Die Sicherheitsprüfung (Captcha) ließ sich nicht durchführen. */
986
+ | 'captcha'
987
+ /** Zu viele Anfragen;
988
+ ```
989
+
990
+ ### LeadFallback
991
+
992
+ Ausweichkontakt aus den Firmendaten im CRM. Leere Angaben sind `null`. Zeig ihn bei jedem Fehler außer `validation`.
993
+
994
+ ```ts
995
+ interface LeadFallback {
996
+ phone: string | null;
997
+ email: string | null;
998
+ }
999
+ ```
1000
+ ### createFunnelState()
1001
+
1002
+ Hilfe für mehrstufige Formulare mit `createLeadClient()`: Schritte, Prüfung je Schritt, Fortschritt. Die
1003
+ Oberfläche baust du selbst; setze beim Schrittwechsel den Fokus auf die Überschrift des neuen Schritts.
1004
+
1005
+ ```ts
1006
+ const lead = createLeadClient('bewertung');
1007
+ const funnel = createFunnelState(lead, [
1008
+ { id: 'objekt', title: 'Um welche Immobilie geht es?', fields: ['objektart', 'wohnflaeche'] },
1009
+ { id: 'kontakt', title: 'Wohin dürfen wir die Einschätzung schicken?', fields: ['firstName', 'email'] },
1010
+ ]);
1011
+ // <input bind:value={funnel.values.wohnflaeche} />, <button onclick={() => funnel.next()}>Weiter</button>
1012
+ ```
1013
+
1014
+ ```ts
1015
+ function createFunnelState<K extends string>(
1016
+ client: LeadClient<K>,
1017
+ steps: readonly FunnelStep[],
1018
+ ): FunnelState<K>;
1019
+ ```
1020
+
1021
+ ### FunnelStep
1022
+
1023
+ Ein Schritt: eine Überschrift und die Felder, die auf ihm stehen.
1024
+
1025
+ ```ts
1026
+ interface FunnelStep {
1027
+ /** Eindeutig, z. B. `objekt`. */
1028
+ id: string;
1029
+ /** Überschrift des Schritts, z. B. „Um welche Immobilie geht es?“. */
1030
+ title: string;
1031
+ /** Namen der Felder aus `dealsystem.config.ts`, die auf diesem Schritt stehen. Leer = ein Schritt ohne Felder. */
1032
+ fields: readonly string[];
1033
+ }
1034
+ ```
1035
+
1036
+ ## Eigene Terminbuchung
1037
+
1038
+ Ohne `<Booker>`, mit eigener Oberfläche. Ablauf und Regeln: `termine.md`.
1039
+
1040
+ ### createBookingClient()
1041
+
1042
+ Terminbuchung ohne `<Booker>`: für eine eigene Oberfläche. Nimmt den Schlüssel aus `booking` in
1043
+ `dealsystem.config.ts`. Die Terminart (Dauer, Arbeitszeiten, Fragen) richtet der Kunde im CRM ein; erfinde
1044
+ keine. Kein eigenes `fetch` an DealSystem (`SEC-004`).
1045
+
1046
+ Zeiten kommen und gehen in UTC. Zeig sie in der Zeitzone des Besuchers (`groupSlotsByDay`, `visitorTimeZone`)
1047
+ und nenne die des Kalenders (`timezone`) als Hinweis. Zeig bei jedem Fehler außer `validation` den
1048
+ Ausweichkontakt `fallback`; bei `slot_taken` die Zeiten neu laden. Setz `<LeadHoneypot client={termin} />` in
1049
+ die Oberfläche.
1050
+
1051
+ ```ts
1052
+ <script lang="ts">
1053
+ import { createBookingClient, groupSlotsByDay, visitorTimeZone, LeadHoneypot } from '@dealsystem/site';
1054
+ import { onMount } from 'svelte';
1055
+
1056
+ const termin = createBookingClient('erstgespraech');
1057
+ const zone = visitorTimeZone();
1058
+ let tage = $state<ReturnType<typeof groupSlotsByDay>>([]);
1059
+ let start = $state('');
1060
+ let vorname = $state('');
1061
+ let email = $state('');
1062
+ let ergebnis = $state<Awaited<ReturnType<typeof termin.book>> | null>(null);
1063
+
1064
+ onMount(() => {
1065
+ termin.slots().then((r) => (tage = r.ok ? groupSlotsByDay(r.slots, zone) : []));
1066
+ return () => termin.destroy();
1067
+ });
1068
+
1069
+ async function buchen(event: SubmitEvent) {
1070
+ event.preventDefault();
1071
+ ergebnis = await termin.book({ start, firstName: vorname, email });
1072
+ }
1073
+ </script>
1074
+
1075
+ {#each tage as tag (tag.date)}
1076
+ <h3>{tag.long}</h3>
1077
+ {#each tag.slots as zeit (zeit.start)}
1078
+ <button type="button" aria-pressed={start === zeit.start} onclick={() => ((start = zeit.start), termin.prepare())}>
1079
+ {zeit.time}
1080
+ </button>
1081
+ {/each}
1082
+ {/each}
1083
+ <form onsubmit={buchen}>
1084
+ <label for="vorname">Vorname</label>
1085
+ <input id="vorname" required bind:value={vorname} />
1086
+ <label for="email">E-Mail</label>
1087
+ <input id="email" type="email" required bind:value={email} />
1088
+ <LeadHoneypot client={termin} />
1089
+ <button type="submit" disabled={!start}>Termin buchen</button>
1090
+ </form>
1091
+ {#if ergebnis && !ergebnis.ok}<p role="alert">{ergebnis.message}</p>{/if}
1092
+ ```
1093
+
1094
+ ```ts
1095
+ function createBookingClient<K extends BookingKey>(
1096
+ booking: K,
1097
+ options: BookingClientOptions = {},
1098
+ ): BookingClient<K>;
1099
+ ```
1100
+
1101
+ ### BookingInput
1102
+
1103
+ Was gebucht werden soll.
1104
+
1105
+ ```ts
1106
+ interface BookingInput {
1107
+ /** Beginn genau wie `start` aus `slots()` (UTC). */
1108
+ start: string;
1109
+ firstName: string;
1110
+ lastName?: string;
1111
+ email: string;
1112
+ phone?: string;
1113
+ /** Antworten auf die Buchungsfragen (`info.questions[].key`). */
1114
+ answers?: Record<string, string | number | boolean | readonly string[] | undefined>;
1115
+ /** Gewählte Ort-Art aus `info.locations`; ohne Angabe die erste. */
1116
+ locationType?: BookingLocationType;
1117
+ }
1118
+ ```
1119
+
1120
+ ### BookingResult
1121
+
1122
+ Ergebnis von `book()`.
1123
+
1124
+ ```ts
1125
+ type BookingResult =
1126
+ | {
1127
+ ok: true;
1128
+ /** `true` in der Vorschau: geprüft, nichts gebucht, keine Mail. Zeig dann einen Hinweis. */
1129
+ dryRun: boolean;
1130
+ /** `true`, wenn derselbe Vorgang schon gebucht war (doppelt abgeschickt). Für Besucher: gebucht. */
1131
+ duplicate: boolean;
1132
+ /** Beginn und Ende in UTC. */
1133
+ start: string;
1134
+ end: string | null;
1135
+ submissionId: string;
1136
+ }
1137
+ | {
1138
+ ok: false;
1139
+ reason: 'validation';
1140
+ message: string;
1141
+ /** Je abgelehntem Feld ein Text: `firstName`, `lastName`, `email`, `phone` oder `answers.<key>`. */
1142
+ fields: Record<string, string>;
1143
+ fallback: null;
1144
+ /** @internal */
1145
+ error: SiteApiError | null;
1146
+ }
1147
+ | BookingFailure;
1148
+ ```
1149
+
1150
+ ### BookingFailureReason
1151
+
1152
+ Warum etwas nicht geklappt hat.
1153
+
1154
+ ```ts
1155
+ type BookingFailureReason =
1156
+ /** Angaben fehlen oder passen nicht: `fields` nennt je Feld den Text. */
1157
+ | 'validation'
1158
+ /** Die Zeit ist inzwischen vergeben: freie Zeiten neu laden und eine andere wählen lassen. */
1159
+ | 'slot_taken'
1160
+ /** Die Angaben passen nicht zu dieser Terminart (Regel im CRM). Ausweichkontakt zeigen. */
1161
+ | 'not_qualified'
1162
+ /** Die Sicherheitsprüfung (Captcha) ließ sich nicht durchführen. */
1163
+ | 'captcha'
1164
+ /** Zu viele Anfragen;
1165
+ ```
1166
+ ### groupSlotsByDay()
1167
+
1168
+ Freie Termine nach Kalendertag in der Anzeige-Zeitzone, aufsteigend. Ein Termin um 23:30 UTC gehört in Berlin
1169
+ zum nächsten Tag; ein Tag der Zeitumstellung hat einfach eine Stunde mehr oder weniger.
1170
+
1171
+ ```ts
1172
+ function groupSlotsByDay(
1173
+ slots: readonly BookingSlot[],
1174
+ timeZone: string,
1175
+ locale = 'de-DE',
1176
+ ): BookingDay[];
1177
+ ```
1178
+
1179
+ ### visitorTimeZone()
1180
+
1181
+ IANA-Zeitzone des Besuchers, z. B. `Europe/Berlin`. Ohne Angabe des Browsers `Europe/Berlin`.
1182
+
1183
+ ```ts
1184
+ function visitorTimeZone(): string;
1185
+ ```
1186
+
1187
+ ### timeZoneLabel()
1188
+
1189
+ Name einer Zeitzone für Besucher, z. B. `Mitteleuropäische Zeit (Berlin)`. Ohne Namen in `Intl` nur die Stadt.
1190
+
1191
+ ```ts
1192
+ function timeZoneLabel(timeZone: string, locale = 'de-DE', at: Date = new Date()): string;
1193
+ ```
1194
+
1195
+ ### formatBookingTime()
1196
+
1197
+ Uhrzeit eines Zeitpunkts in einer Zeitzone, z. B. `09:30`.
1198
+
1199
+ ```ts
1200
+ function formatBookingTime(instant: Date | string, timeZone: string): string;
1201
+ ```
1202
+
1203
+ ### formatBookingDate()
1204
+
1205
+ Datum eines Zeitpunkts in einer Zeitzone, z. B. `Dienstag, 1. Dezember 2026`.
1206
+
1207
+ ```ts
1208
+ function formatBookingDate(instant: Date | string, timeZone: string, locale = 'de-DE'): string;
1209
+ ```
1210
+
1211
+ ## Kampagnen-Parameter
1212
+
1213
+ ### getCampaignParam()
1214
+
1215
+ Wert eines eigenen URL-Parameters, z. B. `partner` aus `?partner=…`: aus dem aktuellen Besuch, sonst (nur mit
1216
+ Einwilligung) aus dem zuletzt gespeicherten. `null`, wenn es ihn nicht gibt. Nur im Browser.
1217
+
1218
+ Nicht gelesen werden UTM-Parameter, Klick-IDs und Namen, die nach Zugangs- oder Personendaten aussehen
1219
+ (`email`, `token`, `session` …); höchstens 20 Parameter, Werte bis 500 Zeichen. Mit der Anfrage gehen die
1220
+ Parameter ohnehin an das CRM (`<LeadForm>`), dafür ist nichts zu tun.
1221
+
1222
+ ```ts
1223
+ <script lang="ts">
1224
+ import { getCampaignParam } from '@dealsystem/site';
1225
+ import { onMount } from 'svelte';
1226
+ let partner = $state<string | null>(null);
1227
+ onMount(() => (partner = getCampaignParam('partner')));
1228
+ </script>
1229
+ ```
1230
+
1231
+ ```ts
1232
+ function getCampaignParam(name: string): string | null;
1233
+ ```
1234
+
1235
+ ## Inhalte im Browser nachladen
1236
+
1237
+ ### loadCollection()
1238
+
1239
+ Lädt Einträge einer Sammlung **im Browser** über die Site-API, z. B. für
1240
+ „Mehr laden“. Wirft nie: das Ergebnis ist `{ ok: true, data }` oder
1241
+ `{ ok: false, error }`. Ohne `limit` kommen 20 Einträge, höchstens 100 je
1242
+ Abruf; `total` nennt die Gesamtzahl, weitere holt `offset`. Inhalte, die Suchmaschinen sehen sollen, lädt
1243
+ stattdessen `getCollection()` aus `@dealsystem/site/content` beim Build.
1244
+
1245
+ ```ts
1246
+ const result = await loadCollection('angebote', { limit: 12, offset: 12 });
1247
+ if (result.ok) angebote.push(...result.data.entries);
1248
+ else meldung = result.error.message;
1249
+ ```
1250
+
1251
+ ```ts
1252
+ async function loadCollection<K extends CollectionKey>(
1253
+ key: K,
1254
+ query: { limit?: number; offset?: number; sort?: 'newest' | 'oldest' } = {},
1255
+ ): Promise<SiteApiResult<LoadedCollection<K>>>;
1256
+ ```
1257
+
1258
+ ### loadEntry()
1259
+
1260
+ Lädt einen Eintrag **im Browser** über die Site-API. Wirft nie; ein
1261
+ unbekannter Slug ergibt `{ ok: false, error: { kind: 'not_found' } }`.
1262
+
1263
+ ```ts
1264
+ const result = await loadEntry('angebote', 'altbau-leipzig');
1265
+ if (result.ok) angebot = result.data;
1266
+ ```
1267
+
1268
+ ```ts
1269
+ async function loadEntry<K extends CollectionKey>(
1270
+ key: K,
1271
+ slug: string,
1272
+ ): Promise<SiteApiResult<CollectionEntry<K>>>;
1273
+ ```