@tryvitris/website-harness 0.0.0-stage → 0.1.0-beta.5

package/bin/types/src/onboard/brief.d.ts

@@ -0,0 +1,182 @@
+import { type ExtractedCta, type ExtractedFaq, type ExtractedImage, type ExtractedPage, type ExtractedTestimonial, type PageAuditHints } from "./extract.ts";
+import type { ImageKind, ImageMediaType, ImageRole } from "./classify.ts";
+import type { SocialLink } from "./social.ts";
+export declare const CRITICAL_KEYS: readonly ["name", "phone", "email", "address", "primaryCta", "hours", "services"];
+export type CriticalKey = (typeof CRITICAL_KEYS)[number];
+export type BusinessFacts = {
+    name: string;
+    phone: string;
+    email: string;
+    address: string;
+    city: string;
+    hours: string[];
+    primaryCta: {
+        label: string;
+        href: string;
+    };
+    services: {
+        name: string;
+        blurb: string;
+    }[];
+    social: SocialLink[];
+};
+export type BriefImage = {
+    sourceUrl: string;
+    sourceUrls?: string[];
+    alt: string;
+    r2Key: string;
+    src: string;
+    role: ImageRole;
+    kind: ImageKind;
+    mediaType?: ImageMediaType;
+    pageUrl?: string;
+    nearbyHeading?: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    aboveFold?: boolean;
+    fromOg?: boolean;
+    /** Site-local path after harvest copy, e.g. `/media/hero.png`. Prefer this in pages. */
+    localPath?: string;
+    thumbPath?: string;
+    shortlist?: boolean;
+    scratchPath?: string;
+    error?: string;
+};
+export type SiteRegister = "trade" | "beauty" | "b2b";
+export type VisualHints = {
+    brandColors?: Array<{
+        value: string;
+        source: string;
+    }>;
+    fontBody?: string;
+    fontDisplay?: string;
+    radius?: string;
+    radiusPill?: string;
+};
+export type OnboardVisual = {
+    register: SiteRegister;
+    signatureSections: string[];
+    hints: VisualHints;
+    stills: string[];
+};
+export type BriefPage = {
+    aliasOf?: string;
+    url: string;
+    title: string;
+    description: string;
+    canonical?: string;
+    outline: string[];
+    paragraphs: string[];
+    lists: string[];
+    testimonials: ExtractedTestimonial[];
+    faqs: ExtractedFaq[];
+    ctas: ExtractedCta[];
+    copyFile?: string;
+    audit: PageAuditHints;
+};
+export type OnboardBrief = {
+    version: 2;
+    sourceUrl: string;
+    crawledAt: string;
+    slug: string;
+    business: BusinessFacts;
+    missing: CriticalKey[];
+    pages: BriefPage[];
+    images: BriefImage[];
+    warnings: string[];
+    compose: string;
+    visual?: OnboardVisual;
+};
+export type OnboardAudit = {
+    version: 1;
+    sourceUrl: string;
+    crawledAt: string;
+    pages: Array<{
+        url: string;
+        title: string;
+        description: string;
+        canonical?: string;
+        lang?: string;
+        h1Count: number;
+        missingAlts: number;
+        unlabeledInputs: number;
+        hasCanonical: boolean;
+        hasLang: boolean;
+        hasJsonLd: boolean;
+        titleLength: number;
+        descriptionLength: number;
+    }>;
+    summary: {
+        pageCount: number;
+        pagesMissingTitle: number;
+        pagesMissingDescription: number;
+        pagesMultipleH1: number;
+        pagesZeroH1: number;
+        totalMissingAlts: number;
+        totalUnlabeledInputs: number;
+    };
+    /** Filled by the research graph node (PSI / Lighthouse). */
+    webVitals: null | {
+        source: string;
+        lcp?: number | string;
+        inp?: number | string;
+        tbt?: number | string;
+        cls?: number | string;
+        accessibilityScore?: number;
+        seoScore?: number;
+        performanceScore?: number;
+        notes?: string;
+    };
+};
+export type OnboardResearch = {
+    version: 1;
+    reviews: {
+        rating?: number;
+        count?: number;
+        snippets: Array<{
+            text: string;
+            author?: string;
+            sourceUrl?: string;
+        }>;
+        sourceUrls: string[];
+    };
+    social: SocialLink[];
+    goals: {
+        primaryConversion?: string;
+        serviceArea?: string;
+        doneWhen?: string;
+        notes?: string;
+    };
+    sources: string[];
+    completed: boolean;
+};
+export declare const COMPOSE_NOTE = "Follow the agent skill graph (agent/PROMPT.md). Keep facts (name, phone, email, address, hours, services, primary CTA, social). Keep the old site\u2019s media language: owner photos, illustrations, device mockups, portraits, and press marks \u2014 use interpret shortlist /media paths first. Invent new layout, copy, and chrome; do not clone the old grid 1:1. If the old home has a named visual chapter (How It Works, Featured work, Built for\u2026), restyle it on the new home instead of moving it to an inner route.";
+export declare function emptyFacts(): BusinessFacts;
+export declare function parseHoursFromText(text: string): string[];
+export declare function inferServices(pages: ExtractedPage[]): {
+    name: string;
+    blurb: string;
+}[];
+export declare function collectCandidateImages(pages: ExtractedPage[]): ExtractedImage[];
+export declare function missingCritical(facts: BusinessFacts): CriticalKey[];
+export declare function mergeFacts(pages: ExtractedPage[], seed?: Partial<BusinessFacts>): BusinessFacts;
+export declare function assembleBrief(opts: {
+    sourceUrl: string;
+    slug: string;
+    pages: ExtractedPage[];
+    images?: BriefImage[];
+    warnings?: string[];
+    seed?: Partial<BusinessFacts>;
+    crawledAt?: string;
+    copyFiles?: Map<string, string>;
+    visual?: OnboardVisual;
+}): OnboardBrief;
+export declare function inferSignatureSections(pages: ExtractedPage[]): string[];
+export declare function inferRegister(pages: ExtractedPage[], business: BusinessFacts): SiteRegister;
+export declare function assembleAudit(opts: {
+    sourceUrl: string;
+    pages: ExtractedPage[];
+    crawledAt?: string;
+}): OnboardAudit;
+export declare function emptyResearch(social?: SocialLink[]): OnboardResearch;

