@nersh/render 0.2.4 → 0.2.5

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.
package/dist/index.d.ts CHANGED
@@ -1,7 +1,224 @@
1
- import * as react from 'react';
1
+ import * as React from 'react';
2
2
  import { ReactNode, ComponentType } from 'react';
3
3
  import { z } from 'zod';
4
4
 
5
+ type LandingIRNode = {
6
+ id: string;
7
+ partId: string;
8
+ slots: Record<string, string>;
9
+ children?: LandingIRNode[];
10
+ };
11
+
12
+ /** Harvested design language — steers kit Stage 1 as strong defaults, not locks. */
13
+ type PromptTemplateKitSeed = {
14
+ fonts: {
15
+ display: string;
16
+ body: string;
17
+ };
18
+ palette: string[];
19
+ radius?: string;
20
+ vibe?: string;
21
+ harvestedFrom?: string;
22
+ };
23
+
24
+ type ContentSourceKind = 'doc' | 'sheet' | 'drive' | 'url';
25
+ type ContentSourceMedia = {
26
+ id: string;
27
+ name: string;
28
+ thumb: string;
29
+ /**
30
+ * Full-resolution URL, when it differs from `thumb`. Drive folder harvests
31
+ * are the only source that needs this: `thumbnailLink` is genuinely a
32
+ * thumbnail, so placing it into a hero slot looks bad. A harvested website
33
+ * carries a real image URL as `thumb` already, so it has no separate `full`.
34
+ */
35
+ full?: string;
36
+ };
37
+ type ContentSource = {
38
+ id: string;
39
+ kind: ContentSourceKind;
40
+ url: string;
41
+ title: string;
42
+ summary: string;
43
+ text?: string;
44
+ rows?: string[][];
45
+ media?: ContentSourceMedia[];
46
+ addedAt: number;
47
+ };
48
+ type ContentVoice = {
49
+ tone?: string;
50
+ audience?: string;
51
+ avoid?: string;
52
+ };
53
+
54
+ /**
55
+ * Pure text extraction from a page's markup: no fetch, no model, nothing but
56
+ * regexes over an HTML string. `harvestSite` uses this to build hints for the
57
+ * model; the start flow's reference attach uses it directly, client-side, to
58
+ * read a `.dc.html` design kit file for free before sign-in.
59
+ */
60
+ type HarvestHints = {
61
+ fonts: string[];
62
+ palette: string[];
63
+ textSkeleton: string;
64
+ };
65
+
66
+ /**
67
+ * Whatever the person attaches at the "how should it feel" turn. Held on the
68
+ * onboarding record verbatim until sign-in; kit generation is the only thing
69
+ * that reads it, and only after the mint.
70
+ *
71
+ * - `url`: a site to harvest. Deferred entirely: no fetch, no model call,
72
+ * happens until kit generation runs, since a harvest is a model call and
73
+ * that must never happen before the sign-in gate.
74
+ * - `design-kit`: a `.dc.html` file. `hints` is pulled client-side with the
75
+ * same free, model-less regex pass `harvestSite` itself uses for its own
76
+ * hints, so this costs nothing and needs no sign-in to compute.
77
+ * - `image`: a plain picture. All that can honestly be pulled from it without
78
+ * adding a dependency is a colour palette, sampled client-side via canvas.
79
+ */
80
+ type StartReference = {
81
+ kind: 'url';
82
+ url: string;
83
+ } | {
84
+ kind: 'design-kit';
85
+ fileName: string;
86
+ hints: HarvestHints;
87
+ } | {
88
+ kind: 'image';
89
+ fileName: string;
90
+ palette: string[];
91
+ };
92
+
93
+ declare const SITE_CATEGORY_IDS: readonly ["local-service", "portfolio", "link-in-bio", "professional", "ecommerce", "hospitality", "creator", "general"];
94
+ type SiteCategoryId = (typeof SITE_CATEGORY_IDS)[number];
95
+ type SiteVoiceId = 'friendly' | 'professional' | 'bold' | 'minimal' | 'luxury';
96
+ type SiteGoalId = 'book' | 'call' | 'shop' | 'portfolio' | 'donate';
97
+ type DesignSystemRef = {
98
+ kind: 'account-default';
99
+ } | {
100
+ kind: 'skin';
101
+ skinId: string;
102
+ } | {
103
+ kind: 'design-system';
104
+ id: string;
105
+ };
106
+ /** Verbatim human-authored copy pulled from the remixed site — transcribed, never marketing-ified. */
107
+ type RemixCopyDigest = {
108
+ headline?: string;
109
+ sections: Array<{
110
+ title?: string;
111
+ body: string;
112
+ }>;
113
+ contact?: string;
114
+ };
115
+ type SiteBriefRemix = {
116
+ url: string;
117
+ seed: PromptTemplateKitSeed;
118
+ /** Only present when remixing the user's own site — community remixes are seed-only. */
119
+ copy?: RemixCopyDigest;
120
+ };
121
+ type SiteBrief = {
122
+ name: string;
123
+ category: SiteCategoryId;
124
+ audience: string;
125
+ voice: SiteVoiceId;
126
+ designSystemRef: DesignSystemRef;
127
+ location?: string;
128
+ primaryGoal?: SiteGoalId;
129
+ referenceUrls?: string[];
130
+ freeformNotes?: string;
131
+ /** Prompt-template catalog id when the site started from a template; its kitSeed steers Stage 1. */
132
+ templateId?: string;
133
+ /** Harvested design language + verbatim copy from the user's current site; wins over templateId. */
134
+ remix?: SiteBriefRemix;
135
+ confirmedAt?: number;
136
+ };
137
+ type DesignSpecSection = {
138
+ sectionId: string;
139
+ instanceId: string;
140
+ purpose: string;
141
+ copyHints: Record<string, string>;
142
+ layout?: string;
143
+ };
144
+ type DesignSpec = {
145
+ specId: string;
146
+ sections: DesignSpecSection[];
147
+ visualLanguage: {
148
+ mood: string;
149
+ skinId: string;
150
+ density: 'airy' | 'balanced' | 'dense';
151
+ };
152
+ copyStrategy: {
153
+ voice: SiteVoiceId;
154
+ headlineAngle: string;
155
+ ctaPrimary: string;
156
+ };
157
+ archetypeManifestId?: string;
158
+ referenceNotes?: string[];
159
+ createdAt: number;
160
+ };
161
+ type CompleteSection = {
162
+ sectionId: string;
163
+ instanceId: string;
164
+ copy: Record<string, string>;
165
+ layout?: string;
166
+ };
167
+ type Complete = {
168
+ completeId: string;
169
+ briefRef: string;
170
+ designSpecRef: string;
171
+ sections: CompleteSection[];
172
+ skinId: string;
173
+ createdAt: number;
174
+ };
175
+ type SpecAnnotation = {
176
+ instanceId: string;
177
+ note: string;
178
+ createdAt: number;
179
+ };
180
+ type OnboardingChatMessage = {
181
+ id: string;
182
+ role: 'user' | 'assistant';
183
+ content: string;
184
+ createdAt: number;
185
+ };
186
+ declare const ONBOARDING_PHASES: readonly ["slug", "intake", "brief_confirm", "kit_building", "styles_review", "layout_pick", "content_sources", "landing_building", "spec", "scaffold_review", "ready"];
187
+ type OnboardingPhase = (typeof ONBOARDING_PHASES)[number];
188
+ type SiteOnboarding = {
189
+ phase: OnboardingPhase;
190
+ brief?: SiteBrief;
191
+ /**
192
+ * Brief keys the user actually answered. `brief` is coerced on every write so
193
+ * the RTDB round trip validates, which backfills every required slot from
194
+ * defaults — so the brief alone cannot say what is known and what is filler.
195
+ */
196
+ briefSlots?: string[];
197
+ designSpec?: DesignSpec;
198
+ complete?: Complete;
199
+ annotations?: SpecAnnotation[];
200
+ chatLog?: OnboardingChatMessage[];
201
+ startAnswers?: {
202
+ purpose: string;
203
+ name: string;
204
+ feel: string;
205
+ };
206
+ /** Attached at the "how should it feel" turn; read once by kit generation. */
207
+ startReference?: StartReference;
208
+ pagePatternId?: string;
209
+ sources?: ContentSource[];
210
+ voice?: ContentVoice;
211
+ slugProvisional?: boolean;
212
+ /**
213
+ * When the kit draft was first fired for this site. Kit generation spends,
214
+ * and the site is minted at `kit_building`, so without a record on the
215
+ * server a reload before the first kit lands would fire the generate call a
216
+ * second time. A per-mount ref cannot survive a remount; this can.
217
+ * Cleared by the Retry button, which is the user asking to spend again.
218
+ */
219
+ kitDraftStartedAt?: number;
220
+ };
221
+
5
222
  /**
6
223
  * Component library configuration — provider-agnostic skin source of truth.
7
224
  *
@@ -12,6 +229,146 @@ import { z } from 'zod';
12
229
  * changing site/content/pattern contracts downstream.
13
230
  */
