launchframe 0.1.5 → 0.1.6

package/packages/extract/types.ts

@@ -170,6 +170,120 @@ export interface DesignSystem {
   notes: string[];
 }
 
+/* -------------------------------------------------------------------------- */
+/*  Layout mirror (per-site)                                                  */
+/* -------------------------------------------------------------------------- */
+
+/**
+ * Structural roles a top-level section can play. Inferred heuristically from
+ * geometry, content kinds, and document position — not from the source's
+ * class names.
+ */
+export type SectionRole =
+  | "nav"
+  | "hero"
+  | "feature-grid"
+  | "feature-deep-dive"
+  | "proof-logos"
+  | "proof-quotes"
+  | "pricing"
+  | "conversion"
+  | "footer"
+  | "other";
+
+/**
+ * Coarse composition shape used by the emitter to pick a wrapper layout.
+ */
+export type Composition =
+  | "single-column"
+  | "split-2"
+  | "grid-2"
+  | "grid-3"
+  | "grid-4"
+  | "list"
+  | "logo-row"
+  | "unknown";
+
+/**
+ * The kinds of content a section can hold. The emitter renders an
+ * appropriately-styled placeholder (`<TextSlot>` / `<MediaSlot>`) per slot
+ * so the user fills in their own copy and assets.
+ */
+export type SlotKind =
+  | "heading-1"
+  | "heading-2"
+  | "heading-3"
+  | "eyebrow"
+  | "body"
+  | "bullet"
+  | "button-primary"
+  | "button-secondary"
+  | "image"
+  | "logo-mono"
+  | "icon"
+  | "code"
+  | "badge"
+  | "input"
+  | "video";
+
+export interface SlotCount {
+  kind: SlotKind;
+  count: number;
+}
+
+/**
+ * A single top-level section in document order. Geometry is normalized to
+ * [0, 1] over the rendered page so the emitter can compare relative weight.
+ */
+export interface SectionLayout {
+  /** Stable id assigned in document order: s1, s2, ... */
+  id: string;
+  role: SectionRole;
+  composition: Composition;
+  density: "thin" | "balanced" | "dense";
+  /** Bounding box [x, y, w, h] normalized to [0, 1] over the rendered page. */
+  bbox: [number, number, number, number];
+  /** Aggregated content-kind counts inside the section. */
+  slots: SlotCount[];
+  /** Per-section style hints; the emitter applies these as inline overrides. */
+  styles: {
+    backgroundHex: string | null;
+    foregroundHex: string | null;
+    paddingTopPx: number | null;
+    paddingBottomPx: number | null;
+  };
+  /** Free-form notes the emitter surfaces in `MIRROR_NOTES.md`. */
+  notes: string[];
+}
+
+/**
+ * Page-level computed-style tokens. These complement the synthesized
+ * `DesignSystem` so a mirror page can apply a site-specific theme without
+ * the system having to reseed the cross-corpus palette.
+ */
+export interface SiteTokens {
+  bodyFontFamily: string;
+  headingFontFamily: string;
+  backgroundHex: string;
+  foregroundHex: string;
+  primaryHex: string;
+  mutedHex: string;
+  borderHex: string;
+  radiusPx: number;
+  containerPx: number | null;
+}
+
+export interface SiteLayout {
+  url: string;
+  host: string;
+  capturedAt: string;
+  viewport: { width: number; height: number };
+  /** Full rendered page height in CSS pixels. */
+  pageHeightPx: number;
+  sections: SectionLayout[];
+  tokens: SiteTokens;
+}
+
 /* -------------------------------------------------------------------------- */
 /*  Run summary                                                               */
 /* -------------------------------------------------------------------------- */
@@ -180,6 +294,10 @@ export interface SiteCapture {
   capturedAt: string;
   screenshotPath: string;
   rawTokensPath: string;
+  /** Path to the per-site `SiteLayout` JSON, if the mirror crawl succeeded. */
+  layoutPath?: string;
+  /** Path to the per-site mirror page directory, if emission succeeded. */
+  mirrorDir?: string;
   status: "ok" | "skipped" | "failed";
   reason?: string;
 }