package/bin/types/src/onboard/classify.d.ts

@@ -0,0 +1,31 @@
+/** Pure image role/kind classification for onboarding harvests. No network. */
+import type { ExtractedImage } from "./extract.ts";
+export type ImageRole = "logo" | "hero" | "photo" | "icon" | "failed";
+export type ImageKind = "business" | "stock" | "generic" | "unknown";
+export type ImageMediaType = "logo" | "illustration" | "screenshot" | "portrait" | "press" | "photo" | "icon";
+export type ClassifiedImage = ExtractedImage & {
+    role: ImageRole;
+    kind: ImageKind;
+    mediaType: ImageMediaType;
+    inChrome?: boolean;
+    fromJsonLdLogo?: boolean;
+    fromOg?: boolean;
+    aboveFold?: boolean;
+};
+export declare function isStockHost(src: string): boolean;
+export declare function inferMediaType(img: ExtractedImage, role: ImageRole): ImageMediaType;
+export declare function classifyOne(img: ExtractedImage, opts?: {
+    inChrome?: boolean;
+    fromJsonLdLogo?: boolean;
+    fromOg?: boolean;
+    aboveFold?: boolean;
+}): ClassifiedImage;
+/**
+ * Classify a list of images and promote a single logo + single hero when possible.
+ */
+export declare function classifyImages(images: Array<ExtractedImage & {
+    inChrome?: boolean;
+    fromJsonLdLogo?: boolean;
+    fromOg?: boolean;
+    aboveFold?: boolean;
+}>): ClassifiedImage[];

package/bin/types/src/onboard/crawl-order.d.ts

@@ -0,0 +1,7 @@
+/** Priority crawl queue so home / about / work are visited before legal and shop. */
+/**
+ * Lower number is crawled first. Legal/shop trail so a --max-pages abort
+ * still captures the media-rich pages.
+ */
+export declare function crawlPriority(url: string, startUrl: string): number;
+export declare function insertByCrawlPriority(queue: string[], url: string, startUrl: string): void;

package/bin/types/src/onboard/extract.d.ts