14
231
 
232
+ declare const ComponentLibraryConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
233
+ provider: z.ZodLiteral<"shadcn">;
234
+ shadcn: z.ZodObject<{
235
+ base: z.ZodDefault<z.ZodEnum<{
236
+ radix: "radix";
237
+ "base-ui": "base-ui";
238
+ }>>;
239
+ style: z.ZodDefault<z.ZodEnum<{
240
+ vega: "vega";
241
+ nova: "nova";
242
+ maia: "maia";
243
+ lyra: "lyra";
244
+ mira: "mira";
245
+ luma: "luma";
246
+ sera: "sera";
247
+ rhea: "rhea";
248
+ }>>;
249
+ baseColor: z.ZodDefault<z.ZodEnum<{
250
+ zinc: "zinc";
251
+ slate: "slate";
252
+ stone: "stone";
253
+ neutral: "neutral";
254
+ gray: "gray";
255
+ mauve: "mauve";
256
+ olive: "olive";
257
+ mist: "mist";
258
+ taupe: "taupe";
259
+ }>>;
260
+ theme: z.ZodDefault<z.ZodEnum<{
261
+ zinc: "zinc";
262
+ blue: "blue";
263
+ slate: "slate";
264
+ stone: "stone";
265
+ neutral: "neutral";
266
+ gray: "gray";
267
+ mauve: "mauve";
268
+ olive: "olive";
269
+ mist: "mist";
270
+ taupe: "taupe";
271
+ green: "green";
272
+ orange: "orange";
273
+ red: "red";
274
+ rose: "rose";
275
+ violet: "violet";
276
+ amber: "amber";
277
+ yellow: "yellow";
278
+ lime: "lime";
279
+ emerald: "emerald";
280
+ teal: "teal";
281
+ cyan: "cyan";
282
+ sky: "sky";
283
+ indigo: "indigo";
284
+ purple: "purple";
285
+ fuchsia: "fuchsia";
286
+ pink: "pink";
287
+ }>>;
288
+ chartColor: z.ZodDefault<z.ZodEnum<{
289
+ zinc: "zinc";
290
+ blue: "blue";
291
+ stone: "stone";
292
+ neutral: "neutral";
293
+ gray: "gray";
294
+ mauve: "mauve";
295
+ olive: "olive";
296
+ mist: "mist";
297
+ taupe: "taupe";
298
+ green: "green";
299
+ orange: "orange";
300
+ red: "red";
301
+ rose: "rose";
302
+ violet: "violet";
303
+ amber: "amber";
304
+ yellow: "yellow";
305
+ lime: "lime";
306
+ emerald: "emerald";
307
+ teal: "teal";
308
+ cyan: "cyan";
309
+ sky: "sky";
310
+ indigo: "indigo";
311
+ purple: "purple";
312
+ fuchsia: "fuchsia";
313
+ pink: "pink";
314
+ }>>;
315
+ radius: z.ZodDefault<z.ZodEnum<{
316
+ default: "default";
317
+ none: "none";
318
+ sm: "sm";
319
+ md: "md";
320
+ lg: "lg";
321
+ xl: "xl";
322
+ }>>;
323
+ font: z.ZodDefault<z.ZodString>;
324
+ fontHeading: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"inherit">, z.ZodString]>>;
325
+ iconLibrary: z.ZodDefault<z.ZodEnum<{
326
+ lucide: "lucide";
327
+ tabler: "tabler";
328
+ hugeicons: "hugeicons";
329
+ phosphor: "phosphor";
330
+ remixicon: "remixicon";
331
+ }>>;
332
+ menuColor: z.ZodDefault<z.ZodEnum<{
333
+ default: "default";
334
+ inverted: "inverted";
335
+ "default-translucent": "default-translucent";
336
+ "inverted-translucent": "inverted-translucent";
337
+ }>>;
338
+ menuAccent: z.ZodDefault<z.ZodEnum<{
339
+ bold: "bold";
340
+ subtle: "subtle";
341
+ }>>;
342
+ layout: z.ZodPrefault<z.ZodObject<{
343
+ frame: z.ZodDefault<z.ZodEnum<{
344
+ framed: "framed";
345
+ fluid: "fluid";
346
+ }>>;
347
+ container: z.ZodDefault<z.ZodEnum<{
348
+ "5xl": "5xl";
349
+ "6xl": "6xl";
350
+ "7xl": "7xl";
351
+ }>>;
352
+ }, z.core.$strip>>;
353
+ }, z.core.$strip>;
354
+ }, z.core.$strip>, z.ZodObject<{
355
+ provider: z.ZodLiteral<"mui">;
356
+ mui: z.ZodObject<{
357
+ theme: z.ZodString;
358
+ palette: z.ZodEnum<{
359
+ light: "light";
360
+ dark: "dark";
361
+ }>;
362
+ density: z.ZodDefault<z.ZodEnum<{
363
+ standard: "standard";
364
+ comfortable: "comfortable";
365
+ compact: "compact";
366
+ }>>;
367
+ primaryColor: z.ZodOptional<z.ZodString>;
368
+ fontFamily: z.ZodOptional<z.ZodString>;
369
+ }, z.core.$strip>;
370
+ }, z.core.$strip>], "provider">;
371
+ type ComponentLibraryConfig = z.infer<typeof ComponentLibraryConfigSchema>;
15
372
  declare const CompiledSkinSchema: z.ZodObject<{
16
373
  provider: z.ZodEnum<{
17
374
  shadcn: "shadcn";
@@ -40,10 +397,10 @@ declare const CompiledSkinSchema: z.ZodObject<{
40
397
  rhea: "rhea";
41
398
  }>>;
42
399
  baseColor: z.ZodDefault<z.ZodEnum<{
43
- neutral: "neutral";
44
- stone: "stone";
45
400
  zinc: "zinc";
46
401
  slate: "slate";
402
+ stone: "stone";
403
+ neutral: "neutral";
47
404
  gray: "gray";
48
405
  mauve: "mauve";
49
406
  olive: "olive";
@@ -51,56 +408,56 @@ declare const CompiledSkinSchema: z.ZodObject<{
51
408
  taupe: "taupe";
52
409
  }>>;
53
410
  theme: z.ZodDefault<z.ZodEnum<{
54
- neutral: "neutral";
55
- stone: "stone";
56
411
  zinc: "zinc";
412
+ blue: "blue";
57
413
  slate: "slate";
414
+ stone: "stone";
415
+ neutral: "neutral";
58
416
  gray: "gray";
59
417
  mauve: "mauve";
60
418
  olive: "olive";
61
419
  mist: "mist";
62
420
  taupe: "taupe";
421
+ green: "green";
422
+ orange: "orange";
63
423
  red: "red";
64
424
  rose: "rose";
65
- orange: "orange";
425
+ violet: "violet";
66
426
  amber: "amber";
67
427
  yellow: "yellow";
68
428
  lime: "lime";
69
- green: "green";
70
429
  emerald: "emerald";
71
430
  teal: "teal";
72
431
  cyan: "cyan";
73
432
  sky: "sky";
74
- blue: "blue";
75
433
  indigo: "indigo";
76
- violet: "violet";
77
434
  purple: "purple";
78
435
  fuchsia: "fuchsia";
79
436
  pink: "pink";
80
437
  }>>;
81
438
  chartColor: z.ZodDefault<z.ZodEnum<{
82
- neutral: "neutral";
83
- stone: "stone";
84
439
  zinc: "zinc";
440
+ blue: "blue";
441
+ stone: "stone";
442
+ neutral: "neutral";
85
443
  gray: "gray";
86
444
  mauve: "mauve";
87
445
  olive: "olive";
88
446
  mist: "mist";
89
447
  taupe: "taupe";
448
+ green: "green";
449
+ orange: "orange";
90
450
  red: "red";
91
451
  rose: "rose";
92
- orange: "orange";
452
+ violet: "violet";
93
453
  amber: "amber";
94
454
  yellow: "yellow";
95
455
  lime: "lime";
96
- green: "green";
97
456
  emerald: "emerald";
98
457
  teal: "teal";
99
458
  cyan: "cyan";
100
459
  sky: "sky";
101
- blue: "blue";
102
460
  indigo: "indigo";
103
- violet: "violet";
104
461
  purple: "purple";
105
462
  fuchsia: "fuchsia";
106
463
  pink: "pink";
@@ -129,9 +486,20 @@ declare const CompiledSkinSchema: z.ZodObject<{
129
486
  "inverted-translucent": "inverted-translucent";
130
487
  }>>;
131
488
  menuAccent: z.ZodDefault<z.ZodEnum<{
132
- subtle: "subtle";
133
489
  bold: "bold";
490
+ subtle: "subtle";
134
491
  }>>;
492
+ layout: z.ZodPrefault<z.ZodObject<{
493
+ frame: z.ZodDefault<z.ZodEnum<{
494
+ framed: "framed";
495
+ fluid: "fluid";
496
+ }>>;
497
+ container: z.ZodDefault<z.ZodEnum<{
498
+ "5xl": "5xl";
499
+ "6xl": "6xl";
500
+ "7xl": "7xl";
501
+ }>>;
502
+ }, z.core.$strip>>;
135
503
  }, z.core.$strip>;
136
504
  }, z.core.$strip>, z.ZodObject<{
137
505
  provider: z.ZodLiteral<"mui">;
@@ -142,8 +510,8 @@ declare const CompiledSkinSchema: z.ZodObject<{
142
510
  dark: "dark";
143
511
  }>;
144
512
  density: z.ZodDefault<z.ZodEnum<{
145
- comfortable: "comfortable";
146
513
  standard: "standard";
514
+ comfortable: "comfortable";
147
515
  compact: "compact";
148
516
  }>>;
149
517
  primaryColor: z.ZodOptional<z.ZodString>;
@@ -153,14 +521,28 @@ declare const CompiledSkinSchema: z.ZodObject<{
153
521
  }, z.core.$strip>;
154
522
  type CompiledSkin = z.infer<typeof CompiledSkinSchema>;
155
523
 
156
- /**
157
- * Site shapes — both the legacy template-keyed shape and the new
158
- * composition-keyed shape. getSite returns a discriminated union;
159
- * renderers branch on it.
160
- *
161
- * See /docs/superpowers/specs and plan file for architecture rationale.
162
- */
524
+ type SiteStyleSource = 'live-ds' | 'skin-snapshot' | 'legacy';
525
+ type SiteStyleSnapshot = {
526
+ libraryConfig: ComponentLibraryConfig;
527
+ dsOverrides: Record<string, string>;
528
+ source: SiteStyleSource;
529
+ recordId: string | null;
530
+ recordName: string | null;
531
+ frozenAt: number;
532
+ };
163
533
 
534
+ /** Section-enter animation preset ids. */
535
+ declare const SECTION_ANIMATION_PRESETS: readonly ["fade-up", "fade-in", "slide-in-left", "slide-in-right", "scale-in", "blur-in"];
536
+ type SectionAnimationPreset = (typeof SECTION_ANIMATION_PRESETS)[number];
537
+ type SectionAnimation = {
538
+ preset: SectionAnimationPreset;
539
+ /** Delay in ms before the animation starts after entering viewport. */
540
+ delay?: number;
541
+ /** Duration override in ms (default 600). */
542
+ duration?: number;
543
+ /** Stagger children by this many ms each (for grids/lists). */
544
+ stagger?: number;
545
+ };
164
546
  /**
165
547
  * One section rendered inside a composition.
166
548
  * `id` references the sections registry; `instanceId` is unique per
@@ -176,7 +558,23 @@ type SectionInstance = {
176
558
  /** Marketing hero: fill layout below navbar (default on when omitted). */
177
559
  fullHeight?: boolean;
178
560
  hidden?: boolean;
561
+ /** Columns this node occupies on the parent container's 12-column grid. */
562
+ span?: number;
563
+ /** Per-breakpoint span overrides, keyed to the @container/site breakpoints. */
564
+ spanAt?: {
565
+ sm?: number;
566
+ md?: number;
567
+ lg?: number;
568
+ };
569
+ /** Forward compat for P6b per-level overrides — CSS var bag applied on the node wrapper. */
570
+ overrides?: Record<string, string>;
179
571
  children?: SectionInstance[];
572
+ /** Section-enter animation triggered on viewport intersection. */
573
+ animation?: SectionAnimation;
574
+ /** Fingerprint of the pattern this node was expanded from: `<pattern-id>@<version>`. Root wrapper only. */
575
+ component?: string;
576
+ /** Reserved: raw CSS escape hatch for the power path. Nothing reads or writes it yet. */
577
+ advanced?: Record<string, string>;
180
578
  };
181
579
  declare const CompositionSiteSchema: z.ZodObject<{
182
580
  slug: z.ZodString;
@@ -184,21 +582,86 @@ declare const CompositionSiteSchema: z.ZodObject<{
184
582
  id: z.ZodString;
185
583
  sections: z.ZodDefault<z.ZodArray<z.ZodType<SectionInstance, unknown, z.core.$ZodTypeInternals<SectionInstance, unknown>>>>;
186
584
  }, z.core.$strip>;
585
+ pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
586
+ id: z.ZodString;
587
+ slug: z.ZodString;
588
+ title: z.ZodString;
589
+ sections: z.ZodDefault<z.ZodArray<z.ZodType<SectionInstance, unknown, z.core.$ZodTypeInternals<SectionInstance, unknown>>>>;
590
+ seo: z.ZodOptional<z.ZodLazy<z.ZodObject<{
591
+ title: z.ZodOptional<z.ZodString>;
592
+ description: z.ZodOptional<z.ZodString>;
593
+ ogType: z.ZodOptional<z.ZodEnum<{
594
+ article: "article";
595
+ website: "website";
596
+ profile: "profile";
597
+ }>>;
598
+ twitterCard: z.ZodOptional<z.ZodEnum<{
599
+ summary: "summary";
600
+ summary_large_image: "summary_large_image";
601
+ }>>;
602
+ keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
603
+ schemaOrgType: z.ZodOptional<z.ZodEnum<{
604
+ WebSite: "WebSite";
605
+ Person: "Person";
606
+ Organization: "Organization";
607
+ CreativeWork: "CreativeWork";
608
+ Product: "Product";
609
+ LocalBusiness: "LocalBusiness";
610
+ }>>;
611
+ canonicalUrl: z.ZodOptional<z.ZodString>;
612
+ twitterHandle: z.ZodOptional<z.ZodString>;
613
+ ogImageUrl: z.ZodOptional<z.ZodString>;
614
+ ogImageSource: z.ZodOptional<z.ZodEnum<{
615
+ snap: "snap";
616
+ upload: "upload";
617
+ }>>;
618
+ ogSnappedAt: z.ZodOptional<z.ZodNumber>;
619
+ robotsIndex: z.ZodOptional<z.ZodBoolean>;
620
+ faviconUrl: z.ZodOptional<z.ZodString>;
621
+ localBusiness: z.ZodOptional<z.ZodObject<{
622
+ type: z.ZodOptional<z.ZodString>;
623
+ telephone: z.ZodOptional<z.ZodString>;
624
+ email: z.ZodOptional<z.ZodString>;
625
+ address: z.ZodOptional<z.ZodObject<{
626
+ streetAddress: z.ZodOptional<z.ZodString>;
627
+ addressLocality: z.ZodOptional<z.ZodString>;
628
+ addressRegion: z.ZodOptional<z.ZodString>;
629
+ postalCode: z.ZodOptional<z.ZodString>;
630
+ addressCountry: z.ZodOptional<z.ZodString>;
631
+ }, z.core.$strip>>;
632
+ areaServed: z.ZodOptional<z.ZodString>;
633
+ priceRange: z.ZodOptional<z.ZodString>;
634
+ }, z.core.$strip>>;
635
+ geo: z.ZodOptional<z.ZodObject<{
636
+ region: z.ZodOptional<z.ZodString>;
637
+ placename: z.ZodOptional<z.ZodString>;
638
+ lat: z.ZodOptional<z.ZodNumber>;
639
+ lng: z.ZodOptional<z.ZodNumber>;
640
+ }, z.core.$strip>>;
641
+ }, z.core.$strip>>>;
642
+ hidden: z.ZodOptional<z.ZodBoolean>;
643
+ }, z.core.$strip>>>;
187
644
  brandColor: z.ZodOptional<z.ZodString>;
188
645
  theme: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
189
646
  base: z.ZodEnum<{
190
- mui: "mui";
191
647
  "zero-point": "zero-point";
648
+ mui: "mui";
192
649
  }>;
193
650
  accent: z.ZodString;
194
651
  typeCategory: z.ZodEnum<{
195
- sans: "sans";
196
652
  serif: "serif";
653
+ display: "display";
654
+ sans: "sans";
197
655
  mono: "mono";
656
+ handwriting: "handwriting";
198
657
  }>;
199
658
  }, z.core.$strip>]>>;
