@sonordev/agency-site-kit 0.3.1 → 0.4.1

package/dist/portfolio/components/PortfolioLeadCTA.cjs

@@ -0,0 +1,91 @@
+'use client';
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/portfolio/components/PortfolioLeadCTA.tsx
+var PortfolioLeadCTA_exports = {};
+__export(PortfolioLeadCTA_exports, {
+  default: () => PortfolioLeadCTA
+});
+module.exports = __toCommonJS(PortfolioLeadCTA_exports);
+var import_forms = require("@sonordev/site-kit/forms");
+var import_client = require("@sonordev/site-kit/client");
+var import_jsx_runtime = require("react/jsx-runtime");
+function PortfolioLeadCTA({
+  formId,
+  item,
+  heading = "Want results like these?",
+  description = "Tell us about your project and we'll show you what's possible.",
+  className = ""
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "section",
+    {
+      className: `w-full py-20 md:py-28 ${className}`,
+      style: { background: "var(--sk-bg, #0a0a0a)" },
+      "data-portfolio-section": "portfolioLeadForm",
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "max-w-2xl mx-auto px-6", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+        "div",
+        {
+          className: "rounded-2xl p-8 md:p-12",
+          style: {
+            background: "var(--sk-surface, rgba(255,255,255,0.05))",
+            backdropFilter: "blur(16px)",
+            border: "1px solid var(--sk-border, rgba(255,255,255,0.1))"
+          },
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              "h2",
+              {
+                className: "text-2xl md:text-3xl font-bold mb-3",
+                style: {
+                  color: "var(--sk-text-primary, #ffffff)",
+                  fontFamily: "var(--sk-font-heading, inherit)"
+                },
+                children: heading
+              }
+            ),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              "p",
+              {
+                className: "text-base mb-8",
+                style: { color: "var(--sk-text-secondary, #a1a1aa)" },
+                children: description
+              }
+            ),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              import_forms.ManagedForm,
+              {
+                formId,
+                onSuccess: () => {
+                  (0, import_client.trackConversion)({
+                    type: "portfolio_lead",
+                    metadata: { case_study: item.slug, case_study_title: item.title }
+                  });
+                }
+              }
+            )
+          ]
+        }
+      ) })
+    }
+  );
+}
+//# sourceMappingURL=PortfolioLeadCTA.cjs.map