@@ -0,0 +1,102 @@
+/** Pure HTML extraction for site onboarding crawls. No network. */
+import { type SocialLink } from "./social.ts";
+export type ExtractedImage = {
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+    inChrome?: boolean;
+    fromJsonLdLogo?: boolean;
+    fromOg?: boolean;
+    aboveFold?: boolean;
+    pageUrl?: string;
+    nearbyHeading?: string;
+};
+export type ExtractedCta = {
+    href: string;
+    label: string;
+    kind: "tel" | "mailto" | "internal" | "external" | "other";
+};
+export type ExtractedTestimonial = {
+    quote: string;
+    attribution?: string;
+};
+export type ExtractedFaq = {
+    question: string;
+    answer: string;
+};
+export type ExtractedPage = {
+    aliasOf?: string;
+    url: string;
+    title: string;
+    description: string;
+    canonical?: string;
+    lang?: string;
+    h1: string[];
+    headings: string[];
+    outline: string[];
+    paragraphs: string[];
+    lists: string[];
+    testimonials: ExtractedTestimonial[];
+    faqs: ExtractedFaq[];
+    links: {
+        href: string;
+        label: string;
+        relative?: boolean;
+    }[];
+    ctas: ExtractedCta[];
+    images: ExtractedImage[];
+    phones: string[];
+    emails: string[];
+    social: SocialLink[];
+    jsonLd: unknown[];
+    audit: PageAuditHints;
+};
+export type PageAuditHints = {
+    h1Count: number;
+    missingAlts: number;
+    unlabeledInputs: number;
+    hasCanonical: boolean;
+    hasLang: boolean;
+    hasJsonLd: boolean;
+    titleLength: number;
+    descriptionLength: number;
+};
+export declare function shouldSkipPath(pathname: string): boolean;
+/** Drop runaway query-string variants while keeping unique content URLs. */
+export declare function shouldSkipQueryUrl(href: string): boolean;
+export declare function stripNoise(html: string): string;
+export declare function absolutize(href: string, base: string): string | null;
+/** Resolve `<base href>` against the document URL; fall back to the page URL. */
+export declare function documentBase(html: string, pageUrl: string): string;
+/** Path-relative href (about, ../x) as opposed to root-relative, absolute, or hash. */
+export declare function isPathRelativeHref(href: string): boolean;
+export declare function sameOrigin(a: string, b: string): boolean;
+/** Treat www and apex as the same site for crawl bounds. */
+export declare function sameSite(a: string, b: string): boolean;
+export declare function isLikelyTrackingImage(img: ExtractedImage): boolean;
+export declare function extractPhones(text: string): string[];
+export declare function extractEmails(text: string): string[];
+export declare function parseJsonLd(html: string): unknown[];
+export declare function businessFromJsonLd(nodes: unknown[]): {
+    name?: string;
+    phone?: string;
+    email?: string;
+    address?: string;
+    city?: string;
+    hours?: string[];
+    url?: string;
+    logoUrl?: string;
+};
+export declare function jsonLdServices(nodes: unknown[]): {
+    name: string;
+    blurb: string;
+}[];
+/** Builders often put their prose in divs. Keep leaf prose without duplicating
+ * parent containers, headings, controls or existing semantic paragraphs. */
+export declare function extractNarrativeParagraphs(html: string): string[];
+export declare function extractPage(html: string, pageUrl: string): ExtractedPage;
+export declare function parseSitemapLocs(xml: string): string[];
+export declare function inferPrimaryCta(ctas: ExtractedCta[]): ExtractedCta | undefined;
+/** Slugify a page URL into a safe copy filename stem. */
+export declare function pageCopySlug(pageUrl: string, index: number): string;

package/bin/types/src/onboard/harvest-inventory.d.ts

@@ -0,0 +1,84 @@
+/** Harvest exclusion classification, inventory, and operator scope. */
+export declare const HARVEST_EXCLUSION_CLASSES: readonly ["source-missing", "crawler-invalid", "off-site", "error-page", "transient"];
+export type HarvestExclusionClass = (typeof HARVEST_EXCLUSION_CLASSES)[number];
+export declare const HARVEST_PROVENANCE: readonly ["sitemap", "nav", "in-body-relative", "redirect", "start"];
+export type HarvestProvenance = (typeof HARVEST_PROVENANCE)[number];
+export type HarvestDiscovery = {
+    provenance: HarvestProvenance;
+    discoveredFrom?: string;
+    rawHref?: string;
+};
+export type HarvestExclusion = {
+    url: string;
+    class: HarvestExclusionClass;
+    provenance: HarvestProvenance;
+    reason: string;
+    httpStatus?: number;
+    rootAbsolute?: string;
+    discoveredFrom?: string;
+};
+export type HarvestInventory = {
+    version: 1;
+    engine: "playwright" | "fetch";
+    startUrl: string;
+    pages: {
+        url: string;
+        title: string;
+        aliasOf?: string;
+    }[];
+    media: {
+        files: string[];
+        failed: {
+            source: string;
+            reason: string;
+        }[];
+    };
+    exclusions: HarvestExclusion[];
+    unvisited: string[];
+};
+export type HarvestScope = {
+    version: 1;
+    excludeClasses?: HarvestExclusionClass[];
+    maxPages?: number;
+    notes: string;
+};
+export declare function isPlaywrightLaunchFailure(err: unknown): boolean;
+export declare function pathOf(url: string): string;
+export declare function capturedPathSet(pages: {
+    url: string;
+}[]): Set<string>;
+export declare function rootAbsoluteCounterpart(url: string): string | null;
+export declare function isCrawlerInvalidUrl(url: string, captured: Set<string>, discovery?: HarvestDiscovery, sitemapPaths?: Set<string>): boolean;
+export declare function classifyMiss(opts: {
+    url: string;
+    status?: number;
+    error?: string;
+    kind: "http" | "transport" | "empty" | "error-page" | "off-site" | "non-http";
+    discovery?: HarvestDiscovery;
+    captured: Set<string>;
+    sitemapPaths?: Set<string>;
+}): HarvestExclusion;
+export declare function formatExclusion(ex: HarvestExclusion): string;
+/** Warnings that mean the crawl did not finish, unless operator scope covers them. */
+export declare function isIncompleteCrawlWarning(warning: string): boolean;
+export declare function loadHarvestScope(siteRoot: string): HarvestScope | null;
+export declare function loadHarvestInventory(siteRoot: string): HarvestInventory | null;
+export declare function assembleHarvestInventory(opts: {
+    engine: "playwright" | "fetch";
+    startUrl: string;
+    pages: {
+        url: string;
+        title: string;
+        aliasOf?: string;
+    }[];
+    exclusions: HarvestExclusion[];
+    unvisited: string[];
+    siteRoot: string;
+    images?: {
+        sourceUrl: string;
+        localPath?: string;
+        role?: string;
+        error?: string;
+    }[];
+}): HarvestInventory;
+export declare function harvestIncompleteFailures(siteRoot: string, warnings: string[]): string[];