200
659
  designSystemId: z.ZodOptional<z.ZodString>;
201
660
  skinId: z.ZodOptional<z.ZodString>;
661
+ surfaceKind: z.ZodOptional<z.ZodEnum<{
662
+ marketing: "marketing";
663
+ store: "store";
664
+ }>>;
202
665
  seo: z.ZodOptional<z.ZodObject<{
203
666
  title: z.ZodOptional<z.ZodString>;
204
667
  description: z.ZodOptional<z.ZodString>;
@@ -229,6 +692,7 @@ declare const CompositionSiteSchema: z.ZodObject<{
229
692
  }>>;
230
693
  ogSnappedAt: z.ZodOptional<z.ZodNumber>;
231
694
  robotsIndex: z.ZodOptional<z.ZodBoolean>;
695
+ faviconUrl: z.ZodOptional<z.ZodString>;
232
696
  localBusiness: z.ZodOptional<z.ZodObject<{
233
697
  type: z.ZodOptional<z.ZodString>;
234
698
  telephone: z.ZodOptional<z.ZodString>;
@@ -251,12 +715,14 @@ declare const CompositionSiteSchema: z.ZodObject<{
251
715
  }, z.core.$strip>>;
252
716
  }, z.core.$strip>>;
253
717
  origin: z.ZodOptional<z.ZodEnum<{
254
- template: "template";
718
+ chat: "chat";
719
+ builder: "builder";
255
720
  "wizard-linkinbio": "wizard-linkinbio";
256
721
  "wizard-marketing": "wizard-marketing";
257
722
  "wizard-portfolio": "wizard-portfolio";
258
723
  "wizard-blog": "wizard-blog";
259
- builder: "builder";
724
+ "wizard-professional": "wizard-professional";
725
+ template: "template";
260
726
  }>>;
261
727
  mode: z.ZodDefault<z.ZodEnum<{
262
728
  builder: "builder";
@@ -320,8 +786,281 @@ declare const CompositionSiteSchema: z.ZodObject<{
320
786
  stagingPublishedAt: z.ZodOptional<z.ZodNumber>;
321
787
  productionPublishedAt: z.ZodOptional<z.ZodNumber>;
322
788
  googleAnalyticsId: z.ZodOptional<z.ZodString>;
789
+ clientVisibility: z.ZodOptional<z.ZodObject<{
790
+ stagingMode: z.ZodEnum<{
791
+ password: "password";
792
+ public: "public";
793
+ }>;
794
+ productionMode: z.ZodEnum<{
795
+ coming_soon: "coming_soon";
796
+ live: "live";
797
+ }>;
798
+ hasStagingPassword: z.ZodBoolean;
799
+ ageGateMinimum: z.ZodOptional<z.ZodNumber>;
800
+ }, z.core.$strip>>;
801
+ commerce: z.ZodOptional<z.ZodObject<{
802
+ enabled: z.ZodDefault<z.ZodBoolean>;
803
+ checkoutUrl: z.ZodOptional<z.ZodString>;
804
+ currency: z.ZodDefault<z.ZodString>;
805
+ }, z.core.$strip>>;
806
+ onboarding: z.ZodOptional<z.ZodObject<{
807
+ phase: z.ZodEnum<{
808
+ slug: "slug";
809
+ intake: "intake";
810
+ brief_confirm: "brief_confirm";
811
+ kit_building: "kit_building";
812
+ styles_review: "styles_review";
813
+ layout_pick: "layout_pick";
814
+ content_sources: "content_sources";
815
+ landing_building: "landing_building";
816
+ spec: "spec";
817
+ scaffold_review: "scaffold_review";
818
+ ready: "ready";
819
+ }>;
820
+ brief: z.ZodOptional<z.ZodObject<{
821
+ name: z.ZodString;
822
+ category: z.ZodEnum<{
823
+ "local-service": "local-service";
824
+ portfolio: "portfolio";
825
+ "link-in-bio": "link-in-bio";
826
+ creator: "creator";
827
+ hospitality: "hospitality";
828
+ professional: "professional";
829
+ ecommerce: "ecommerce";
830
+ general: "general";
831
+ }>;
832
+ audience: z.ZodString;
833
+ voice: z.ZodEnum<{
834
+ professional: "professional";
835
+ friendly: "friendly";
836
+ bold: "bold";
837
+ minimal: "minimal";
838
+ luxury: "luxury";
839
+ }>;
840
+ designSystemRef: z.ZodDiscriminatedUnion<[z.ZodObject<{
841
+ kind: z.ZodLiteral<"account-default">;
842
+ }, z.core.$strip>, z.ZodObject<{
843
+ kind: z.ZodLiteral<"skin">;
844
+ skinId: z.ZodString;
845
+ }, z.core.$strip>, z.ZodObject<{
846
+ kind: z.ZodLiteral<"design-system">;
847
+ id: z.ZodString;
848
+ }, z.core.$strip>], "kind">;
849
+ location: z.ZodOptional<z.ZodString>;
850
+ primaryGoal: z.ZodOptional<z.ZodEnum<{
851
+ portfolio: "portfolio";
852
+ book: "book";
853
+ call: "call";
854
+ shop: "shop";
855
+ donate: "donate";
856
+ }>>;
857
+ referenceUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
858
+ freeformNotes: z.ZodOptional<z.ZodString>;
859
+ templateId: z.ZodOptional<z.ZodString>;
860
+ remix: z.ZodOptional<z.ZodObject<{
861
+ url: z.ZodString;
862
+ seed: z.ZodObject<{
863
+ fonts: z.ZodObject<{
864
+ display: z.ZodString;
865
+ body: z.ZodString;
866
+ }, z.core.$strip>;
867
+ palette: z.ZodArray<z.ZodString>;
868
+ radius: z.ZodOptional<z.ZodString>;
869
+ vibe: z.ZodOptional<z.ZodString>;
870
+ harvestedFrom: z.ZodOptional<z.ZodString>;
871
+ }, z.core.$strip>;
872
+ copy: z.ZodOptional<z.ZodObject<{
873
+ headline: z.ZodOptional<z.ZodString>;
874
+ sections: z.ZodArray<z.ZodObject<{
875
+ title: z.ZodOptional<z.ZodString>;
876
+ body: z.ZodString;
877
+ }, z.core.$strip>>;
878
+ contact: z.ZodOptional<z.ZodString>;
879
+ }, z.core.$strip>>;
880
+ }, z.core.$strip>>;
881
+ confirmedAt: z.ZodOptional<z.ZodNumber>;
882
+ }, z.core.$strip>>;
883
+ briefSlots: z.ZodOptional<z.ZodArray<z.ZodString>>;
884
+ designSpec: z.ZodOptional<z.ZodObject<{
885
+ specId: z.ZodString;
886
+ sections: z.ZodArray<z.ZodObject<{
887
+ sectionId: z.ZodString;
888
+ instanceId: z.ZodString;
889
+ purpose: z.ZodString;
890
+ copyHints: z.ZodRecord<z.ZodString, z.ZodString>;
891
+ layout: z.ZodOptional<z.ZodString>;
892
+ }, z.core.$strip>>;
893
+ visualLanguage: z.ZodObject<{
894
+ mood: z.ZodString;
895
+ skinId: z.ZodString;
896
+ density: z.ZodEnum<{
897
+ airy: "airy";
898
+ balanced: "balanced";
899
+ dense: "dense";
900
+ }>;
901
+ }, z.core.$strip>;
902
+ copyStrategy: z.ZodObject<{
903
+ voice: z.ZodEnum<{
904
+ professional: "professional";
905
+ friendly: "friendly";
906
+ bold: "bold";
907
+ minimal: "minimal";
908
+ luxury: "luxury";
909
+ }>;
910
+ headlineAngle: z.ZodString;
911
+ ctaPrimary: z.ZodString;
912
+ }, z.core.$strip>;
913
+ archetypeManifestId: z.ZodOptional<z.ZodString>;
914
+ referenceNotes: z.ZodOptional<z.ZodArray<z.ZodString>>;
915
+ createdAt: z.ZodNumber;
916
+ }, z.core.$strip>>;
917
+ complete: z.ZodOptional<z.ZodObject<{
918
+ completeId: z.ZodString;
919
+ briefRef: z.ZodString;
920
+ designSpecRef: z.ZodString;
921
+ sections: z.ZodArray<z.ZodObject<{
922
+ sectionId: z.ZodString;
923
+ instanceId: z.ZodString;
924
+ copy: z.ZodRecord<z.ZodString, z.ZodString>;
925
+ layout: z.ZodOptional<z.ZodString>;
926
+ }, z.core.$strip>>;
927
+ skinId: z.ZodString;
928
+ createdAt: z.ZodNumber;
929
+ }, z.core.$strip>>;
930
+ annotations: z.ZodOptional<z.ZodArray<z.ZodObject<{
931
+ instanceId: z.ZodString;
932
+ note: z.ZodString;
933
+ createdAt: z.ZodNumber;
934
+ }, z.core.$strip>>>;
935
+ chatLog: z.ZodOptional<z.ZodArray<z.ZodObject<{
936
+ id: z.ZodString;
937
+ role: z.ZodEnum<{
938
+ user: "user";
939
+ assistant: "assistant";
940
+ }>;
941
+ content: z.ZodString;
942
+ createdAt: z.ZodNumber;
943
+ }, z.core.$strip>>>;
944
+ startAnswers: z.ZodOptional<z.ZodObject<{
945
+ purpose: z.ZodString;
946
+ name: z.ZodString;
947
+ feel: z.ZodString;
948
+ }, z.core.$strip>>;
949
+ startReference: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
950
+ kind: z.ZodLiteral<"url">;
951
+ url: z.ZodString;
952
+ }, z.core.$strip>, z.ZodObject<{
953
+ kind: z.ZodLiteral<"design-kit">;
954
+ fileName: z.ZodString;
955
+ hints: z.ZodObject<{
956
+ fonts: z.ZodArray<z.ZodString>;
957
+ palette: z.ZodArray<z.ZodString>;
958
+ textSkeleton: z.ZodString;
959
+ }, z.core.$strip>;
960
+ }, z.core.$strip>, z.ZodObject<{
961
+ kind: z.ZodLiteral<"image">;
962
+ fileName: z.ZodString;
963
+ palette: z.ZodArray<z.ZodString>;
964
+ }, z.core.$strip>], "kind">>;
965
+ pagePatternId: z.ZodOptional<z.ZodString>;
966
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
967
+ id: z.ZodString;
968
+ kind: z.ZodEnum<{
969
+ url: "url";
970
+ doc: "doc";
971
+ sheet: "sheet";
972
+ drive: "drive";
973
+ }>;
974
+ url: z.ZodString;
975
+ title: z.ZodString;
976
+ summary: z.ZodString;
977
+ text: z.ZodOptional<z.ZodString>;
978
+ rows: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString>>>;
979
+ media: z.ZodOptional<z.ZodArray<z.ZodObject<{
980
+ id: z.ZodString;
981
+ name: z.ZodString;
982
+ thumb: z.ZodString;
983
+ }, z.core.$strip>>>;
984
+ addedAt: z.ZodNumber;
985
+ }, z.core.$strip>>>;
986
+ voice: z.ZodOptional<z.ZodObject<{
987
+ tone: z.ZodOptional<z.ZodString>;
988
+ audience: z.ZodOptional<z.ZodString>;
989
+ avoid: z.ZodOptional<z.ZodString>;
990
+ }, z.core.$strip>>;
991
+ slugProvisional: z.ZodOptional<z.ZodBoolean>;
992
+ kitDraftStartedAt: z.ZodOptional<z.ZodNumber>;
993
+ }, z.core.$strip>>;
994
+ kit: z.ZodOptional<z.ZodObject<{
995
+ kitId: z.ZodString;
996
+ briefRef: z.ZodString;
997
+ createdAt: z.ZodNumber;
998
+ tokens: z.ZodObject<{
999
+ colors: z.ZodRecord<z.ZodString, z.ZodString>;
1000
+ fonts: z.ZodObject<{
1001
+ display: z.ZodString;
1002
+ body: z.ZodString;
1003
+ }, z.core.$strip>;
1004
+ radius: z.ZodString;
1005
+ buttonRadius: z.ZodOptional<z.ZodString>;
1006
+ surfaceRadius: z.ZodOptional<z.ZodString>;
1007
+ density: z.ZodEnum<{
1008
+ airy: "airy";
1009
+ balanced: "balanced";
1010
+ dense: "dense";
1011
+ }>;
1012
+ typeScale: z.ZodOptional<z.ZodEnum<{
1013
+ sm: "sm";
1014
+ md: "md";
1015
+ lg: "lg";
1016
+ xl: "xl";
1017
+ xs: "xs";
1018
+ }>>;
1019
+ typeRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1020
+ fontSize: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1021
+ lineHeight: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1022
+ letterSpacing: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1023
+ wordSpacing: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1024
+ fontWeight: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1025
+ textTransform: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1026
+ }, z.core.$strip>>>;
1027
+ }, z.core.$strip>;
1028
+ parts: z.ZodArray<z.ZodObject<{
1029
+ id: z.ZodString;
1030
+ kind: z.ZodEnum<{
1031
+ text: "text";
1032
+ image: "image";
1033
+ button: "button";
1034
+ heading: "heading";
1035
+ card: "card";
1036
+ "section-shell": "section-shell";
1037
+ nav: "nav";
1038
+ footer: "footer";
1039
+ "cta-row": "cta-row";
1040
+ }>;
1041
+ variants: z.ZodOptional<z.ZodArray<z.ZodString>>;
1042
+ defaultProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1043
+ }, z.core.$strip>>;
1044
+ rules: z.ZodObject<{
1045
+ voice: z.ZodString;
1046
+ do: z.ZodArray<z.ZodString>;
1047
+ dont: z.ZodArray<z.ZodString>;
1048
+ }, z.core.$strip>;
1049
+ }, z.core.$strip>>;
1050
+ kitPages: z.ZodOptional<z.ZodArray<z.ZodObject<{
1051
+ pageId: z.ZodString;
1052
+ path: z.ZodString;
1053
+ title: z.ZodOptional<z.ZodString>;
1054
+ kitRef: z.ZodString;
1055
+ createdAt: z.ZodNumber;
1056
+ sections: z.ZodArray<z.ZodType<LandingIRNode, unknown, z.core.$ZodTypeInternals<LandingIRNode, unknown>>>;
1057
+ }, z.core.$strip>>>;
323
1058
  }, z.core.$strip>;
