@nersh/render 0.2.5 → 0.3.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.
package/dist/index.d.mts CHANGED
@@ -2,13 +2,6 @@ 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
5
  /** Harvested design language — steers kit Stage 1 as strong defaults, not locks. */
13
6
  type PromptTemplateKitSeed = {
14
7
  fonts: {
@@ -65,11 +58,11 @@ type HarvestHints = {
65
58
 
66
59
  /**
67
60
  * 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
61
+ * onboarding record verbatim until sign-in; the style build is the only thing
69
62
  * that reads it, and only after the mint.
70
63
  *
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
64
+ * - `url`: a site to harvest. Deferred entirely: no fetch, no model call
65
+ * happens until the style build runs, since a harvest is a model call and
73
66
  * that must never happen before the sign-in gate.
74
67
  * - `design-kit`: a `.dc.html` file. `hints` is pulled client-side with the
75
68
  * same free, model-less regex pass `harvestSite` itself uses for its own
@@ -90,135 +83,6 @@ type StartReference = {
90
83
  palette: string[];
91
84
  };
92
85
 
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
-
222
86
  /**
223
87
  * Component library configuration — provider-agnostic skin source of truth.
224
88
  *
@@ -247,10 +111,10 @@ declare const ComponentLibraryConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject
247
111
  rhea: "rhea";
248
112
  }>>;
249
113
  baseColor: z.ZodDefault<z.ZodEnum<{
114
+ neutral: "neutral";
115
+ stone: "stone";
250
116
  zinc: "zinc";
251
117
  slate: "slate";
252
- stone: "stone";
253
- neutral: "neutral";
254
118
  gray: "gray";
255
119
  mauve: "mauve";
256
120
  olive: "olive";
@@ -258,56 +122,56 @@ declare const ComponentLibraryConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject
258
122
  taupe: "taupe";
259
123
  }>>;
260
124
  theme: z.ZodDefault<z.ZodEnum<{
125
+ neutral: "neutral";
126
+ stone: "stone";
261
127
  zinc: "zinc";
262
- blue: "blue";
263
128
  slate: "slate";
264
- stone: "stone";
265
- neutral: "neutral";
266
129
  gray: "gray";
267
130
  mauve: "mauve";
268
131
  olive: "olive";
269
132
  mist: "mist";
270
133
  taupe: "taupe";
271
- green: "green";
272
- orange: "orange";
273
134
  red: "red";
274
135
  rose: "rose";
275
- violet: "violet";
136
+ orange: "orange";
276
137
  amber: "amber";
277
138
  yellow: "yellow";
278
139
  lime: "lime";
140
+ green: "green";
279
141
  emerald: "emerald";
280
142
  teal: "teal";
281
143
  cyan: "cyan";
282
144
  sky: "sky";
145
+ blue: "blue";
283
146
  indigo: "indigo";
147
+ violet: "violet";
284
148
  purple: "purple";
285
149
  fuchsia: "fuchsia";
286
150
  pink: "pink";
287
151
  }>>;
288
152
  chartColor: z.ZodDefault<z.ZodEnum<{
289
- zinc: "zinc";
290
- blue: "blue";
291
- stone: "stone";
292
153
  neutral: "neutral";
154
+ stone: "stone";
155
+ zinc: "zinc";
293
156
  gray: "gray";
294
157
  mauve: "mauve";
295
158
  olive: "olive";
296
159
  mist: "mist";
297
160
  taupe: "taupe";
298
- green: "green";
299
- orange: "orange";
300
161
  red: "red";
301
162
  rose: "rose";
302
- violet: "violet";
163
+ orange: "orange";
303
164
  amber: "amber";
304
165
  yellow: "yellow";
305
166
  lime: "lime";
167
+ green: "green";
306
168
  emerald: "emerald";
307
169
  teal: "teal";
308
170
  cyan: "cyan";
309
171
  sky: "sky";
172
+ blue: "blue";
310
173
  indigo: "indigo";
174
+ violet: "violet";
311
175
  purple: "purple";
312
176
  fuchsia: "fuchsia";
313
177
  pink: "pink";
@@ -336,8 +200,8 @@ declare const ComponentLibraryConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject
336
200
  "inverted-translucent": "inverted-translucent";
337
201
  }>>;
338
202
  menuAccent: z.ZodDefault<z.ZodEnum<{
339
- bold: "bold";
340
203
  subtle: "subtle";
204
+ bold: "bold";
341
205
  }>>;
342
206
  layout: z.ZodPrefault<z.ZodObject<{
343
207
  frame: z.ZodDefault<z.ZodEnum<{
@@ -360,8 +224,8 @@ declare const ComponentLibraryConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject
360
224
  dark: "dark";
361
225
  }>;
362
226
  density: z.ZodDefault<z.ZodEnum<{
363
- standard: "standard";
364
227
  comfortable: "comfortable";
228
+ standard: "standard";
365
229
  compact: "compact";
366
230
  }>>;
367
231
  primaryColor: z.ZodOptional<z.ZodString>;
@@ -397,10 +261,10 @@ declare const CompiledSkinSchema: z.ZodObject<{
397
261
  rhea: "rhea";
398
262
  }>>;
399
263
  baseColor: z.ZodDefault<z.ZodEnum<{
264
+ neutral: "neutral";
265
+ stone: "stone";
400
266
  zinc: "zinc";
401
267
  slate: "slate";
402
- stone: "stone";
403
- neutral: "neutral";
404
268
  gray: "gray";
405
269
  mauve: "mauve";
406
270
  olive: "olive";
@@ -408,56 +272,56 @@ declare const CompiledSkinSchema: z.ZodObject<{
408
272
  taupe: "taupe";
409
273
  }>>;
410
274
  theme: z.ZodDefault<z.ZodEnum<{
275
+ neutral: "neutral";
276
+ stone: "stone";
411
277
  zinc: "zinc";
412
- blue: "blue";
413
278
  slate: "slate";
414
- stone: "stone";
415
- neutral: "neutral";
416
279
  gray: "gray";
417
280
  mauve: "mauve";
418
281
  olive: "olive";
419
282
  mist: "mist";
420
283
  taupe: "taupe";
421
- green: "green";
422
- orange: "orange";
423
284
  red: "red";
424
285
  rose: "rose";
425
- violet: "violet";
286
+ orange: "orange";
426
287
  amber: "amber";
427
288
  yellow: "yellow";
428
289
  lime: "lime";
290
+ green: "green";
429
291
  emerald: "emerald";
430
292
  teal: "teal";
431
293
  cyan: "cyan";
432
294
  sky: "sky";
295
+ blue: "blue";
433
296
  indigo: "indigo";
297
+ violet: "violet";
434
298
  purple: "purple";
435
299
  fuchsia: "fuchsia";
436
300
  pink: "pink";
437
301
  }>>;
438
302
  chartColor: z.ZodDefault<z.ZodEnum<{
439
- zinc: "zinc";
440
- blue: "blue";
441
- stone: "stone";
442
303
  neutral: "neutral";
304
+ stone: "stone";
305
+ zinc: "zinc";
443
306
  gray: "gray";
444
307
  mauve: "mauve";
445
308
  olive: "olive";
446
309
  mist: "mist";
447
310
  taupe: "taupe";
448
- green: "green";
449
- orange: "orange";
450
311
  red: "red";
451
312
  rose: "rose";
452
- violet: "violet";
313
+ orange: "orange";
453
314
  amber: "amber";
454
315
  yellow: "yellow";
455
316
  lime: "lime";
317
+ green: "green";
456
318
  emerald: "emerald";
457
319
  teal: "teal";
458
320
  cyan: "cyan";
459
321
  sky: "sky";
322
+ blue: "blue";
460
323
  indigo: "indigo";
324
+ violet: "violet";
461
325
  purple: "purple";
462
326
  fuchsia: "fuchsia";
463
327
  pink: "pink";
@@ -486,8 +350,8 @@ declare const CompiledSkinSchema: z.ZodObject<{
486
350
  "inverted-translucent": "inverted-translucent";
487
351
  }>>;
488
352
  menuAccent: z.ZodDefault<z.ZodEnum<{
489
- bold: "bold";
490
353
  subtle: "subtle";
354
+ bold: "bold";
491
355
  }>>;
492
356
  layout: z.ZodPrefault<z.ZodObject<{
493
357
  frame: z.ZodDefault<z.ZodEnum<{
@@ -510,8 +374,8 @@ declare const CompiledSkinSchema: z.ZodObject<{
510
374
  dark: "dark";
511
375
  }>;
512
376
  density: z.ZodDefault<z.ZodEnum<{
513
- standard: "standard";
514
377
  comfortable: "comfortable";
378
+ standard: "standard";
515
379
  compact: "compact";
516
380
  }>>;
517
381
  primaryColor: z.ZodOptional<z.ZodString>;
@@ -521,6 +385,194 @@ declare const CompiledSkinSchema: z.ZodObject<{
521
385
  }, z.core.$strip>;
522
386
  type CompiledSkin = z.infer<typeof CompiledSkinSchema>;
523
387
 
388
+ /**
389
+ * What the Styles stage asks the model for: five decisions, not a whole design
390
+ * system. Everything else the skin needs is derived deterministically from
391
+ * these, so a valid brief always compiles to a valid Foundation record.
392
+ */
393
+ declare const StyleBriefSchema: z.ZodObject<{
394
+ primaryColor: z.ZodObject<{
395
+ name: z.ZodString;
396
+ hex: z.ZodString;
397
+ }, z.core.$strip>;
398
+ secondaryColor: z.ZodOptional<z.ZodObject<{
399
+ name: z.ZodString;
400
+ hex: z.ZodString;
401
+ }, z.core.$strip>>;
402
+ pairingId: z.ZodEnum<{
403
+ "editorial-fraunces": "editorial-fraunces";
404
+ "classic-playfair": "classic-playfair";
405
+ "serif-sans-cormorant": "serif-sans-cormorant";
406
+ "literary-libre": "literary-libre";
407
+ "geometric-space": "geometric-space";
408
+ "swiss-archivo": "swiss-archivo";
409
+ "modern-sora": "modern-sora";
410
+ "display-unbounded": "display-unbounded";
411
+ "humanist-work": "humanist-work";
412
+ "rounded-nunito": "rounded-nunito";
413
+ "warm-karla": "warm-karla";
414
+ "grounded-outfit": "grounded-outfit";
415
+ "mono-jetbrains": "mono-jetbrains";
416
+ "mono-space": "mono-space";
417
+ "condensed-oswald": "condensed-oswald";
418
+ "slab-zilla": "slab-zilla";
419
+ }>;
420
+ radius: z.ZodEnum<{
421
+ default: "default";
422
+ none: "none";
423
+ sm: "sm";
424
+ md: "md";
425
+ lg: "lg";
426
+ xl: "xl";
427
+ }>;
428
+ density: z.ZodEnum<{
429
+ default: "default";
430
+ comfortable: "comfortable";
431
+ compact: "compact";
432
+ }>;
433
+ }, z.core.$strip>;
434
+ type StyleBrief = z.infer<typeof StyleBriefSchema>;
435
+
436
+ declare const SITE_CATEGORY_IDS: readonly ["local-service", "portfolio", "link-in-bio", "professional", "ecommerce", "hospitality", "creator", "general"];
437
+ type SiteCategoryId = (typeof SITE_CATEGORY_IDS)[number];
438
+ type SiteVoiceId = 'friendly' | 'professional' | 'bold' | 'minimal' | 'luxury';
439
+ type SiteGoalId = 'book' | 'call' | 'shop' | 'portfolio' | 'donate';
440
+ type DesignSystemRef = {
441
+ kind: 'account-default';
442
+ } | {
443
+ kind: 'skin';
444
+ skinId: string;
445
+ } | {
446
+ kind: 'design-system';
447
+ id: string;
448
+ };
449
+ /** Verbatim human-authored copy pulled from the remixed site — transcribed, never marketing-ified. */
450
+ type RemixCopyDigest = {
451
+ headline?: string;
452
+ sections: Array<{
453
+ title?: string;
454
+ body: string;
455
+ }>;
456
+ contact?: string;
457
+ };
458
+ type SiteBriefRemix = {
459
+ url: string;
460
+ seed: PromptTemplateKitSeed;
461
+ /** Only present when remixing the user's own site — community remixes are seed-only. */
462
+ copy?: RemixCopyDigest;
463
+ };
464
+ type SiteBrief = {
465
+ name: string;
466
+ category: SiteCategoryId;
467
+ audience: string;
468
+ voice: SiteVoiceId;
469
+ designSystemRef: DesignSystemRef;
470
+ location?: string;
471
+ primaryGoal?: SiteGoalId;
472
+ referenceUrls?: string[];
473
+ freeformNotes?: string;
474
+ /** Prompt-template catalog id when the site started from a template; its kitSeed steers Stage 1. */
475
+ templateId?: string;
476
+ /** Harvested design language + verbatim copy from the user's current site; wins over templateId. */
477
+ remix?: SiteBriefRemix;
478
+ confirmedAt?: number;
479
+ };
480
+ type DesignSpecSection = {
481
+ sectionId: string;
482
+ instanceId: string;
483
+ purpose: string;
484
+ copyHints: Record<string, string>;
485
+ layout?: string;
486
+ };
487
+ type DesignSpec = {
488
+ specId: string;
489
+ sections: DesignSpecSection[];
490
+ visualLanguage: {
491
+ mood: string;
492
+ skinId: string;
493
+ density: 'airy' | 'balanced' | 'dense';
494
+ };
495
+ copyStrategy: {
496
+ voice: SiteVoiceId;
497
+ headlineAngle: string;
498
+ ctaPrimary: string;
499
+ };
500
+ archetypeManifestId?: string;
501
+ referenceNotes?: string[];
502
+ createdAt: number;
503
+ };
504
+ type CompleteSection = {
505
+ sectionId: string;
506
+ instanceId: string;
507
+ copy: Record<string, string>;
508
+ layout?: string;
509
+ };
510
+ type Complete = {
511
+ completeId: string;
512
+ briefRef: string;
513
+ designSpecRef: string;
514
+ /** Taxonomy-correlated copy per DesignSpec section — display/count only, never persisted as-is. */
515
+ sections: CompleteSection[];
516
+ /**
517
+ * The real, pattern-aware tree to persist (see `assembleComplete`'s
518
+ * `expandedStructureFor`) — a literal section's own copy lands here under its
519
+ * unchanged sectionId/instanceId; a taxonomy section's copy is translated first.
520
+ */
521
+ structure: SectionInstance[];
522
+ /** `"<instanceId>.<slot>"` -> value, ready to group into `update_copy` patches. */
523
+ copyOverrides: Record<string, string>;
524
+ skinId: string;
525
+ createdAt: number;
526
+ };
527
+ type SpecAnnotation = {
528
+ instanceId: string;
529
+ note: string;
530
+ createdAt: number;
531
+ };
532
+ type OnboardingChatMessage = {
533
+ id: string;
534
+ role: 'user' | 'assistant';
535
+ content: string;
536
+ createdAt: number;
537
+ };
538
+ declare const ONBOARDING_PHASES: readonly ["slug", "intake", "brief_confirm", "kit_building", "styles_review", "layout_pick", "content_sources", "landing_building", "spec", "scaffold_review", "ready"];
539
+ type OnboardingPhase = (typeof ONBOARDING_PHASES)[number];
540
+ type SiteOnboarding = {
541
+ phase: OnboardingPhase;
542
+ brief?: SiteBrief;
543
+ /**
544
+ * Brief keys the user actually answered. `brief` is coerced on every write so
545
+ * the RTDB round trip validates, which backfills every required slot from
546
+ * defaults — so the brief alone cannot say what is known and what is filler.
547
+ */
548
+ briefSlots?: string[];
549
+ /** The five style decisions the Styles stage drafted; the Foundation skin is derived from it. */
550
+ styleBrief?: StyleBrief;
551
+ designSpec?: DesignSpec;
552
+ complete?: Complete;
553
+ annotations?: SpecAnnotation[];
554
+ chatLog?: OnboardingChatMessage[];
555
+ startAnswers?: {
556
+ purpose: string;
557
+ name: string;
558
+ feel: string;
559
+ };
560
+ /** Attached at the "how should it feel" turn; read once by kit generation. */
561
+ startReference?: StartReference;
562
+ pagePatternId?: string;
563
+ sources?: ContentSource[];
564
+ voice?: ContentVoice;
565
+ slugProvisional?: boolean;
566
+ /**
567
+ * When the kit draft was first fired for this site. Kit generation spends,
568
+ * and the site is minted at `kit_building`, so without a record on the
569
+ * server a reload before the first kit lands would fire the generate call a
570
+ * second time. A per-mount ref cannot survive a remount; this can.
571
+ * Cleared by the Retry button, which is the user asking to spend again.
572
+ */
573
+ kitDraftStartedAt?: number;
574
+ };
575
+
524
576
  type SiteStyleSource = 'live-ds' | 'skin-snapshot' | 'legacy';
525
577
  type SiteStyleSnapshot = {
526
578
  libraryConfig: ComponentLibraryConfig;
@@ -531,6 +583,44 @@ type SiteStyleSnapshot = {
531
583
  frozenAt: number;
532
584
  };
533
585
 
586
+ /**
587
+ * The per-node legacy token vocabulary.
588
+ *
589
+ * A closed set of CSS custom properties a node can declare in `styles.desktop`
590
+ * (node styles keep them as tokens the components read as flags; the retired
591
+ * `overrides` bag held the same keys). Anything outside the vocabulary is
592
+ * dropped on write and on read, so a stale or hand-written value can never
593
+ * paint a value the editor has no control for.
594
+ */
595
+ declare const OVERRIDE_KEYS: readonly ["--section-bg", "--section-padding", "--section-divider", "--font-heading", "--font-body", "--radius", "--card-bg", "--media-panel-min-height", "--band-gradient-from", "--band-gradient-via", "--band-gradient-to", "--primary", "--text-color", "--text-align", "--card-border-width"];
596
+ type OverrideKey = (typeof OVERRIDE_KEYS)[number];
597
+
598
+ /**
599
+ * The node style vocabulary: every CSS property a node may declare, what each accepts, the
600
+ * design-system presets it offers, which element it paints and which node kinds show it.
601
+ * One table drives validation, the emitter, the panel rows, the tool schema and the words
602
+ * the tool refuses with. Plain TS with one import, so the hosted graph gains nothing else.
603
+ */
604
+
605
+ declare const STYLE_BREAKPOINTS: readonly ["desktop", "tablet", "phone"];
606
+ type StyleBreakpoint = (typeof STYLE_BREAKPOINTS)[number];
607
+ declare const STYLE_PROPERTY_NAMES: readonly ["width", "height", "min-width", "min-height", "max-width", "max-height", "aspect-ratio", "position", "top", "right", "bottom", "left", "z-index", "margin-top", "margin-right", "margin-bottom", "margin-left", "padding-top", "padding-right", "padding-bottom", "padding-left", "gap", "background-color", "border-top-width", "border-right-width", "border-bottom-width", "border-left-width", "border-top-style", "border-right-style", "border-bottom-style", "border-left-style", "border-top-color", "border-right-color", "border-bottom-color", "border-left-color", "border-top-left-radius", "border-top-right-radius", "border-bottom-right-radius", "border-bottom-left-radius", "box-shadow", "opacity", "overflow", "font-size", "font-weight", "line-height", "letter-spacing", "color", "text-align", "filter", "scale", "rotate", "translate"];
608
+ type StyleProperty = (typeof STYLE_PROPERTY_NAMES)[number];
609
+ /** A stored key: a CSS longhand from the table, or a legacy override custom property. */
610
+ type StyleKey = StyleProperty | OverrideKey;
611
+ /** Property name to value, for one breakpoint. */
612
+ type StyleDecls = Partial<Record<StyleKey, string>>;
613
+ /** Breakpoint to declarations. */
614
+ type NodeStyles = Partial<Record<StyleBreakpoint, StyleDecls>>;
615
+
616
+ /**
617
+ * Site shapes — both the legacy template-keyed shape and the new
618
+ * composition-keyed shape. getSite returns a discriminated union;
619
+ * renderers branch on it.
620
+ *
621
+ * See /docs/superpowers/specs and plan file for architecture rationale.
622
+ */
623
+
534
624
  /** Section-enter animation preset ids. */
535
625
  declare const SECTION_ANIMATION_PRESETS: readonly ["fade-up", "fade-in", "slide-in-left", "slide-in-right", "scale-in", "blur-in"];
536
626
  type SectionAnimationPreset = (typeof SECTION_ANIMATION_PRESETS)[number];
@@ -554,6 +644,16 @@ type SectionInstance = {
554
644
  id: string;
555
645
  instanceId: string;
556
646
  layout?: string;
647
+ /** Author-given name shown in the Navigator instead of the section display name. */
648
+ label?: string;
649
+ /** Locked nodes refuse every structural edit until they are unlocked. */
650
+ locked?: boolean;
651
+ /** Container child spacing step. */
652
+ gap?: 'flush' | 'tight' | 'default' | 'wide';
653
+ /** Container cross-axis alignment. */
654
+ align?: 'start' | 'center' | 'stretch' | 'end';
655
+ /** Container main-axis distribution. */
656
+ justify?: 'start' | 'end' | 'between';
557
657
  fullBleed?: boolean;
558
658
  /** Marketing hero: fill layout below navbar (default on when omitted). */
559
659
  fullHeight?: boolean;
@@ -566,8 +666,6 @@ type SectionInstance = {
566
666
  md?: number;
567
667
  lg?: number;
568
668
  };
569
- /** Forward compat for P6b per-level overrides — CSS var bag applied on the node wrapper. */
570
- overrides?: Record<string, string>;
571
669
  children?: SectionInstance[];
572
670
  /** Section-enter animation triggered on viewport intersection. */
573
671
  animation?: SectionAnimation;
@@ -575,6 +673,8 @@ type SectionInstance = {
575
673
  component?: string;
576
674
  /** Reserved: raw CSS escape hatch for the power path. Nothing reads or writes it yet. */
577
675
  advanced?: Record<string, string>;
676
+ /** Per-breakpoint CSS the node declares; read through `nodeStyleDecls`, emitted by `emitNodeStylesCss`. */
677
+ styles?: NodeStyles;
578
678
  };
579
679
  declare const CompositionSiteSchema: z.ZodObject<{
580
680
  slug: z.ZodString;
@@ -591,9 +691,9 @@ declare const CompositionSiteSchema: z.ZodObject<{
591
691
  title: z.ZodOptional<z.ZodString>;
592
692
  description: z.ZodOptional<z.ZodString>;
593
693
  ogType: z.ZodOptional<z.ZodEnum<{
594
- article: "article";
595
694
  website: "website";
596
695
  profile: "profile";
696
+ article: "article";
597
697
  }>>;
598
698
  twitterCard: z.ZodOptional<z.ZodEnum<{
599
699
  summary: "summary";
@@ -640,19 +740,24 @@ declare const CompositionSiteSchema: z.ZodObject<{
640
740
  }, z.core.$strip>>;
641
741
  }, z.core.$strip>>>;
642
742
  hidden: z.ZodOptional<z.ZodBoolean>;
743
+ parentId: z.ZodOptional<z.ZodString>;
744
+ nav: z.ZodOptional<z.ZodEnum<{
745
+ pin: "pin";
746
+ hide: "hide";
747
+ }>>;
643
748
  }, z.core.$strip>>>;
644
749
  brandColor: z.ZodOptional<z.ZodString>;
645
750
  theme: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
646
751
  base: z.ZodEnum<{
647
- "zero-point": "zero-point";
648
752
  mui: "mui";
753
+ "zero-point": "zero-point";
649
754
  }>;
650
755
  accent: z.ZodString;
651
756
  typeCategory: z.ZodEnum<{
652
- serif: "serif";
653
- display: "display";
654
757
  sans: "sans";
758
+ serif: "serif";
655
759
  mono: "mono";
760
+ display: "display";
656
761
  handwriting: "handwriting";
657
762
  }>;
658
763
  }, z.core.$strip>]>>;
@@ -666,9 +771,9 @@ declare const CompositionSiteSchema: z.ZodObject<{
666
771
  title: z.ZodOptional<z.ZodString>;
667
772
  description: z.ZodOptional<z.ZodString>;
668
773
  ogType: z.ZodOptional<z.ZodEnum<{
669
- article: "article";
670
774
  website: "website";
671
775
  profile: "profile";
776
+ article: "article";
672
777
  }>>;
673
778
  twitterCard: z.ZodOptional<z.ZodEnum<{
674
779
  summary: "summary";
@@ -722,6 +827,7 @@ declare const CompositionSiteSchema: z.ZodObject<{
722
827
  "wizard-portfolio": "wizard-portfolio";
723
828
  "wizard-blog": "wizard-blog";
724
829
  "wizard-professional": "wizard-professional";
830
+ import: "import";
725
831
  template: "template";
726
832
  }>>;
727
833
  mode: z.ZodDefault<z.ZodEnum<{
@@ -744,6 +850,7 @@ declare const CompositionSiteSchema: z.ZodObject<{
744
850
  profiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
745
851
  platform: z.ZodEnum<{
746
852
  link: "link";
853
+ site: "site";
747
854
  twitter: "twitter";
748
855
  instagram: "instagram";
749
856
  linkedin: "linkedin";
@@ -755,7 +862,10 @@ declare const CompositionSiteSchema: z.ZodObject<{
755
862
  threads: "threads";
756
863
  substack: "substack";
757
864
  mastodon: "mastodon";
758
- site: "site";
865
+ twitch: "twitch";
866
+ soundcloud: "soundcloud";
867
+ spotify: "spotify";
868
+ bandcamp: "bandcamp";
759
869
  }>;
760
870
  handle: z.ZodString;
761
871
  url: z.ZodString;
@@ -783,13 +893,14 @@ declare const CompositionSiteSchema: z.ZodObject<{
783
893
  }>>;
784
894
  launchedAt: z.ZodOptional<z.ZodNumber>;
785
895
  launchVersion: z.ZodOptional<z.ZodNumber>;
896
+ servedReleaseId: z.ZodOptional<z.ZodString>;
786
897
  stagingPublishedAt: z.ZodOptional<z.ZodNumber>;
787
898
  productionPublishedAt: z.ZodOptional<z.ZodNumber>;
788
899
  googleAnalyticsId: z.ZodOptional<z.ZodString>;
789
900
  clientVisibility: z.ZodOptional<z.ZodObject<{
790
901
  stagingMode: z.ZodEnum<{
791
- password: "password";
792
902
  public: "public";
903
+ password: "password";
793
904
  }>;
794
905
  productionMode: z.ZodEnum<{
795
906
  coming_soon: "coming_soon";
@@ -802,6 +913,10 @@ declare const CompositionSiteSchema: z.ZodObject<{
802
913
  enabled: z.ZodDefault<z.ZodBoolean>;
803
914
  checkoutUrl: z.ZodOptional<z.ZodString>;
804
915
  currency: z.ZodDefault<z.ZodString>;
916
+ provider: z.ZodOptional<z.ZodEnum<{
917
+ printful: "printful";
918
+ }>>;
919
+ cartPath: z.ZodOptional<z.ZodString>;
805
920
  }, z.core.$strip>>;
806
921
  onboarding: z.ZodOptional<z.ZodObject<{
807
922
  phase: z.ZodEnum<{
@@ -831,9 +946,9 @@ declare const CompositionSiteSchema: z.ZodObject<{
831
946
  }>;
832
947
  audience: z.ZodString;
833
948
  voice: z.ZodEnum<{
949
+ bold: "bold";
834
950
  professional: "professional";
835
951
  friendly: "friendly";
836
- bold: "bold";
837
952
  minimal: "minimal";
838
953
  luxury: "luxury";
839
954
  }>;
@@ -881,6 +996,47 @@ declare const CompositionSiteSchema: z.ZodObject<{
881
996
  confirmedAt: z.ZodOptional<z.ZodNumber>;
882
997
  }, z.core.$strip>>;
883
998
  briefSlots: z.ZodOptional<z.ZodArray<z.ZodString>>;
999
+ styleBrief: z.ZodOptional<z.ZodObject<{
1000
+ primaryColor: z.ZodObject<{
1001
+ name: z.ZodString;
1002
+ hex: z.ZodString;
1003
+ }, z.core.$strip>;
1004
+ secondaryColor: z.ZodOptional<z.ZodObject<{
1005
+ name: z.ZodString;
1006
+ hex: z.ZodString;
1007
+ }, z.core.$strip>>;
1008
+ pairingId: z.ZodEnum<{
1009
+ "editorial-fraunces": "editorial-fraunces";
1010
+ "classic-playfair": "classic-playfair";
1011
+ "serif-sans-cormorant": "serif-sans-cormorant";
1012
+ "literary-libre": "literary-libre";
1013
+ "geometric-space": "geometric-space";
1014
+ "swiss-archivo": "swiss-archivo";
1015
+ "modern-sora": "modern-sora";
1016
+ "display-unbounded": "display-unbounded";
1017
+ "humanist-work": "humanist-work";
1018
+ "rounded-nunito": "rounded-nunito";
1019
+ "warm-karla": "warm-karla";
1020
+ "grounded-outfit": "grounded-outfit";
1021
+ "mono-jetbrains": "mono-jetbrains";
1022
+ "mono-space": "mono-space";
1023
+ "condensed-oswald": "condensed-oswald";
1024
+ "slab-zilla": "slab-zilla";
1025
+ }>;
1026
+ radius: z.ZodEnum<{
1027
+ default: "default";
1028
+ none: "none";
1029
+ sm: "sm";
1030
+ md: "md";
1031
+ lg: "lg";
1032
+ xl: "xl";
1033
+ }>;
1034
+ density: z.ZodEnum<{
1035
+ default: "default";
1036
+ comfortable: "comfortable";
1037
+ compact: "compact";
1038
+ }>;
1039
+ }, z.core.$strip>>;
884
1040
  designSpec: z.ZodOptional<z.ZodObject<{
885
1041
  specId: z.ZodString;
886
1042
  sections: z.ZodArray<z.ZodObject<{
@@ -894,16 +1050,16 @@ declare const CompositionSiteSchema: z.ZodObject<{
894
1050
  mood: z.ZodString;
895
1051
  skinId: z.ZodString;
896
1052
  density: z.ZodEnum<{
1053
+ dense: "dense";
897
1054
  airy: "airy";
898
1055
  balanced: "balanced";
899
- dense: "dense";
900
1056
  }>;
901
1057
  }, z.core.$strip>;
902
1058
  copyStrategy: z.ZodObject<{
903
1059
  voice: z.ZodEnum<{
1060
+ bold: "bold";
904
1061
  professional: "professional";
905
1062
  friendly: "friendly";
906
- bold: "bold";
907
1063
  minimal: "minimal";
908
1064
  luxury: "luxury";
909
1065
  }>;
@@ -924,6 +1080,8 @@ declare const CompositionSiteSchema: z.ZodObject<{
924
1080
  copy: z.ZodRecord<z.ZodString, z.ZodString>;
925
1081
  layout: z.ZodOptional<z.ZodString>;
926
1082
  }, z.core.$strip>>;
1083
+ structure: z.ZodArray<z.ZodType<SectionInstance, unknown, z.core.$ZodTypeInternals<SectionInstance, unknown>>>;
1084
+ copyOverrides: z.ZodRecord<z.ZodString, z.ZodString>;
927
1085
  skinId: z.ZodString;
928
1086
  createdAt: z.ZodNumber;
929
1087
  }, z.core.$strip>>;
@@ -991,70 +1149,6 @@ declare const CompositionSiteSchema: z.ZodObject<{
991
1149
  slugProvisional: z.ZodOptional<z.ZodBoolean>;
992
1150
  kitDraftStartedAt: z.ZodOptional<z.ZodNumber>;
993
1151
  }, 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>>>;
1058
1152
  }, z.core.$strip>;
1059
1153
  type CompositionSite = z.infer<typeof CompositionSiteSchema> & {
1060
1154
  onboarding?: SiteOnboarding;
@@ -1086,6 +1180,29 @@ interface SectionProps {
1086
1180
  * drops its preset classes for `grid-cols-12`; absent means nothing changes.
1087
1181
  */
1088
1182
  childSpans?: number[];
1183
+ /** `layout-container` only. Cross-child gap step, from the node's `gap` field. */
1184
+ gap?: 'flush' | 'tight' | 'default' | 'wide';
1185
+ /** `layout-container` only. Cross-axis alignment, from the node's `align` field. */
1186
+ align?: 'start' | 'center' | 'stretch' | 'end';
1187
+ /** `layout-container` only. Main-axis distribution, from the node's `justify` field. */
1188
+ justify?: 'start' | 'end' | 'between';
1189
+ /**
1190
+ * The legacy tokens the node declares in `styles.desktop` (`componentOverrides`). The
1191
+ * node stylesheet sets them as custom properties on the node's wrapper; a section reads
1192
+ * them here as flags, since a discrete choice (`--section-divider`, a gradient's middle
1193
+ * stop, a body font) needs JS, not just CSS.
1194
+ */
1195
+ overrides?: Record<string, string>;
1196
+ /**
1197
+ * `layout-section` only. The band's own Desktop Fill (`componentFill`): its alpha sets how
1198
+ * strongly the band's Image is washed.
1199
+ */
1200
+ fill?: string;
1201
+ /**
1202
+ * Editor preview only: stamp `data-image-slot` on the element drawing each image slot
1203
+ * (`imageSlotProps`), so a Media drag can land on it. Hosted renders never set it.
1204
+ */
1205
+ editorMarkers?: boolean;
1089
1206
  /** Builder-only — open insert drawer on a tab (layout shells). */
1090
1207
  builderInsert?: {
1091
1208
  openTab: (tab: 'structure' | 'components') => void;