package/bin/types/src/onboard/outline.d.ts

@@ -0,0 +1,13 @@
+/** Write human-readable onboarding outline + per-page copy markdown. */
+import type { BusinessFacts, OnboardBrief } from "./brief.ts";
+import type { ExtractedPage } from "./extract.ts";
+export declare function renderPageCopy(page: ExtractedPage): string;
+export declare function buildCopyFiles(pages: ExtractedPage[]): Map<string, {
+    slug: string;
+    markdown: string;
+}>;
+export declare function renderMediaGuide(brief: OnboardBrief): string;
+export declare function renderOutline(opts: {
+    brief: OnboardBrief;
+    business?: BusinessFacts;
+}): string;

package/bin/types/src/onboard/quality.d.ts

@@ -0,0 +1,6 @@
+/** Reject rendered error documents even when the host reports HTTP 200. */
+export declare function isErrorPage(page: {
+    title: string;
+    headings?: string[];
+    outline?: string[];
+}): boolean;

package/bin/types/src/onboard/shortlist.d.ts

@@ -0,0 +1,11 @@
+/** Pick 8–20 must-use harvest images and give them human filenames. */
+import type { BriefImage } from "./brief.ts";
+export declare const SHORTLIST_MIN = 8;
+export declare const SHORTLIST_MAX = 20;
+export declare function extFromImage(img: BriefImage): string;
+export declare function scoreShortlist(img: BriefImage): number;
+export declare function fileStemFor(img: BriefImage, used: Set<string>): string;
+/**
+ * Mark a diverse shortlist on the image records. Does not copy files.
+ */
+export declare function selectShortlist(images: BriefImage[]): BriefImage[];

package/bin/types/src/onboard/social.d.ts

@@ -0,0 +1,15 @@
+/** Detect social / review profile URLs from links and JSON-LD sameAs. */
+export type SocialPlatform = "facebook" | "instagram" | "yelp" | "google" | "tiktok" | "linkedin" | "youtube" | "twitter" | "other";
+export type SocialLink = {
+    platform: SocialPlatform;
+    url: string;
+    label?: string;
+};
+export declare function platformForUrl(url: string): SocialPlatform | null;
+export declare function collectSocialLinks(opts: {
+    links: {
+        href: string;
+        label: string;
+    }[];
+    jsonLd: unknown[];
+}): SocialLink[];

package/bin/types/src/onboard/visual-hints.d.ts

@@ -0,0 +1,12 @@
+import type { VisualHints } from "./brief.ts";
+/** Distinctive computed family → self-host stack. Never a Google Fonts CDN URL. */
+export declare function stackFromComputed(family: string, fallback: string): string | undefined;
+export declare function radiusFromComputed(raw: string): {
+    radius?: string;
+    radiusPill?: string;
+};
+export declare function hintsFromComputed(input: {
+    fontBody?: string;
+    fontDisplay?: string;
+    radius?: string;
+}): VisualHints;

package/bin/types/src/preserve/build.d.ts

@@ -0,0 +1 @@
+export declare function buildPreservedSite(siteRoot: string, output?: string): Promise<void>;

package/bin/types/src/preserve/capture.d.ts

@@ -0,0 +1,21 @@
+import { type Page } from "playwright";
+import { type DefaultTreeAdapterMap } from "parse5";
+import { type PreserveManifest } from "./config.ts";
+type Node = DefaultTreeAdapterMap["node"];
+type Element = DefaultTreeAdapterMap["element"];
+/** Dotted customer page slugs are pages; only recognized file suffixes are downloads. */
+export declare const isDownloadPath: (path: string) => boolean;
+export declare function legacyRoutes(html: string, base: string): string[];
+/** Read the legacy SSR JSON without executing inline script or trusting its code. */
+export declare function legacyReactState(html: string): any | undefined;
+export declare function elements(node: Node): Element[];
+/** Both captures use the same scroll/settling policy, including lazy-loaded images. */
+export declare function settle(page: Page): Promise<void>;
+export declare function capturePreservedSite(root: string, opts?: {
+    signal?: AbortSignal;
+    onLog?: (line: string) => void;
+    diagnostic?: boolean;
+    onlyPaths?: string[];
+    includeSourceErrors?: boolean;
+}): Promise<PreserveManifest>;
+export {};