324
- type CompositionSite = z.infer<typeof CompositionSiteSchema>;
1059
+ type CompositionSite = z.infer<typeof CompositionSiteSchema> & {
1060
+ onboarding?: SiteOnboarding;
1061
+ /** Frozen resolved style written at publish; hosted render prefers this. */
1062
+ styleSnapshot?: SiteStyleSnapshot;
1063
+ };
325
1064
 
326
1065
  /**
327
1066
  * Props every section component receives. `copy` already has the instance
@@ -341,6 +1080,12 @@ interface SectionProps {
341
1080
  fullHeight?: boolean;
342
1081
  /** Nested blocks rendered inside layout shells. */
343
1082
  slotContent?: ReactNode;
1083
+ /**
1084
+ * `layout-container` only. The explicit 12-column span of each direct child,
1085
+ * set by the renderers when any child carries one. Present means the container
1086
+ * drops its preset classes for `grid-cols-12`; absent means nothing changes.
1087
+ */
1088
+ childSpans?: number[];
344
1089
  /** Builder-only — open insert drawer on a tab (layout shells). */
345
1090
  builderInsert?: {
346
1091
  openTab: (tab: 'structure' | 'components') => void;
@@ -361,7 +1106,7 @@ interface SiteRendererProps {
361
1106
  * Mirrors the hosted CompositionRenderer loop without RSC/async/Firebase:
362
1107
  * sections are supplied via `registry` rather than the global getSection.
363
1108
  */
364
- declare function SiteRenderer({ site, registry, scope, compiledSkin }: SiteRendererProps): react.JSX.Element;
1109
+ declare function SiteRenderer({ site, registry, scope, compiledSkin }: SiteRendererProps): React.JSX.Element;
365
1110
 
366
1111
  /** Render a composition to a static HTML string (no React runtime needed). */
367
1112
  declare function renderSiteToHtml(site: CompositionSite, registry: SectionRegistry, scope?: string, compiledSkin?: CompiledSkin): string;