@mdxui/services 0.1.0

package/README.md

@@ -0,0 +1,58 @@
+# @mdxui/services
+
+The **Services dialect** of the `@mdxui` template family ([ADR 0003](https://github.com/dot-do/startup-sites/blob/main/docs/adr/0003-template-dialects-and-per-archetype-packages.md) §3).
+
+Higher-order, **outcome-led** landing components that expose Services-semantic
+props and compose `@mdxui/neo`'s design language — **not** thin neo re-exports.
+A probate valuation has no SDK, no `npm install`, no MCP nav; this dialect speaks
+the Services grammar (eyebrow → headline → outcome predicate, a Defensibility
+two-up, "per report, no subscription" pricing, an intake funnel) instead of
+neo's dev-first rulebook.
+
+Extracted from [carriage](https://github.com/dot-do/carriage)'s battle-tested
+`src/chassis/` — proven across 7 products + 4 example services + 26 snapshot
+baselines. The Zod schemas in `./schemas` **are** the dialect's prop contract;
+they were authored in carriage's `mdxui-bridge/extensions` and promoted here
+verbatim (every `upstream-proposal` comment documents why the Services shape
+differs from neo/mdxui's).
+
+## Usage
+
+```tsx
+import { ServicesLandingView } from '@mdxui/services'
+
+// The host keeps its derive layer; the package owns the narrative arc.
+const content = deriveCatalog(svc) // → ServicesLandingContent
+return <ServicesLandingView content={content} />
+```
+
+`ServicesLandingView` renders the full arc from one validated content bag:
+
+```
+masthead → hero → problem → what-you-get → how-it-works → defensibility
+        → pricing → faq → final-cta → footer
+```
+
+Individual blocks (`Hero`/`ServiceHero`, `Problem`, `WhatYouGet`, `HowItWorks`,
+`Defensibility`, `Pricing`/`ReportPricing`, `Faq`, `FinalCta`, `Masthead`,
+`Footer`, `ScrollHeader`) are exported from `./components` for bespoke layouts.
+
+## Subpath exports
+
+- `@mdxui/services` — the view + all components + `parseProps` + `schemas`
+- `@mdxui/services/components` — the higher-order Services blocks
+- `@mdxui/services/schemas` — the Zod prop contract (no runtime/React imports)
+- `@mdxui/services/shared` — `ScrollReveal`, `SectionEyebrow`, `SvgInline`
+
+## Theming
+
+Components read the same CSS-variable contract `@mdxui/themes` emits
+(`--ink`/`--accent`/`--cta-*`/`--font-*`, the Tailwind tokens `text-ink`,
+`bg-cta`, `border-line`, …), so a host's per-service theme propagates unchanged.
+
+## Endpoints stay in the host
+
+The package ships UI + the prop contract. Checkout/upload/connect endpoints
+(`/api/checkout`, `/api/upload-logo`, `/api/connect/*`) are platform concerns —
+the form components accept them as props/callbacks so the package deploys in any
+host.

package/dist/components/index.d.ts

@@ -0,0 +1,74 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { H as HeroPropsExtended, e as SiteAction, P as ProblemProps$1, f as ProblemItem$1, W as WhatYouGetProps$1, g as WhatYouGetItem$1, a as HowItWorksProps$1, h as HowItWorksStep$1, D as DefensibilityPropsFromSchema, j as DefensibilityColumnFromSchema, k as PriceTier$1, b as PricingPropsExtended, c as Pricing$1, F as FaqPropsExtended, l as FaqItem$1, d as FinalCtaProps$1, M as MastheadProps$1, S as SiteFooterProps, m as SiteFooterLink } from '../index-D2nWoFGI.js';
+import 'zod/v4/core';
+import 'zod';
+import 'react';
+
+/** Inline call-to-action. Sourced from the schema — `SiteActionSchema`. */
+type HeroAction = SiteAction;
+/** Hero component props. Sourced from the schema (`HeroPropsExtendedSchema`).
+ *  The schema is the canonical shape; this component reads `variant`,
+ *  `showGlyph`, `glyphOnMobile`, `illustration` from it. */
+type HeroProps = HeroPropsExtended;
+declare function HeroSplit({ eyebrow, headline, body, primary, secondary, showGlyph, glyphOnMobile, illustration, }: HeroProps): react_jsx_runtime.JSX.Element;
+declare function PrimaryAction({ action }: {
+    action: HeroAction;
+}): react_jsx_runtime.JSX.Element;
+declare function SecondaryAction({ action }: {
+    action: HeroAction;
+}): react_jsx_runtime.JSX.Element;
+
+declare function Hero(props: HeroProps): react_jsx_runtime.JSX.Element;
+
+declare function HeroStacked({ eyebrow, headline, body, primary, secondary, illustration, }: HeroProps): react_jsx_runtime.JSX.Element;
+
+type ProblemItem = ProblemItem$1;
+type ProblemProps = ProblemProps$1;
+declare function Problem({ eyebrow, heading, items }: ProblemProps): react_jsx_runtime.JSX.Element;
+
+type WhatYouGetItem = WhatYouGetItem$1;
+type WhatYouGetProps = WhatYouGetProps$1;
+declare function WhatYouGet({ eyebrow, heading, sections }: WhatYouGetProps): react_jsx_runtime.JSX.Element | null;
+
+type HowItWorksStep = HowItWorksStep$1;
+/** HowItWorks component props. Sourced from `HowItWorksPropsSchema`, which
+ *  includes the opt-in `stepIllustrations` field. */
+type HowItWorksProps = HowItWorksProps$1;
+declare function HowItWorks({ eyebrow, heading, steps, stepIllustrations, }: HowItWorksProps): react_jsx_runtime.JSX.Element | null;
+
+type DefensibilityColumn = DefensibilityColumnFromSchema;
+type DefensibilityProps = DefensibilityPropsFromSchema;
+declare function Defensibility({ eyebrow, heading, columns, caveat, }: DefensibilityProps): react_jsx_runtime.JSX.Element;
+
+type PriceTier = PriceTier$1;
+/** Legacy tiered-only props shape (omits `kind` + `currency`). The component
+ *  accepts EITHER this OR the wider discriminated `Pricing` union. */
+type PricingProps = PricingPropsExtended;
+/** The canonical discriminated `Pricing` union (carries `kind: 'unit'`). */
+type PricingData = Pricing$1;
+/** Component-level accepted props: the legacy tiered-only shape OR the
+ *  discriminated `Pricing` union. The component branches on `kind` internally. */
+type PricingComponentProps = PricingProps | PricingData;
+declare function Pricing(props: PricingComponentProps): react_jsx_runtime.JSX.Element;
+
+type FaqItem = FaqItem$1;
+type FaqProps = FaqPropsExtended;
+declare function Faq({ eyebrow, heading, items }: FaqProps): react_jsx_runtime.JSX.Element | null;
+
+type FinalCtaProps = FinalCtaProps$1;
+declare function FinalCta({ eyebrow, headline, primary, secondary, }: FinalCtaProps): react_jsx_runtime.JSX.Element;
+
+type MastheadProps = MastheadProps$1;
+declare function Masthead({ brand, cta, eyebrow, narrow }: MastheadProps): react_jsx_runtime.JSX.Element;
+
+type FooterLink = SiteFooterLink;
+type FooterProps = SiteFooterProps;
+declare function Footer({ text, links }: FooterProps): react_jsx_runtime.JSX.Element;
+
+interface ScrollHeaderProps extends MastheadProps {
+    /** Pixels of scrollY before the header reveals. Default 480. */
+    threshold?: number;
+}
+declare function ScrollHeader({ threshold, ...mastheadProps }: ScrollHeaderProps): react_jsx_runtime.JSX.Element;
+
+export { Defensibility, type DefensibilityColumn, type DefensibilityProps, Faq, type FaqItem, type FaqProps, FinalCta, type FinalCtaProps, Footer, type FooterLink, type FooterProps, Hero, type HeroAction, type HeroProps, HeroSplit, HeroStacked, HowItWorks, type HowItWorksProps, type HowItWorksStep, Masthead, type MastheadProps, type PriceTier, Pricing, type PricingComponentProps, type PricingData, type PricingProps, PrimaryAction, Problem, type ProblemItem, type ProblemProps, Pricing as ReportPricing, ScrollHeader, type ScrollHeaderProps, SecondaryAction, Hero as ServiceHero, WhatYouGet, type WhatYouGetItem, type WhatYouGetProps };