package/bin/types/src/preserve/components.d.ts

@@ -0,0 +1,10 @@
+export declare function isInertFrame(node: any): boolean;
+/** Static legacy feeds contain real links, not search/pagination callbacks. */
+export declare function supportsStaticLegacyComponent(node: any): boolean;
+export declare function staticLegacyComponents(html: string): Set<string>;
+/** Repair only two malformed external-link syntaxes, preserving their destinations. */
+export declare function repairedExternalNavigation(original: string, authored: string, sourceUrl: string): Set<string>;
+/** V1 service lists can page captured cards locally while booking stays disabled. */
+export declare function disabledLegacyServices(original: string, authored: string, authorized: boolean): boolean;
+/** Removing an application script is a functional limitation, even if pixels match. */
+export declare function unsupportedApplicationScripts(html: string, sourceUrl: string): string[];

package/bin/types/src/preserve/config.d.ts

@@ -0,0 +1,53 @@
+import type { PublicForm } from '../forms/config.ts';
+export type PreserveLaunch = {
+    mode?: "redesign" | "preserve";
+    sourceUrl?: string;
+    backendOrigin?: string;
+    slug?: string;
+    forms?: PublicForm[];
+    previewDisabledTransactions?: boolean;
+};
+export declare function preserveConfig(root: string): PreserveLaunch;
+export declare const isPreserveSite: (root: string) => boolean;
+export declare const PRESERVE_WIDTHS: readonly [1440, 390];
+export declare const PRESERVE_HEIGHT = 1000;
+export declare const SUPPORTED_REACT_BLOCKS: Set<string>;
+/** Resolve only known static block support added after an immutable capture. */
+export declare function unresolvedCaptureBlockers(manifest: PreserveManifest, staticComponents?: Map<string, Set<string>>, resolvedNavigationAssets?: Set<string>, reactComponents?: Map<string, Set<string>>, repairedNavigation?: Set<string>): string[];
+export type PreservePage = {
+    url: string;
+    path: string;
+    file: string;
+    references: Array<{
+        width: number;
+        file: string;
+        sha256: string;
+    }>;
+    sourceFailure?: {
+        status: number;
+        kind: 'http-404' | 'soft-404';
+        responseFile: string;
+        responseSha256: string;
+    };
+};
+export type PreserveManifest = {
+    version: 1;
+    adapter: "vitris-v1" | "vitris-v2";
+    sourceUrl: string;
+    capturedAt: string;
+    pages: PreservePage[];
+    assets: Array<{
+        url: string;
+        file: string;
+        sha256: string;
+        originalSha256?: string;
+        referenceFile?: string;
+        captureError?: string;
+    }>;
+    serviceMode: "preview-only" | "vitris-forms";
+    warnings: string[];
+    /** Diagnostic captures retain independent work but cannot pass release gates. */
+    blockers?: string[];
+};
+/** Reject ambiguous/unsafe routes rather than flattening them into another page. */
+export declare function pageFile(path: string): string;

package/bin/types/src/preserve/embeds.d.ts

@@ -0,0 +1,15 @@
+/** Only existing public, read-only provider embeds; never booking or form apps. */
+export declare function approvedEmbedUrl(raw: string): string | undefined;
+export declare function readOnlyEmbedProvider(raw: string): 'google-maps' | 'youtube' | 'massagebook-reviews' | undefined;
+export declare function providerConsoleWarning(text: string, location: string, approved: Set<string>): boolean;
+/** A cancelled conversion beacon is not a failed review asset or booking request. */
+export declare function cancelledReviewTelemetry(request: {
+    url(): string;
+    frame(): any;
+}, error: string | undefined, approved: Set<string>): boolean;
+export declare function iframeSources(html: string): string[];
+/** Child provider resources remain remote; main-page dependencies stay local. */
+export declare function isReadOnlyEmbedRequest(request: {
+    url(): string;
+    frame(): any;
+}, approved: Set<string>): boolean;

package/bin/types/src/preserve/hovers.d.ts

@@ -0,0 +1,10 @@
+import type { Page } from 'playwright';
+export type ButtonHover = {
+    index: number;
+    text: string;
+    href: string | null;
+    before: Record<string, string>;
+    hover: Record<string, string>;
+};
+/** Observe public visual states without clicking or submitting the original. */
+export declare function captureButtonHovers(page: Page, selector?: string): Promise<ButtonHover[]>;