package/dist/portfolio/components/PortfolioLeadCTA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/portfolio/components/PortfolioLeadCTA.tsx"],"sourcesContent":["'use client';\n\n/**\n * PortfolioLeadCTA — turn a case study into a lead source.\n *\n * Renders a Sonor managed form (site-kit ManagedForm — never hand-rolled\n * markup) inside a CTA shell. Attribution comes free on two rails:\n *\n *  1. The submission's metadata.pageUrl (sent automatically by site-kit)\n *     lands in the CRM's page_url/source_url columns — that IS the case\n *     study URL.\n *  2. onSuccess fires a `portfolio_lead` conversion with the case-study\n *     slug via the standalone dispatch, so Signal/analytics can report\n *     \"leads per case study\" without parsing URLs.\n *\n * If the managed form defines a hidden `portfolio_slug` field, define it in\n * the dashboard and it will arrive pre-filled too (fields JSONB).\n */\n\nimport React from 'react';\nimport { ManagedForm } from '@sonordev/site-kit/forms';\nimport { trackConversion } from '@sonordev/site-kit/client';\n\nexport interface PortfolioLeadCTAProps {\n  /** Managed form key from the Sonor dashboard (e.g. \"portfolio-inquiry\"). */\n  formId: string;\n  /** The case study this CTA sits on — used for lead attribution. */\n  item: { slug: string; title: string };\n  heading?: string;\n  description?: string;\n  className?: string;\n}\n\nexport default function PortfolioLeadCTA({\n  formId,\n  item,\n  heading = 'Want results like these?',\n  description = \"Tell us about your project and we'll show you what's possible.\",\n  className = '',\n}: PortfolioLeadCTAProps) {\n  return (\n    <section\n      className={`w-full py-20 md:py-28 ${className}`}\n      style={{ background: 'var(--sk-bg, #0a0a0a)' }}\n      data-portfolio-section=\"portfolioLeadForm\"\n    >\n      <div className=\"max-w-2xl mx-auto px-6\">\n        <div\n          className=\"rounded-2xl p-8 md:p-12\"\n          style={{\n            background: 'var(--sk-surface, rgba(255,255,255,0.05))',\n            backdropFilter: 'blur(16px)',\n            border: '1px solid var(--sk-border, rgba(255,255,255,0.1))',\n          }}\n        >\n          <h2\n            className=\"text-2xl md:text-3xl font-bold mb-3\"\n            style={{\n              color: 'var(--sk-text-primary, #ffffff)',\n              fontFamily: 'var(--sk-font-heading, inherit)',\n            }}\n          >\n            {heading}\n          </h2>\n          <p\n            className=\"text-base mb-8\"\n            style={{ color: 'var(--sk-text-secondary, #a1a1aa)' }}\n          >\n            {description}\n          </p>\n\n          <ManagedForm\n            formId={formId}\n            onSuccess={() => {\n              trackConversion({\n                type: 'portfolio_lead',\n                metadata: { case_study: item.slug, case_study_title: item.title },\n              });\n            }}\n          />\n        </div>\n      </div>\n    </section>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA,mBAA4B;AAC5B,oBAAgC;AA0BxB;AAdO,SAAR,iBAAkC;AAAA,EACvC;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV,cAAc;AAAA,EACd,YAAY;AACd,GAA0B;AACxB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,yBAAyB,SAAS;AAAA,MAC7C,OAAO,EAAE,YAAY,wBAAwB;AAAA,MAC7C,0BAAuB;AAAA,MAEvB,sDAAC,SAAI,WAAU,0BACb;AAAA,QAAC;AAAA;AAAA,UACC,WAAU;AAAA,UACV,OAAO;AAAA,YACL,YAAY;AAAA,YACZ,gBAAgB;AAAA,YAChB,QAAQ;AAAA,UACV;AAAA,UAEA;AAAA;AAAA,cAAC;AAAA;AAAA,gBACC,WAAU;AAAA,gBACV,OAAO;AAAA,kBACL,OAAO;AAAA,kBACP,YAAY;AAAA,gBACd;AAAA,gBAEC;AAAA;AAAA,YACH;AAAA,YACA;AAAA,cAAC;AAAA;AAAA,gBACC,WAAU;AAAA,gBACV,OAAO,EAAE,OAAO,oCAAoC;AAAA,gBAEnD;AAAA;AAAA,YACH;AAAA,YAEA;AAAA,cAAC;AAAA;AAAA,gBACC;AAAA,gBACA,WAAW,MAAM;AACf,qDAAgB;AAAA,oBACd,MAAM;AAAA,oBACN,UAAU,EAAE,YAAY,KAAK,MAAM,kBAAkB,KAAK,MAAM;AAAA,kBAClE,CAAC;AAAA,gBACH;AAAA;AAAA,YACF;AAAA;AAAA;AAAA,MACF,GACF;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/portfolio/components/PortfolioLeadCTA.d.cts

@@ -0,0 +1,34 @@
+import React from 'react';
+
+/**
+ * PortfolioLeadCTA — turn a case study into a lead source.
+ *
+ * Renders a Sonor managed form (site-kit ManagedForm — never hand-rolled
+ * markup) inside a CTA shell. Attribution comes free on two rails:
+ *
+ *  1. The submission's metadata.pageUrl (sent automatically by site-kit)
+ *     lands in the CRM's page_url/source_url columns — that IS the case
+ *     study URL.
+ *  2. onSuccess fires a `portfolio_lead` conversion with the case-study
+ *     slug via the standalone dispatch, so Signal/analytics can report
+ *     "leads per case study" without parsing URLs.
+ *
+ * If the managed form defines a hidden `portfolio_slug` field, define it in
+ * the dashboard and it will arrive pre-filled too (fields JSONB).
+ */
+
+interface PortfolioLeadCTAProps {
+    /** Managed form key from the Sonor dashboard (e.g. "portfolio-inquiry"). */
+    formId: string;
+    /** The case study this CTA sits on — used for lead attribution. */
+    item: {
+        slug: string;
+        title: string;
+    };
+    heading?: string;
+    description?: string;
+    className?: string;
+}
+declare function PortfolioLeadCTA({ formId, item, heading, description, className, }: PortfolioLeadCTAProps): React.JSX.Element;
+
+export { type PortfolioLeadCTAProps, PortfolioLeadCTA as default };

package/dist/portfolio/components/PortfolioLeadCTA.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+
+/**
+ * PortfolioLeadCTA — turn a case study into a lead source.
+ *
+ * Renders a Sonor managed form (site-kit ManagedForm — never hand-rolled
+ * markup) inside a CTA shell. Attribution comes free on two rails:
+ *
+ *  1. The submission's metadata.pageUrl (sent automatically by site-kit)
+ *     lands in the CRM's page_url/source_url columns — that IS the case
+ *     study URL.
+ *  2. onSuccess fires a `portfolio_lead` conversion with the case-study
+ *     slug via the standalone dispatch, so Signal/analytics can report
+ *     "leads per case study" without parsing URLs.
+ *
+ * If the managed form defines a hidden `portfolio_slug` field, define it in
+ * the dashboard and it will arrive pre-filled too (fields JSONB).
+ */
+
+interface PortfolioLeadCTAProps {
+    /** Managed form key from the Sonor dashboard (e.g. "portfolio-inquiry"). */
+    formId: string;
+    /** The case study this CTA sits on — used for lead attribution. */
+    item: {
+        slug: string;
+        title: string;
+    };
+    heading?: string;
+    description?: string;
+    className?: string;
+}
+declare function PortfolioLeadCTA({ formId, item, heading, description, className, }: PortfolioLeadCTAProps): React.JSX.Element;
+
+export { type PortfolioLeadCTAProps, PortfolioLeadCTA as default };

package/dist/portfolio/components/PortfolioLeadCTA.js

@@ -0,0 +1,9 @@
+'use client';
+"use client";
+import {
+  PortfolioLeadCTA
+} from "../../chunk-CVT7I5BQ.js";
+export {
+  PortfolioLeadCTA as default
+};
+//# sourceMappingURL=PortfolioLeadCTA.js.map

package/dist/portfolio/components/PortfolioLeadCTA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/portfolio/index.cjs

@@ -1,42 +1,66 @@
 'use strict';
 
-var chunkAVCH4LMG_cjs = require('../chunk-AVCH4LMG.cjs');
-require('../chunk-XONXEFJY.cjs');
-require('../chunk-633UMQQH.cjs');
-var chunkXQNJED46_cjs = require('../chunk-XQNJED46.cjs');
-var chunkOA5ZM4OA_cjs = require('../chunk-OA5ZM4OA.cjs');
-require('../chunk-KEOHORIH.cjs');
-require('../chunk-IKBK7HYX.cjs');
+var chunkQGSW43TM_cjs = require('../chunk-QGSW43TM.cjs');
+var chunkZBPF7TLZ_cjs = require('../chunk-ZBPF7TLZ.cjs');
+var chunkUXUU7FVT_cjs = require('../chunk-UXUU7FVT.cjs');
+require('../chunk-7ZHRMWJU.cjs');
+require('../chunk-FCKDJ4MJ.cjs');
+require('../chunk-HQGAX2LI.cjs');
+require('../chunk-XOWSXZYW.cjs');
 
 
 
 Object.defineProperty(exports, "PORTFOLIO_SECTION_TYPES", {
   enumerable: true,
-  get: function () { return chunkAVCH4LMG_cjs.PORTFOLIO_SECTION_TYPES; }
+  get: function () { return chunkQGSW43TM_cjs.PORTFOLIO_SECTION_TYPES; }
+});
+Object.defineProperty(exports, "PortfolioIndex", {
+  enumerable: true,
+  get: function () { return chunkQGSW43TM_cjs.PortfolioIndex; }
+});
+Object.defineProperty(exports, "PortfolioIndexSkeleton", {
+  enumerable: true,
+  get: function () { return chunkQGSW43TM_cjs.PortfolioIndexSkeleton; }
 });
 Object.defineProperty(exports, "PortfolioPage", {
   enumerable: true,
-  get: function () { return chunkAVCH4LMG_cjs.PortfolioPage; }
+  get: function () { return chunkQGSW43TM_cjs.PortfolioPage; }
+});
+Object.defineProperty(exports, "PortfolioPageSkeleton", {
+  enumerable: true,
+  get: function () { return chunkQGSW43TM_cjs.PortfolioPageSkeleton; }
+});
+Object.defineProperty(exports, "PortfolioSchema", {
+  enumerable: true,
+  get: function () { return chunkQGSW43TM_cjs.PortfolioSchema; }
+});
+Object.defineProperty(exports, "formatCategoryLabel", {
+  enumerable: true,
+  get: function () { return chunkZBPF7TLZ_cjs.formatCategoryLabel; }
+});
+Object.defineProperty(exports, "formatServiceTag", {
+  enumerable: true,
+  get: function () { return chunkZBPF7TLZ_cjs.formatServiceTag; }
 });
-Object.defineProperty(exports, "getRegisteredSectionTypes", {
+Object.defineProperty(exports, "MetricsProvenance", {
   enumerable: true,
-  get: function () { return chunkXQNJED46_cjs.getRegisteredSectionTypes; }
+  get: function () { return chunkUXUU7FVT_cjs.MetricsProvenance; }
 });
-Object.defineProperty(exports, "getSectionRenderer", {
+Object.defineProperty(exports, "curateHeroKpis", {
   enumerable: true,
-  get: function () { return chunkXQNJED46_cjs.getSectionRenderer; }
+  get: function () { return chunkUXUU7FVT_cjs.curateHeroKpis; }
 });
-Object.defineProperty(exports, "registerSectionRenderer", {
+Object.defineProperty(exports, "curatePortfolioProof", {
   enumerable: true,
-  get: function () { return chunkXQNJED46_cjs.registerSectionRenderer; }
+  get: function () { return chunkUXUU7FVT_cjs.curatePortfolioProof; }
 });
-Object.defineProperty(exports, "PortfolioCard", {
+Object.defineProperty(exports, "curateResultItems", {
   enumerable: true,
-  get: function () { return chunkOA5ZM4OA_cjs.PortfolioCard; }
+  get: function () { return chunkUXUU7FVT_cjs.curateResultItems; }
 });
-Object.defineProperty(exports, "PortfolioGrid", {
+Object.defineProperty(exports, "gateMetricsDeltas", {
   enumerable: true,
-  get: function () { return chunkOA5ZM4OA_cjs.PortfolioGrid; }
+  get: function () { return chunkUXUU7FVT_cjs.gateMetricsDeltas; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/portfolio/index.d.cts

@@ -1,12 +1,215 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PortfolioItemFull } from '../types-DL4t_Cfa.cjs';
-export { M as MetricSource, e as MetricsDelta, f as MetricsSnapshot, g as PORTFOLIO_SECTION_TYPES, i as PortfolioBeforeAfterData, j as PortfolioCTAData, l as PortfolioChallengesData, n as PortfolioConversionFunnelData, o as PortfolioDetailsData, p as PortfolioFeatureSpotlightData, r as PortfolioGalleryData, t as PortfolioHeroData, u as PortfolioItem, v as PortfolioKPI, a as PortfolioListResponse, x as PortfolioMetricsTimelineData, z as PortfolioResultsData, A as PortfolioSection, d as PortfolioSectionData, c as PortfolioSectionDataMap, b as PortfolioSectionType, C as PortfolioSeoData, E as PortfolioServicesData, F as PortfolioStrategyData, H as PortfolioTeamData, K as PortfolioTechStackData, L as PortfolioTestimonialData, N as PortfolioVideoData } from '../types-DL4t_Cfa.cjs';
-export { PortfolioCard, PortfolioCardProps, PortfolioFilterProps, PortfolioGrid, PortfolioGridProps, PortfolioPageClientProps, PortfolioSectionRendererProps } from './client.cjs';
-export { PortfolioSectionRenderer, PortfolioSectionRenderer as SectionRenderer, getRegisteredSectionTypes, getSectionRenderer, registerSectionRenderer } from './sections.cjs';
+import React from 'react';
+import { P as PortfolioItemFull, M as MetricsDelta, x as PortfolioKPI, A as PortfolioResultItem } from '../types-0tVPy4pU.cjs';
+export { j as MetricSource, k as MetricsSnapshot, l as PORTFOLIO_SECTION_TYPES, n as PortfolioBeforeAfterData, o as PortfolioCTAData, c as PortfolioChallengesData, r as PortfolioConversionFunnelData, d as PortfolioDetailsData, s as PortfolioFeatureSpotlightData, u as PortfolioGalleryData, e as PortfolioHeroData, w as PortfolioItem, b as PortfolioListResponse, z as PortfolioMetricsTimelineData, f as PortfolioResultsData, a as PortfolioSection, C as PortfolioSectionData, D as PortfolioSectionDataMap, E as PortfolioSectionType, F as PortfolioSeoData, g as PortfolioServicesData, H as PortfolioStrategyData, J as PortfolioTeamData, h as PortfolioTechStackData, i as PortfolioTestimonialData, N as PortfolioVideoData } from '../types-0tVPy4pU.cjs';
+export * from '@sonordev/agency-site-kit/portfolio/client';
+
+/**
+ * PortfolioPage — Server component that renders a full portfolio case study.
+ *
+ * Maps each section in item.sections to the correct renderer component.
+ * All sections below the hero are loaded lazily via next/dynamic.
+ *
+ * NOTE: This file is intentionally NOT a client component — it is designed
+ * to be used as an RSC in a Next.js app directory page.
+ *
+ * Sections MUST be imported via `@sonordev/agency-site-kit/portfolio/sections/*`
+ * (self-referencing subpaths, external in tsup's server build), never via
+ * relative paths: a relative import would bundle the client sections into
+ * this server chunk, the 'use client' boundary would be lost, and the whole
+ * PortfolioItemFull would serialize into the RSC flight payload again.
+ *
+ * Whether a section is a server or client component is decided by the
+ * section file itself (its 'use client' directive; tsup routes it to the
+ * matching build). Server sections are imported statically — they ship zero
+ * client JS, so there is nothing to lazy-load. Client sections load through
+ * next/dynamic so each becomes its own browser chunk, fetched only when the
+ * case study actually renders that section type.
+ */
 
 interface PortfolioPageProps {
     item: PortfolioItemFull;
 }
-declare function PortfolioPage({ item }: PortfolioPageProps): react_jsx_runtime.JSX.Element;
+declare function PortfolioPage({ item: rawItem }: PortfolioPageProps): React.JSX.Element;
+
+/**
+ * PortfolioSchema — JSON-LD structured data for a case study page.
+ *
+ * Server component: renders a single <script type="application/ld+json">
+ * describing the case study as a schema.org Article (there is no dedicated
+ * CaseStudy type; Article is what Google documents for editorial content).
+ * Ships zero client JS and adds rich-result eligibility + entity clarity for
+ * the agency's portfolio pages.
+ *
+ * Usage (in the case study page, next to <PortfolioPage />):
+ *
+ * ```tsx
+ * <PortfolioSchema
+ *   item={item}
+ *   url={`https://youragency.com/work/${item.slug}`}
+ *   publisher={{ name: 'Your Agency', url: 'https://youragency.com' }}
+ * />
+ * ```
+ *
+ * Only reads fields from the already-sanitized PortfolioItemFull (see
+ * getPortfolioItem / sanitize.ts) — never section internals.
+ */
+
+interface PortfolioSchemaProps {
+    item: PortfolioItemFull;
+    /** Canonical URL of this case study page. */
+    url: string;
+    /** The agency, emitted as author + publisher Organization. */
+    publisher?: {
+        name: string;
+        url?: string;
+        /** Absolute URL to a logo image. */
+        logo?: string;
+    };
+}
+declare function PortfolioSchema({ item, url, publisher }: PortfolioSchemaProps): React.JSX.Element;
+
+/**
+ * PortfolioIndex — turnkey, server-rendered /work index.
+ *
+ * Fetches items + categories and renders: category nav (real links —
+ * crawlable, no client state), the portfolio grid, pagination, and an
+ * intentional empty state. Ships zero component JS.
+ *
+ * Category filtering is route-based for SEO:
+ *   /work                       → all items
+ *   /work/category/[category]   → one category (slug via slugifyCategory)
+ * Pagination via ?page= on either route.
+ */
+
+interface PortfolioIndexProps {
+    /** Route prefix for case studies + category links. Defaults to "/work". */
+    basePath?: string;
+    /** Active category SLUG (from the [category] route param). */
+    category?: string | null;
+    /** 1-based page number (from ?page=). */
+    page?: number;
+    /** Items per page. Defaults to 12. */
+    pageSize?: number;
+    /** Optional heading block rendered above the category nav. */
+    heading?: React.ReactNode;
+    /** Override the empty state. */
+    emptyState?: React.ReactNode;
+    /** Hide the category nav (e.g. single-category portfolios). */
+    showCategories?: boolean;
+    className?: string;
+}
+declare function PortfolioIndex({ basePath, category, page, pageSize, heading, emptyState, showCategories, className, }: PortfolioIndexProps): Promise<React.JSX.Element>;
+
+/**
+ * MetricsProvenance — "these numbers are real" strip for case studies.
+ *
+ * Server component, zero JS. Renders the live metric deltas the platform
+ * computes from GSC/analytics baselines (MetricsDelta[]) plus the refresh
+ * timestamp — the trust signal a static agency portfolio can't fake.
+ *
+ * `direction` semantics come from the API: 'up' ALWAYS means "improved"
+ * (lower-is-better metrics like Avg Position/LCP are inverted server-side
+ * in metrics-baseline.service), so 'up' renders green. The ARROW glyph
+ * follows the raw numbers instead — an improved bounce rate shows a green ▼,
+ * never a green ▲ next to a value that visibly went down.
+ *
+ * Deltas pass through gateMetricsDeltas (curate-proof.ts) before display:
+ * raw platform deltas carry no editorial judgment, and this strip only
+ * exists to flatter — see that module for the policy.
+ */
+
+interface MetricsProvenanceProps {
+    deltas: MetricsDelta[];
+    /** ISO timestamp of the last live-metrics refresh. */
+    refreshedAt?: string | null;
+}
+declare function MetricsProvenance({ deltas, refreshedAt }: MetricsProvenanceProps): React.JSX.Element | null;
+
+/**
+ * curate-proof — single source of truth for which proof points a public case
+ * study is allowed to display, and in what shape.
+ *
+ * Two classes of problem this guards against (both shipped to production on
+ * upforge.io before this existed):
+ *
+ * 1. Repetition: generated items arrive with four "100/100 Lighthouse X"
+ *    KPIs in the hero, the same four restated as Results cards, AND a full
+ *    Performance section with score gauges. One differentiator repeated
+ *    twelve times per page stops differentiating. The Performance section is
+ *    the one home for the Lighthouse breakdown; hero/results/cards collapse
+ *    to at most one summary tile.
+ *
+ * 2. Self-harming live metrics: MetricsDelta rows are computed from raw
+ *    analytics baselines with no editorial judgment — a bounce rate of
+ *    "100 → 99.69" rendered as a green win. Marketing surfaces only show a
+ *    delta when it's a genuinely flattering, meaningful story.
+ *
+ * Used by PortfolioPage (hero KPIs + results items), PortfolioCard (KPI
+ * preview), and MetricsProvenance (delta gate). Change display policy here,
+ * nowhere else.
+ */
+
+/**
+ * Collapse per-category Lighthouse KPIs to at most one summary tile, business
+ * outcomes first. When every category is present at 100 the summary says so;
+ * otherwise the Performance category (the one buyers know) represents the set.
+ */
+declare function curateHeroKpis(kpis: PortfolioKPI[]): PortfolioKPI[];
+/**
+ * Drop Results cards that restate Lighthouse scores when the case study also
+ * renders a Performance section (the score breakdown's single home).
+ */
+declare function curateResultItems(items: PortfolioResultItem[], hasPerformanceSection: boolean): PortfolioResultItem[];
+/**
+ * Editorial gate for live metric deltas ("Verified from live analytics").
+ * `direction` comes from the platform with 'up' meaning IMPROVED (lower-is-
+ * better metrics are inverted server-side). A public case study only shows a
+ * delta when it's a win worth telling:
+ *  - improved ('up'), never a regression or flat noise
+ *  - moved by a double-digit relative margin (small drift isn't a story)
+ *  - bounce-rate-style metrics must also be respectable in absolute terms —
+ *    "100 → 99.69" is technically an improvement and still self-harm
+ */
+declare function gateMetricsDeltas(deltas: MetricsDelta[] | undefined | null): MetricsDelta[];
+/**
+ * Apply the full display policy to a portfolio item before rendering.
+ * Pure — returns a new item; the fetched payload is never mutated.
+ */
+declare function curatePortfolioProof(item: PortfolioItemFull): PortfolioItemFull;
+
+/**
+ * Presentation formatters shared by portfolio components and consuming apps.
+ */
+/**
+ * Human label for a category slug. Single source of truth — HeroSection,
+ * PortfolioCard, and app-side filter chips all render categories through
+ * this. Underscores become spaces; hyphens are PRESERVED so compound slugs
+ * keep their canonical form ("e-commerce" → "E-Commerce", never "E Commerce"),
+ * and every word start (including after a hyphen) is capitalized.
+ */
+declare function formatCategoryLabel(slug: string | undefined | null): string;
+/**
+ * Normalize a service tag's casing for display: the first character of each
+ * word is uppercased, the rest left alone (so "Next.js development" becomes
+ * "Next.js Development" and "Technical SEO implementation" keeps "SEO").
+ * Fixes per-item casing drift in stored tags without touching the data.
+ */
+declare function formatServiceTag(tag: string | undefined | null): string;
+
+/**
+ * Loading skeletons for portfolio routes — pure CSS pulse, server-safe,
+ * zero JS. Drop into `loading.tsx`:
+ *
+ * ```tsx
+ * export { PortfolioIndexSkeleton as default } from '@sonordev/agency-site-kit/portfolio';
+ * ```
+ */
+
+/** Grid of pulsing card placeholders for the /work index. */
+declare function PortfolioIndexSkeleton({ cards }: {
+    cards?: number;
+}): React.JSX.Element;
+/** Hero-shaped placeholder for /work/[slug] case study pages. */
+declare function PortfolioPageSkeleton(): React.JSX.Element;
 
-export { PortfolioItemFull, PortfolioPage };
+export { MetricsDelta, MetricsProvenance, PortfolioIndex, type PortfolioIndexProps, PortfolioIndexSkeleton, PortfolioItemFull, PortfolioKPI, PortfolioPage, PortfolioPageSkeleton, PortfolioSchema, curateHeroKpis, curatePortfolioProof, curateResultItems, formatCategoryLabel, formatServiceTag, gateMetricsDeltas };