package/bin/types/src/preserve/react-capabilities.d.ts

@@ -0,0 +1,2 @@
+/** Inspect each original block. Opt-in disabled transactions never enables delivery. */
+export declare function reactCapabilities(state: any, original: string, authored: string, path: string, disabledTransactions: boolean): Set<string>;

package/bin/types/src/preserve/runtime.d.ts

@@ -0,0 +1,2 @@
+/** Public interactions replacing the old Angular renderer; no legacy services. */
+export declare const preserveRuntime = "(() => {\n  const bottomNav = document.getElementById('navbar-bottom-nav');\n  const footer = document.getElementById('vitris-footer');\n  if (bottomNav && footer) {\n    const reserveBottomNav = () => { footer.style.paddingBottom = bottomNav.getBoundingClientRect().height + 'px'; };\n    new ResizeObserver(reserveBottomNav).observe(bottomNav);\n    window.addEventListener('resize', reserveBottomNav); document.fonts.ready.then(reserveBottomNav); reserveBottomNav();\n  }\n  let openModal, opener;\n  const reactClosedClasses = new WeakMap();\n  const notice=(container,text)=>{\n    let note=container.querySelector('[data-preserve-status]');\n    if(!note){note=document.createElement('p');note.dataset.preserveStatus='';note.setAttribute('role','status');container.append(note);}note.textContent=text;\n  };\n  document.querySelectorAll('services-general[data-preserve-service-cards]').forEach(block=>{\n    const cards=JSON.parse(block.dataset.preserveServiceCards),grid=block.querySelector('[data-preserve-service-grid]'),select=block.querySelector('[data-vitrisid=\"servicesPerPage\"]'),search=block.querySelector('[data-vitrisid=\"servicesSearch\"]'),left=block.querySelector('[data-vitrisid=\"servicesLeftArrow\"]'),right=block.querySelector('[data-vitrisid=\"servicesRightArrow\"]');let offset=0;\n    const render=()=>{const filtered=cards.filter(card=>!search?.value||card.toLowerCase().includes(search.value.toLowerCase())),size=Number(select?.value||5);offset=Math.max(0,Math.min(offset,Math.max(0,Math.ceil(filtered.length/size)-1)));grid.innerHTML=filtered.slice(offset*size,(offset+1)*size).join('');grid.querySelectorAll('[data-toggle=\"modal\"]').forEach(el=>{el.tabIndex=0;el.setAttribute('role','button');});bindHovers(grid);left?.parentElement.classList.toggle('disabled',offset===0);right?.parentElement.classList.toggle('disabled',(offset+1)*size>=filtered.length);};\n    select?.addEventListener('change',()=>{offset=0;render();});search?.addEventListener('input',()=>{offset=0;render();});left?.addEventListener('click',event=>{event.preventDefault();if(offset>0){offset--;render();}});right?.addEventListener('click',event=>{event.preventDefault();if((offset+1)*Number(select?.value||5)<cards.length){offset++;render();}});\n  });\n  // The original React renderer leaves below-fold images unloaded until scrolling\n  // or resizing. Keep its deferred loading while using only captured local bytes.\n  const deferred=[...document.querySelectorAll('img[data-preserve-deferred-src]')];\n  const loadImage=img=>{if(!img.dataset.preserveDeferredSrc)return;img.src=img.dataset.preserveDeferredSrc;img.removeAttribute('data-preserve-deferred-src');};\n  const observer=new IntersectionObserver(entries=>entries.forEach(entry=>{if(entry.isIntersecting){loadImage(entry.target);observer.unobserve(entry.target);}}),{rootMargin:'0px 0px 200px 0px'});\n  deferred.forEach(img=>observer.observe(img));\n  if(window.innerWidth<992)deferred.forEach(loadImage);\n  window.addEventListener('resize',()=>deferred.filter(img=>img.hasAttribute('data-preserve-deferred-src')).forEach(loadImage));\n  document.querySelectorAll('[data-preserve-product-states]').forEach(panel=>{\n    const states=JSON.parse(panel.dataset.preserveProductStates),initial=states[0].values;let values=[...initial];\n    const bind=()=>panel.querySelectorAll('select').forEach((select,index)=>{if(index>=values.length)return;select.value=values[index];select.addEventListener('change',()=>{\n      values[index]=select.value;\n      if(index===0)values=values.map((v,i)=>i===0?v:'');\n      const state=states.find(s=>JSON.stringify(s.values)===JSON.stringify(values));\n      if(state){panel.innerHTML=state.html;bind();bindHovers(panel);}\n    });});bind();\n  });\n  document.querySelectorAll('.carousel[data-preserve-carousel]').forEach(carousel=>{\n    const slides=[...carousel.querySelectorAll('.carousel__slide')],dots=[...carousel.querySelectorAll('.carousel__dot')];let selected=0;\n    const choose=index=>{selected=(index+slides.length)%slides.length;carousel.querySelector('.carousel__slider-tray').style.transform='translateX(-'+(selected*100/slides.length)+'%) translateX(0px)';\n      slides.forEach((slide,i)=>{slide.classList.toggle('carousel__slide--visible',i===selected);slide.classList.toggle('carousel__slide--hidden',i!==selected);slide.setAttribute('aria-selected',String(i===selected));slide.tabIndex=i===selected?0:-1;});\n      dots.forEach((dot,i)=>{dot.disabled=i===selected;dot.classList.toggle('carousel__dot--selected',i===selected);});};\n    dots.forEach((dot,i)=>dot.addEventListener('click',()=>choose(i)));\n    const slider=carousel.querySelector('.carousel__slider');slider.addEventListener('keydown',event=>{if(['ArrowRight','ArrowLeft'].includes(event.key)){event.preventDefault();choose(selected+(event.key==='ArrowRight'?1:-1));}});\n    let start;slider.addEventListener('touchstart',event=>{start=event.touches[0]?.clientX;},{passive:true});slider.addEventListener('touchend',event=>{const end=event.changedTouches[0]?.clientX;if(start!==undefined&&Math.abs(end-start)>30)choose(selected+(end<start?1:-1));},{passive:true});\n  });\n  const boundHovers=new WeakSet();\n  const bindHovers=container=>container.querySelectorAll('[data-preserve-hover]').forEach(button=>{\n    if(boundHovers.has(button))return;boundHovers.add(button);\n    const hover=JSON.parse(button.dataset.preserveHover);let resting;\n    button.addEventListener('mouseenter',()=>{resting=button.getAttribute('style');for(const [property,value]of Object.entries(hover))button.style.setProperty(property,value);});\n    button.addEventListener('mouseleave',()=>{if(resting===null)button.removeAttribute('style');else if(resting!==undefined)button.setAttribute('style',resting);});\n  });bindHovers(document);\n  document.querySelectorAll('iframe[data-preserve-disabled-embed]').forEach(frame => {\n    const notice = () => {\n      const doc = frame.contentDocument;\n      if (!doc || doc.querySelector('[data-preserve-embed-notice]')) return;\n      const note = doc.createElement('p'); note.dataset.preserveEmbedNotice = ''; note.setAttribute('role','status');\n      note.textContent = 'This preview does not run this embedded application. Please use the listed contact details.';\n      doc.body.append(note);\n    };\n    frame.addEventListener('load', notice); notice();\n  });\n  const close = () => {\n    if (!openModal) return;\n    openModal.classList.remove('show'); openModal.style.display = 'none';\n    openModal.setAttribute('aria-hidden', 'true'); openModal.removeAttribute('aria-modal');\n    document.querySelector('[data-preserve-backdrop]')?.remove();\n    document.body.classList.remove('modal-open'); openModal = null; opener?.focus();\n  };\n  document.querySelectorAll('[data-toggle=\"modal\"]').forEach(el => { el.tabIndex = 0; el.setAttribute('role','button'); });\n  document.querySelectorAll('.dropdown-toggle').forEach(el => { el.tabIndex = 0; el.setAttribute('role','button'); el.setAttribute('aria-expanded','false'); });\n  document.addEventListener('click', event => {\n    const disabled=event.target.closest('[data-preserve-disabled-action]');\n    if(disabled){event.preventDefault();const booking=disabled.dataset.preserveDisabledAction==='booking',container=disabled.closest('[data-preserve-disabled-booking], #vb, form')||disabled.parentElement;notice(container,booking?(container.querySelector('#days-container')?'This preview cannot book appointments. Calendar availability is a captured snapshot. Please use the listed contact details.':'This preview cannot book appointments. Please use the listed contact details.'):'This preview cannot place orders or accept payments. Please use the listed contact details.');return;}\n    if(event.target.closest('[data-preserve-inert-action]')){event.preventDefault();return;}\n    const dropdown = event.target.closest('.dropdown-toggle');\n    if (dropdown) {\n      const menu = dropdown.parentElement.querySelector('.dropdown-menu');\n      if (menu) {\n        event.preventDefault();\n        const wasOpen = !!document.querySelector('.dropdown-menu.show');\n        document.querySelectorAll('.dropdown-menu.show').forEach(el=>el.classList.remove('show'));\n        document.querySelectorAll('.dropdown-toggle').forEach(el=>el.setAttribute('aria-expanded','false'));\n        if (!wasOpen) { menu.classList.add('show'); dropdown.setAttribute('aria-expanded','true'); }\n      }\n    }\n    const toggle = event.target.closest('[data-toggle]');\n    if (toggle) {\n      const selector = toggle.getAttribute('data-target') || toggle.getAttribute('href');\n      const target = selector?.startsWith('#') ? document.getElementById(selector.slice(1)) : null;\n      if (!target) return;\n      if (toggle.dataset.toggle === 'collapse') {\n        event.preventDefault();\n        const groupSelector=toggle.getAttribute('data-parent')||target.getAttribute('data-parent');\n        const group=groupSelector?.startsWith('#')?document.getElementById(groupSelector.slice(1)):null;\n        if(group&&!target.classList.contains('show'))group.querySelectorAll('.collapse.show').forEach(sibling=>{\n          if(sibling===target)return;sibling.classList.remove('show');\n          group.querySelectorAll('[data-toggle=\"collapse\"]').forEach(control=>{if((control.getAttribute('data-target')||control.getAttribute('href'))==='#'+sibling.id)control.setAttribute('aria-expanded','false');});\n        });\n        const reactNav = target.classList.contains('navbar-collapse');\n        if (reactNav && !reactClosedClasses.has(target)) reactClosedClasses.set(target, target.className);\n        target.classList.toggle('show');\n        if (reactNav) {\n          if (target.classList.contains('show')) { target.classList.remove('d-none'); target.classList.add('d-block','in'); }\n          else target.className = reactClosedClasses.get(target);\n        }\n        toggle.setAttribute('aria-expanded', String(target.classList.contains('show')));\n      } else if (toggle.dataset.toggle === 'modal') {\n        event.preventDefault(); close(); opener = toggle; openModal = target;\n        target.style.display = 'block'; target.classList.add('show'); target.removeAttribute('aria-hidden');\n        target.setAttribute('aria-modal','true'); target.tabIndex = -1;\n        const backdrop = document.createElement('div'); backdrop.className = 'modal-backdrop fade show';\n        backdrop.dataset.preserveBackdrop = ''; backdrop.onclick = close; document.body.append(backdrop);\n        document.body.classList.add('modal-open'); target.focus();\n        if (toggle.closest('services-general[uniquecomponent=\"service-1\"]') && !target.querySelector('[data-preserve-booking-notice]')) {\n          const note = document.createElement('p'); note.dataset.preserveBookingNotice = ''; note.setAttribute('role','status');\n          note.textContent = 'This preview cannot book appointments. Please use the listed contact details.';\n          (target.querySelector('.modal-content, .modal-dialog') || target).append(note);\n        }\n      }\n    }\n    if (event.target.closest('[data-dismiss=\"modal\"]') || event.target === openModal) close();\n    const send = event.target.closest('[data-vitrisid=\"emailSendButton\"]');\n    if (send) { event.preventDefault();const form=send.closest('form');if(form?.hasAttribute('data-preserve-disabled-custom-form'))notice(form,'This preview does not send messages or upload files. Please use the listed contact details.');else form?.requestSubmit(); }\n  });\n  document.addEventListener('keydown', event => {\n    if (event.key === 'Escape') close();\n    if ((event.key === 'Enter' || event.key === ' ') && event.target.matches('[data-toggle=\"modal\"], [data-vitrisid=\"emailSendButton\"], .dropdown-toggle, [data-preserve-disabled-action]')) { event.preventDefault(); event.target.click(); }\n    if (event.key === 'Tab' && openModal) { event.preventDefault(); openModal.focus(); }\n  });\n  document.querySelectorAll('form[data-preserve-forms]').forEach(form => {\n    form.removeAttribute('novalidate');\n    const send = form.querySelector('[data-vitrisid=\"emailSendButton\"]');\n    if (send) { send.tabIndex = 0; send.setAttribute('role','button'); }\n    form.addEventListener('submit', event => {\n      if (form.dataset.preserveForms === 'live') return;\n      event.preventDefault();\n      if(form.hasAttribute('data-preserve-disabled-custom-form')){notice(form,'This preview does not send messages or upload files. Please use the listed contact details.');return;}\n      let note = form.querySelector('[data-preserve-status]');\n      if (!note) { note = document.createElement('p'); note.dataset.preserveStatus = ''; note.setAttribute('role','status'); form.append(note); }\n      note.textContent = 'This preview does not send messages. Please use the listed contact details.';\n    });\n  });\n})();";

package/bin/types/src/preserve/source-defects.d.ts

@@ -0,0 +1,4 @@
+import type { PreserveManifest } from './config.ts';
+/** Preserve proven source defects, never suppress newly introduced broken links/assets. */
+export declare function originalMissingAnchors(original: string, sourceUrl: string, references: Map<string, string>): Set<string>;
+export declare function originalNullImages(manifest: PreserveManifest, originals: string[], copies: string[]): Set<string>;

package/bin/types/src/preserve/supplement.d.ts

@@ -0,0 +1,3 @@
+import type { PreserveManifest } from './config.ts';
+/** Add newly discovered routes/assets without replacing immutable capture records. */
+export declare function preserveManifest(root: string): PreserveManifest;