@brandlab-digital/site-next 3.14.0 → 3.15.0

package/dist/ui-kit/sections/nearby-areas.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `NearbyAreas` (S18, `nearby-areas`, 3.15.0): links to the real neighbours of a suburb page, or the same service in
+ * the neighbouring suburbs on a service-in-suburb page. Server component.
+ *
+ * Locked (v1 §4.4, L3): the nearest served suburbs by real distance between registry centres, nearest first, never
+ * shuffled or alphabetical; `nearbyAreaLinks()` builds them with site-core's `nearestSuburbsWithin`. Distances rank the
+ * links and are never printed (L10). The list is lean (cost item 1f): `LinkList` entries are plain `<li><a>` with no
+ * class, hook or icon, so each link stays under 120 bytes, and nothing in it prefetches (`data-bl-links="nearby"`, W2).
+ * 4 to 6 links suit most pages; 12 is the most it renders.
+ */
+import Link from 'next/link';
+import { nearestSuburbsWithin } from '@brandlab-digital/site-core/locations';
+import { SECTION_READY } from '@brandlab-digital/site-core/section-order';
+import { LinkList } from '../primitives/lists.js';
+import { Section, SectionHeading } from '../primitives/layout.js';
+import { slot } from '../skin.js';
+/** The most neighbours the section lists. */
+export const NEARBY_AREAS_LIMIT = 12;
+/** The neighbours `nearbyAreaLinks` returns by default (v1 §4.4: 4 to 6). */
+export const NEARBY_AREAS_DEFAULT = 6;
+export const NEARBY_AREAS_VARIANTS = ['list', 'chips'];
+/**
+ * The nearest served suburbs to `origin` as links, nearest first by real distance (`nearestSuburbsWithin`). `link`
+ * gives a suburb's page (or `undefined` to leave it out, for a suburb without that page).
+ */
+export function nearbyAreaLinks(origin, served, options) {
+    const limit = options.limit ?? NEARBY_AREAS_DEFAULT;
+    if (limit > NEARBY_AREAS_LIMIT)
+        throw new Error(`nearbyAreaLinks: at most ${NEARBY_AREAS_LIMIT} neighbours.`);
+    const candidates = served.filter((suburb) => options.link(suburb) !== undefined);
+    return nearestSuburbsWithin(origin, candidates, { centreOf: options.centreOf, limit, ...(options.maxKm !== undefined ? { maxKm: options.maxKm } : {}) }).map((entry) => options.link(entry.slug));
+}
+/** The guard for `SectionSequence`. */
+export function nearbyAreasReady({ areas }) {
+    return areas.length > 0 ? SECTION_READY : { render: false, reason: 'no-nearby-areas' };
+}
+export function NearbyAreas({ title, eyebrow, lead, areas, regionLink, more, headingId = 'nearby-areas-heading', tone, variant = 'list', layout, classes }) {
+    if (areas.length === 0)
+        return null;
+    if (areas.length > NEARBY_AREAS_LIMIT)
+        throw new Error(`NearbyAreas: ${areas.length} neighbours; the section lists at most ${NEARBY_AREAS_LIMIT}.`);
+    if (new Set(areas.map((area) => area.href)).size !== areas.length)
+        throw new Error('NearbyAreas: a neighbour is listed twice.');
+    if (regionLink && areas.some((area) => area.href === regionLink.href))
+        throw new Error('NearbyAreas: the region link repeats a neighbour.');
+    return (_jsxs(Section, { id: "nearby-areas", labelledBy: headingId, tone: tone, variant: variant, classes: classes, children: [_jsx(SectionHeading, { id: headingId, title: title, eyebrow: eyebrow, lead: lead, classes: classes }), _jsx(LinkList, { links: areas, kind: "nearby", layout: layout, classes: { root: classes?.list } }), regionLink ? (_jsx("p", { ...slot(classes, 'region'), children: _jsx(Link, { href: regionLink.href, prefetch: false, children: regionLink.label }) })) : null, more ? (_jsx("p", { ...slot(classes, 'more'), children: _jsx(Link, { href: more.href, prefetch: false, children: more.label }) })) : null] }));
+}
+//# sourceMappingURL=nearby-areas.js.map

package/dist/ui-kit/sections/nearby-areas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearby-areas.js","sourceRoot":"","sources":["../../../src/ui-kit/sections/nearby-areas.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * `NearbyAreas` (S18, `nearby-areas`, 3.15.0): links to the real neighbours of a suburb page, or the same service in\n * the neighbouring suburbs on a service-in-suburb page. Server component.\n *\n * Locked (v1 §4.4, L3): the nearest served suburbs by real distance between registry centres, nearest first, never\n * shuffled or alphabetical; `nearbyAreaLinks()` builds them with site-core's `nearestSuburbsWithin`. Distances rank the\n * links and are never printed (L10). The list is lean (cost item 1f): `LinkList` entries are plain `<li><a>` with no\n * class, hook or icon, so each link stays under 120 bytes, and nothing in it prefetches (`data-bl-links=\"nearby\"`, W2).\n * 4 to 6 links suit most pages; 12 is the most it renders.\n */\nimport Link from 'next/link'\nimport type { ReactNode } from 'react'\nimport { nearestSuburbsWithin, type SuburbCentreLookup } from '@brandlab-digital/site-core/locations'\nimport { SECTION_READY, type BrandlabSectionReadiness } from '@brandlab-digital/site-core/section-order'\nimport { LinkList, type LinkListLayout } from '../primitives/lists.js'\nimport { Section, SectionHeading, type SectionHeadingSlot, type SectionSlot, type SectionTone } from '../primitives/layout.js'\nimport { slot, type SkinEntry } from '../skin.js'\nimport type { UiLink } from '../types.js'\n\n/** The most neighbours the section lists. */\nexport const NEARBY_AREAS_LIMIT = 12\n/** The neighbours `nearbyAreaLinks` returns by default (v1 §4.4: 4 to 6). */\nexport const NEARBY_AREAS_DEFAULT = 6\n\nexport const NEARBY_AREAS_VARIANTS = ['list', 'chips'] as const\nexport type NearbyAreasVariant = (typeof NEARBY_AREAS_VARIANTS)[number]\nexport type NearbyAreasSlot = SectionSlot | SectionHeadingSlot | 'list' | 'region' | 'more'\nexport type NearbyAreasLayout = LinkListLayout\nexport type NearbyAreasSkin = SkinEntry<NearbyAreasSlot, NearbyAreasVariant, NearbyAreasLayout>\n\nexport interface NearbyAreasProps extends NearbyAreasSkin {\n  /** The H2, for example \"Tree removal near Castle Hill\". */\n  readonly title: ReactNode\n  readonly eyebrow?: ReactNode\n  readonly lead?: ReactNode\n  /** The neighbours, nearest first (`nearbyAreaLinks`). */\n  readonly areas: readonly UiLink[]\n  /**\n   * The page of the region these suburbs belong to, for example `{ label: 'All of the Hills District', href:\n   * '/tree-services/hills-district' }` (the label is site copy). It sits after the ranked list, outside it, so it is\n   * never ranked by distance, and it is never prefetched.\n   */\n  readonly regionLink?: UiLink\n  /** A link after the list (and the region link), for example the areas hub. Never prefetched. */\n  readonly more?: UiLink\n  /** Defaults to `nearby-areas-heading`. */\n  readonly headingId?: string\n  /** Set by `SectionSequence`. */\n  readonly tone?: SectionTone\n}\n\n/**\n * The nearest served suburbs to `origin` as links, nearest first by real distance (`nearestSuburbsWithin`). `link`\n * gives a suburb's page (or `undefined` to leave it out, for a suburb without that page).\n */\nexport function nearbyAreaLinks(\n  origin: string,\n  served: readonly string[],\n  options: { readonly centreOf: SuburbCentreLookup; readonly link: (suburb: string) => UiLink | undefined; readonly limit?: number; readonly maxKm?: number },\n): UiLink[] {\n  const limit = options.limit ?? NEARBY_AREAS_DEFAULT\n  if (limit > NEARBY_AREAS_LIMIT) throw new Error(`nearbyAreaLinks: at most ${NEARBY_AREAS_LIMIT} neighbours.`)\n  const candidates = served.filter((suburb) => options.link(suburb) !== undefined)\n  return nearestSuburbsWithin(origin, candidates, { centreOf: options.centreOf, limit, ...(options.maxKm !== undefined ? { maxKm: options.maxKm } : {}) }).map(\n    (entry) => options.link(entry.slug)!,\n  )\n}\n\n/** The guard for `SectionSequence`. */\nexport function nearbyAreasReady({ areas }: Pick<NearbyAreasProps, 'areas'>): BrandlabSectionReadiness {\n  return areas.length > 0 ? SECTION_READY : { render: false, reason: 'no-nearby-areas' }\n}\n\nexport function NearbyAreas({ title, eyebrow, lead, areas, regionLink, more, headingId = 'nearby-areas-heading', tone, variant = 'list', layout, classes }: NearbyAreasProps) {\n  if (areas.length === 0) return null\n  if (areas.length > NEARBY_AREAS_LIMIT) throw new Error(`NearbyAreas: ${areas.length} neighbours; the section lists at most ${NEARBY_AREAS_LIMIT}.`)\n  if (new Set(areas.map((area) => area.href)).size !== areas.length) throw new Error('NearbyAreas: a neighbour is listed twice.')\n  if (regionLink && areas.some((area) => area.href === regionLink.href)) throw new Error('NearbyAreas: the region link repeats a neighbour.')\n  return (\n    <Section id=\"nearby-areas\" labelledBy={headingId} tone={tone} variant={variant} classes={classes}>\n      <SectionHeading id={headingId} title={title} eyebrow={eyebrow} lead={lead} classes={classes} />\n      <LinkList links={areas} kind=\"nearby\" layout={layout} classes={{ root: classes?.list }} />\n      {regionLink ? (\n        <p {...slot(classes, 'region')}>\n          <Link href={regionLink.href} prefetch={false}>\n            {regionLink.label}\n          </Link>\n        </p>\n      ) : null}\n      {more ? (\n        <p {...slot(classes, 'more')}>\n          <Link href={more.href} prefetch={false}>\n            {more.label}\n          </Link>\n        </p>\n      ) : null}\n    </Section>\n  )\n}\n"]}

package/dist/ui-kit/sections/nearby-jobs.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `NearbyJobs` (S17, `nearby-jobs`, 3.15.0): proof of real work near this place. Server component.
+ *
+ * The cards come from the job log (site-core `./jobs`): `nearbyJobs(origin, jobs, { centreOf, service })` ranks the
+ * page suburb's own jobs first, then others by real distance within 10 km, at most three. Each card's heading is
+ * `jobCardLabel`: "Tree removal in Castle Hill" for the page's own suburb, "Tree removal nearby: Ryde" for any other
+ * (L4); only a job whose month is known says "Recent" (or `labelPrefix`) and ends ", {Month Year}". Distances rank the cards and are never
+ * printed (L10). A card shows the job's first photo through `Media`, and only a genuine photo of that job: a stock or AI
+ * image never stands for the client's work. With no job close enough the section renders nothing and its guard says
+ * so (`no-jobs-nearby`, D2). A card links to the job's project page when the site has one (prefetch on intent).
+ * Card photos are always lazy. `pagePhotos` names the photos the page already shows (the hero's): a card then takes the
+ * job's next genuine photo, or none, so the hero's priority photo is never repeated below as a lazy copy (3.15.0; on
+ * AA's suburb pages the repeat made Next report the hero, the LCP image, as lazy and downloaded it twice).
+ */
+import type { ReactNode } from 'react';
+import { type BrandlabJob, type BrandlabNearbyJob } from '@brandlab-digital/site-core/jobs';
+import type { BrandlabMediaManifest } from '@brandlab-digital/site-core/media';
+import { type BrandlabSectionReadiness } from '@brandlab-digital/site-core/section-order';
+import { type MediaLayout } from '../primitives/media.js';
+import { type SectionHeadingSlot, type SectionSlot, type SectionTone } from '../primitives/layout.js';
+import type { RepeatedSlotOf } from '../repeated-slots.js';
+import { type SkinEntry } from '../skin.js';
+export declare const NEARBY_JOBS_VARIANTS: readonly ["grid", "rail"];
+export type NearbyJobsVariant = (typeof NEARBY_JOBS_VARIANTS)[number];
+export type NearbyJobsSlot = SectionSlot | SectionHeadingSlot | 'list' | RepeatedSlotOf<'nearbyJobs'>;
+/** Rendered once per job: styled from the skin stylesheet, never by class. */
+export type NearbyJobsRepeatedSlot = RepeatedSlotOf<'nearbyJobs'>;
+export interface NearbyJobsLayout {
+    /** `grid`: columns on wide screens. Defaults to 3. */
+    readonly columns?: 2 | 3;
+    /** The photo's crop. Defaults to 4:3. */
+    readonly ratio?: NonNullable<MediaLayout['ratio']>;
+}
+export type NearbyJobsSkin = SkinEntry<NearbyJobsSlot, NearbyJobsVariant, NearbyJobsLayout, NearbyJobsRepeatedSlot>;
+export interface NearbyJobsProps extends NearbyJobsSkin {
+    /** The H2, for example "Recent tree work near Castle Hill". */
+    readonly title: ReactNode;
+    readonly eyebrow?: ReactNode;
+    readonly lead?: ReactNode;
+    /** The ranked cards from `nearbyJobs()`, nearest first; at most three. */
+    readonly jobs: readonly BrandlabNearbyJob[];
+    /** The page's suburb slug: its own jobs read "in {Suburb}", every other "nearby: {Suburb}". */
+    readonly pageSuburb: string;
+    /** The service's name from the site's catalogue, for example `(slug) => services[slug].name`. */
+    readonly serviceName: (service: string) => string;
+    /** The suburb's name from the registry. */
+    readonly suburbName: (suburb: string) => string;
+    /** Replaces "Recent" on a dated card ("Completed tree removal …"); `''` for none. An undated card never has one. */
+    readonly labelPrefix?: string;
+    /** The media manifest, for the jobs' photos. Left out, the cards show no photo. */
+    readonly media?: BrandlabMediaManifest;
+    /** Photos the page already shows, such as the hero's: media ids or `src` paths. A card never repeats one. */
+    readonly pagePhotos?: readonly string[];
+    /** The job's project page, when the site has one. */
+    readonly jobHref?: (job: BrandlabJob) => string | undefined;
+    /** The photo `sizes`. Defaults to one column of the grid. */
+    readonly imageSizes?: string;
+    /** Defaults to `nearby-jobs-heading`. */
+    readonly headingId?: string;
+    /** Set by `SectionSequence`. */
+    readonly tone?: SectionTone;
+}
+/** The guard for `SectionSequence`: no card means no section (D2). */
+export declare function nearbyJobsReady({ jobs }: Pick<NearbyJobsProps, 'jobs'>): BrandlabSectionReadiness;
+export declare function NearbyJobs({ title, eyebrow, lead, jobs, pageSuburb, serviceName, suburbName, labelPrefix, media, pagePhotos, jobHref, imageSizes, headingId, tone, variant, layout, classes, }: NearbyJobsProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=nearby-jobs.d.ts.map

package/dist/ui-kit/sections/nearby-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearby-jobs.d.ts","sourceRoot":"","sources":["../../../src/ui-kit/sections/nearby-jobs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAA2C,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpI,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,2CAA2C,CAAA;AAGxG,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAA2B,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAE/D,eAAO,MAAM,oBAAoB,2BAA4B,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,kBAAkB,GAAG,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;AACrG,8EAA8E;AAC9E,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;AACjE,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACxB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;CACnD;AACD,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,CAAA;AAEnH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC3C,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;IACjD,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/C,oHAAoH;IACpH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAA;IACtC,6GAA6G;IAC7G,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,GAAG,SAAS,CAAA;IAC3D,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,wBAAwB,CAEjG;AAaD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,KAAK,EACL,UAAU,EACV,OAAO,EACP,UAAU,EACV,SAAiC,EACjC,IAAI,EACJ,OAAgB,EAChB,MAAM,EACN,OAAO,GACR,EAAE,eAAe,kDA6CjB"}

package/dist/ui-kit/sections/nearby-jobs.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { JOB_CARD_LIMIT, jobCardLabel, jobPhotos } from '@brandlab-digital/site-core/jobs';
+import { SECTION_READY } from '@brandlab-digital/site-core/section-order';
+import { LINK_PREFETCH_POLICY } from '../prefetch.js';
+import { Anchor } from '../primitives/links.js';
+import { Media } from '../primitives/media.js';
+import { Section, SectionHeading } from '../primitives/layout.js';
+import { repeatedSlot, slot } from '../skin.js';
+export const NEARBY_JOBS_VARIANTS = ['grid', 'rail'];
+/** The guard for `SectionSequence`: no card means no section (D2). */
+export function nearbyJobsReady({ jobs }) {
+    return jobs.length > 0 ? SECTION_READY : { render: false, reason: 'no-jobs-nearby' };
+}
+function photoOf(job, media, shown) {
+    if (!media)
+        return undefined;
+    const photo = jobPhotos(job, media).find((entry) => !shown.has(entry.id) && !shown.has(entry.src));
+    if (!photo)
+        return undefined;
+    if (photo.provenance !== 'genuine') {
+        throw new Error(`NearbyJobs: "${photo.id}" is ${photo.provenance}; only a genuine photo of the job shows on its card.`);
+    }
+    if (photo.job !== undefined && photo.job !== job.id)
+        throw new Error(`NearbyJobs: "${photo.id}" is a photo of ${photo.job}, not ${job.id}.`);
+    return photo;
+}
+export function NearbyJobs({ title, eyebrow, lead, jobs, pageSuburb, serviceName, suburbName, labelPrefix, media, pagePhotos, jobHref, imageSizes, headingId = 'nearby-jobs-heading', tone, variant = 'grid', layout, classes, }) {
+    if (jobs.length === 0)
+        return null;
+    if (jobs.length > JOB_CARD_LIMIT)
+        throw new Error(`NearbyJobs: ${jobs.length} jobs; a page shows at most ${JOB_CARD_LIMIT} job cards.`);
+    const ids = new Set();
+    for (const { job } of jobs) {
+        if (ids.has(job.id))
+            throw new Error(`NearbyJobs: "${job.id}" is listed twice.`);
+        ids.add(job.id);
+    }
+    const shown = new Set(pagePhotos);
+    const columns = layout?.columns ?? 3;
+    const ratio = layout?.ratio ?? '4:3';
+    const sizes = imageSizes ?? `(min-width: 1024px) ${Math.round(100 / columns)}vw, (min-width: 640px) 50vw, 100vw`;
+    return (_jsxs(Section, { id: "nearby-jobs", labelledBy: headingId, tone: tone, variant: variant, classes: classes, hooks: { 'data-columns': String(columns), 'data-ratio': ratio }, children: [_jsx(SectionHeading, { id: headingId, title: title, eyebrow: eyebrow, lead: lead, classes: classes }), _jsx("ul", { role: "list", ...slot(classes, 'list'), children: jobs.map(({ job }) => {
+                    const label = jobCardLabel(job, { service: serviceName(job.service), suburbName: suburbName(job.suburb), pageSuburb, ...(labelPrefix === undefined ? {} : { prefix: labelPrefix }) });
+                    const href = jobHref?.(job);
+                    const photo = photoOf(job, media, shown);
+                    return (_jsxs("li", { ...repeatedSlot('item'), "data-item": job.id, "data-suburb": job.suburb, children: [_jsxs("div", { ...repeatedSlot('body'), children: [_jsx("h3", { ...repeatedSlot('title'), children: href ? (_jsx(Anchor, { href: href, prefetch: LINK_PREFETCH_POLICY.contentCard, hooks: repeatedSlot('link'), children: label })) : (label) }), _jsx("p", { ...repeatedSlot('outcome'), children: job.outcome })] }), photo ? (_jsx("div", { ...repeatedSlot('media'), children: _jsx(Media, { media: photo, sizes: sizes, layout: { ratio } }) })) : null] }, job.id));
+                }) })] }));
+}
+//# sourceMappingURL=nearby-jobs.js.map

package/dist/ui-kit/sections/nearby-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearby-jobs.js","sourceRoot":"","sources":["../../../src/ui-kit/sections/nearby-jobs.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * `NearbyJobs` (S17, `nearby-jobs`, 3.15.0): proof of real work near this place. Server component.\n *\n * The cards come from the job log (site-core `./jobs`): `nearbyJobs(origin, jobs, { centreOf, service })` ranks the\n * page suburb's own jobs first, then others by real distance within 10 km, at most three. Each card's heading is\n * `jobCardLabel`: \"Tree removal in Castle Hill\" for the page's own suburb, \"Tree removal nearby: Ryde\" for any other\n * (L4); only a job whose month is known says \"Recent\" (or `labelPrefix`) and ends \", {Month Year}\". Distances rank the cards and are never\n * printed (L10). A card shows the job's first photo through `Media`, and only a genuine photo of that job: a stock or AI\n * image never stands for the client's work. With no job close enough the section renders nothing and its guard says\n * so (`no-jobs-nearby`, D2). A card links to the job's project page when the site has one (prefetch on intent).\n * Card photos are always lazy. `pagePhotos` names the photos the page already shows (the hero's): a card then takes the\n * job's next genuine photo, or none, so the hero's priority photo is never repeated below as a lazy copy (3.15.0; on\n * AA's suburb pages the repeat made Next report the hero, the LCP image, as lazy and downloaded it twice).\n */\nimport type { ReactNode } from 'react'\nimport { JOB_CARD_LIMIT, jobCardLabel, jobPhotos, type BrandlabJob, type BrandlabNearbyJob } from '@brandlab-digital/site-core/jobs'\nimport type { BrandlabMediaManifest } from '@brandlab-digital/site-core/media'\nimport { SECTION_READY, type BrandlabSectionReadiness } from '@brandlab-digital/site-core/section-order'\nimport { LINK_PREFETCH_POLICY } from '../prefetch.js'\nimport { Anchor } from '../primitives/links.js'\nimport { Media, type MediaLayout } from '../primitives/media.js'\nimport { Section, SectionHeading, type SectionHeadingSlot, type SectionSlot, type SectionTone } from '../primitives/layout.js'\nimport type { RepeatedSlotOf } from '../repeated-slots.js'\nimport { repeatedSlot, slot, type SkinEntry } from '../skin.js'\n\nexport const NEARBY_JOBS_VARIANTS = ['grid', 'rail'] as const\nexport type NearbyJobsVariant = (typeof NEARBY_JOBS_VARIANTS)[number]\nexport type NearbyJobsSlot = SectionSlot | SectionHeadingSlot | 'list' | RepeatedSlotOf<'nearbyJobs'>\n/** Rendered once per job: styled from the skin stylesheet, never by class. */\nexport type NearbyJobsRepeatedSlot = RepeatedSlotOf<'nearbyJobs'>\nexport interface NearbyJobsLayout {\n  /** `grid`: columns on wide screens. Defaults to 3. */\n  readonly columns?: 2 | 3\n  /** The photo's crop. Defaults to 4:3. */\n  readonly ratio?: NonNullable<MediaLayout['ratio']>\n}\nexport type NearbyJobsSkin = SkinEntry<NearbyJobsSlot, NearbyJobsVariant, NearbyJobsLayout, NearbyJobsRepeatedSlot>\n\nexport interface NearbyJobsProps extends NearbyJobsSkin {\n  /** The H2, for example \"Recent tree work near Castle Hill\". */\n  readonly title: ReactNode\n  readonly eyebrow?: ReactNode\n  readonly lead?: ReactNode\n  /** The ranked cards from `nearbyJobs()`, nearest first; at most three. */\n  readonly jobs: readonly BrandlabNearbyJob[]\n  /** The page's suburb slug: its own jobs read \"in {Suburb}\", every other \"nearby: {Suburb}\". */\n  readonly pageSuburb: string\n  /** The service's name from the site's catalogue, for example `(slug) => services[slug].name`. */\n  readonly serviceName: (service: string) => string\n  /** The suburb's name from the registry. */\n  readonly suburbName: (suburb: string) => string\n  /** Replaces \"Recent\" on a dated card (\"Completed tree removal …\"); `''` for none. An undated card never has one. */\n  readonly labelPrefix?: string\n  /** The media manifest, for the jobs' photos. Left out, the cards show no photo. */\n  readonly media?: BrandlabMediaManifest\n  /** Photos the page already shows, such as the hero's: media ids or `src` paths. A card never repeats one. */\n  readonly pagePhotos?: readonly string[]\n  /** The job's project page, when the site has one. */\n  readonly jobHref?: (job: BrandlabJob) => string | undefined\n  /** The photo `sizes`. Defaults to one column of the grid. */\n  readonly imageSizes?: string\n  /** Defaults to `nearby-jobs-heading`. */\n  readonly headingId?: string\n  /** Set by `SectionSequence`. */\n  readonly tone?: SectionTone\n}\n\n/** The guard for `SectionSequence`: no card means no section (D2). */\nexport function nearbyJobsReady({ jobs }: Pick<NearbyJobsProps, 'jobs'>): BrandlabSectionReadiness {\n  return jobs.length > 0 ? SECTION_READY : { render: false, reason: 'no-jobs-nearby' }\n}\n\nfunction photoOf(job: BrandlabJob, media: BrandlabMediaManifest | undefined, shown: ReadonlySet<string>) {\n  if (!media) return undefined\n  const photo = jobPhotos(job, media).find((entry) => !shown.has(entry.id) && !shown.has(entry.src))\n  if (!photo) return undefined\n  if (photo.provenance !== 'genuine') {\n    throw new Error(`NearbyJobs: \"${photo.id}\" is ${photo.provenance}; only a genuine photo of the job shows on its card.`)\n  }\n  if (photo.job !== undefined && photo.job !== job.id) throw new Error(`NearbyJobs: \"${photo.id}\" is a photo of ${photo.job}, not ${job.id}.`)\n  return photo\n}\n\nexport function NearbyJobs({\n  title,\n  eyebrow,\n  lead,\n  jobs,\n  pageSuburb,\n  serviceName,\n  suburbName,\n  labelPrefix,\n  media,\n  pagePhotos,\n  jobHref,\n  imageSizes,\n  headingId = 'nearby-jobs-heading',\n  tone,\n  variant = 'grid',\n  layout,\n  classes,\n}: NearbyJobsProps) {\n  if (jobs.length === 0) return null\n  if (jobs.length > JOB_CARD_LIMIT) throw new Error(`NearbyJobs: ${jobs.length} jobs; a page shows at most ${JOB_CARD_LIMIT} job cards.`)\n  const ids = new Set<string>()\n  for (const { job } of jobs) {\n    if (ids.has(job.id)) throw new Error(`NearbyJobs: \"${job.id}\" is listed twice.`)\n    ids.add(job.id)\n  }\n  const shown = new Set(pagePhotos)\n  const columns = layout?.columns ?? 3\n  const ratio = layout?.ratio ?? '4:3'\n  const sizes = imageSizes ?? `(min-width: 1024px) ${Math.round(100 / columns)}vw, (min-width: 640px) 50vw, 100vw`\n  return (\n    <Section id=\"nearby-jobs\" labelledBy={headingId} tone={tone} variant={variant} classes={classes} hooks={{ 'data-columns': String(columns), 'data-ratio': ratio }}>\n      <SectionHeading id={headingId} title={title} eyebrow={eyebrow} lead={lead} classes={classes} />\n      <ul role=\"list\" {...slot(classes, 'list')}>\n        {jobs.map(({ job }) => {\n          const label = jobCardLabel(job, { service: serviceName(job.service), suburbName: suburbName(job.suburb), pageSuburb, ...(labelPrefix === undefined ? {} : { prefix: labelPrefix }) })\n          const href = jobHref?.(job)\n          const photo = photoOf(job, media, shown)\n          return (\n            <li key={job.id} {...repeatedSlot('item')} data-item={job.id} data-suburb={job.suburb}>\n              <div {...repeatedSlot('body')}>\n                <h3 {...repeatedSlot('title')}>\n                  {href ? (\n                    <Anchor href={href} prefetch={LINK_PREFETCH_POLICY.contentCard} hooks={repeatedSlot('link')}>\n                      {label}\n                    </Anchor>\n                  ) : (\n                    label\n                  )}\n                </h3>\n                <p {...repeatedSlot('outcome')}>{job.outcome}</p>\n              </div>\n              {photo ? (\n                <div {...repeatedSlot('media')}>\n                  <Media media={photo} sizes={sizes} layout={{ ratio }} />\n                </div>\n              ) : null}\n            </li>\n          )\n        })}\n      </ul>\n    </Section>\n  )\n}\n"]}

package/dist/ui-kit/sections/projects.d.ts

@@ -0,0 +1,79 @@
+/**
+ * `Projects` (`projects`, 3.15.0): completed jobs as cards, each linking its project page (`/projects/{slug}`). Server
+ * component. AA's `ProjectGrid`, re-implemented on the `Card` primitive.
+ *
+ * Locked:
+ * - genuine photos only (v2 §11 imagery rule 4): a stock or AI image on a project card fails the build, and a project
+ *   without a photo shows as a card without one;
+ * - at most 8 cards (K11; the in-content intent-prefetch limit); each card is one link, its title, which prefetches on
+ *   intent. The hub link after the list never prefetches;
+ * - each card links its own project page, a child of the site's projects hub (`/projects/{slug}`, `/our-work/{slug}`);
+ * - no default visible copy: the heading, titles, summaries and the suburb-and-month line all come from the site.
+ *
+ * `projectCardFromJob` builds a card from a site-core job log row (`./jobs`): the job's first genuine photo and its
+ * outcome line; the title, the link and the meta line stay the site's.
+ */
+import type { ReactNode } from 'react';
+import type { BrandlabJob } from '@brandlab-digital/site-core/jobs';
+import type { BrandlabMediaManifest, BrandlabMediaRatio } from '@brandlab-digital/site-core/media';
+import { type BrandlabSectionReadiness } from '@brandlab-digital/site-core/section-order';
+import { type SectionHeadingSlot, type SectionSlot, type SectionTone } from '../primitives/layout.js';
+import { type UiMedia } from '../primitives/media-frame.js';
+import { type SkinEntry } from '../skin.js';
+import type { UiLink } from '../types.js';
+/** The cards' parts are the `Card` primitive's (`[data-bl="card"]`), styled from the skin stylesheet. */
+export type ProjectsSlot = SectionSlot | SectionHeadingSlot | 'list' | 'more';
+export interface ProjectsLayout {
+    /** Columns on wide screens. Defaults to 3. */
+    readonly columns?: 2 | 3 | 4;
+    /** The photos' crop. Defaults to 4:3. */
+    readonly ratio?: BrandlabMediaRatio;
+}
+export type ProjectsSkin = SkinEntry<ProjectsSlot, never, ProjectsLayout>;
+/** The most project cards a section shows (K11; the in-content intent-prefetch limit). */
+export declare const PROJECTS_CARD_LIMIT: 8;
+/** One completed job as a card. */
+export interface ProjectCardData {
+    /** A stable slug (the job id), rendered as `data-item`. */
+    readonly id: string;
+    /** The card's H3 and its link's whole name, for example "Gum removal over a pool, Epping". */
+    readonly title: string;
+    /** The project page, for example `/projects/epping-gum-removal`. From the site's data. */
+    readonly href: string;
+    /** What was done, in a line. */
+    readonly summary?: ReactNode;
+    /** A short line under the summary, for example the suburb and month. */
+    readonly meta?: ReactNode;
+    /** A genuine photo of this job from the media manifest. */
+    readonly image?: UiMedia;
+}
+/**
+ * A card from the job log: the job's first photo (`jobPhotos`, genuine ones only) and its outcome as the summary. The
+ * site gives the title, the project page and the meta line in its own words.
+ */
+export declare function projectCardFromJob(job: BrandlabJob, options: {
+    readonly media: BrandlabMediaManifest;
+    readonly title: string;
+    readonly href: string;
+    readonly meta?: ReactNode;
+}): ProjectCardData;
+export interface ProjectsProps extends ProjectsSkin {
+    /** The H2, for example "Recent tree removal jobs". */
+    readonly title: ReactNode;
+    readonly eyebrow?: ReactNode;
+    readonly lead?: ReactNode;
+    /** Up to 8 projects, newest or nearest first. */
+    readonly projects: readonly ProjectCardData[];
+    /** A link after the cards, for example the projects hub. Never prefetched. */
+    readonly more?: UiLink;
+    /** The photos' `sizes`: a fluid `vw` string, or a number for a fixed CSS width. Defaults to one grid column. */
+    readonly imageSizes?: string | number;
+    /** Defaults to `projects-heading`. */
+    readonly headingId?: string;
+    /** Set by `SectionSequence`. */
+    readonly tone?: SectionTone;
+}
+/** The section's guard for `SectionSequence`: skipped when no project is recorded. */
+export declare function projectsReady({ projects }: Pick<ProjectsProps, 'projects'>): BrandlabSectionReadiness;
+export declare function Projects({ title, eyebrow, lead, projects, more, imageSizes, headingId, tone, layout, classes, }: ProjectsProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=projects.d.ts.map

package/dist/ui-kit/sections/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/ui-kit/sections/projects.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAEnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAClG,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,2CAA2C,CAAA;AAExG,OAAO,EAA2B,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE9H,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEvE,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,yGAAyG;AACzG,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAA;AAC7E,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAA;CACpC;AACD,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,cAAc,CAAC,CAAA;AAEzE,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,GAAmC,CAAA;AAEnE,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAC3H,eAAe,CAUjB;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,gHAAgH;IAChH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,wBAAwB,CAErG;AA2BD,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,SAA8B,EAC9B,IAAI,EACJ,MAAM,EACN,OAAO,GACR,EAAE,aAAa,kDAiCf"}

package/dist/ui-kit/sections/projects.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jobPhotos } from '@brandlab-digital/site-core/jobs';
+import { SECTION_READY } from '@brandlab-digital/site-core/section-order';
+import { Card } from '../primitives/card.js';
+import { Section, SectionHeading } from '../primitives/layout.js';
+import { Anchor } from '../primitives/links.js';
+import { MediaFrame } from '../primitives/media-frame.js';
+import { LINK_PREFETCH_LIMITS, LINK_PREFETCH_POLICY } from '../prefetch.js';
+import { slot } from '../skin.js';
+import { assertGenuineWork, frameSizing, gridImageSizes, isInternalPath } from './work-photos.js';
+/** The most project cards a section shows (K11; the in-content intent-prefetch limit). */
+export const PROJECTS_CARD_LIMIT = LINK_PREFETCH_LIMITS.contentCard;
+/**
+ * A card from the job log: the job's first photo (`jobPhotos`, genuine ones only) and its outcome as the summary. The
+ * site gives the title, the project page and the meta line in its own words.
+ */
+export function projectCardFromJob(job, options) {
+    const photo = jobPhotos(job, options.media).find((entry) => entry.provenance === 'genuine');
+    return {
+        id: job.id,
+        title: options.title,
+        href: options.href,
+        summary: job.outcome,
+        ...(options.meta !== undefined ? { meta: options.meta } : {}),
+        ...(photo ? { image: photo } : {}),
+    };
+}
+/** The section's guard for `SectionSequence`: skipped when no project is recorded. */
+export function projectsReady({ projects }) {
+    return projects.length > 0 ? SECTION_READY : { render: false, reason: 'no-projects' };
+}
+function assertProjects(projects) {
+    if (projects.length > PROJECTS_CARD_LIMIT) {
+        throw new Error(`Projects: ${projects.length} projects; a section shows at most ${PROJECTS_CARD_LIMIT} (K11). Link the projects hub for the rest.`);
+    }
+    const ids = new Set();
+    const hrefs = new Set();
+    const images = new Map();
+    for (const project of projects) {
+        if (!project.id || ids.has(project.id))
+            throw new Error(`Projects: every project needs its own id ("${project.id}" is empty or repeated).`);
+        ids.add(project.id);
+        if (!project.title?.trim())
+            throw new Error(`Projects: the project "${project.id}" has no title.`);
+        if (!isInternalPath(project.href) || project.href.split('/').filter(Boolean).length < 2) {
+            throw new Error(`Projects: "${project.id}" links ${project.href}; a project card links its own page under the projects hub, such as /projects/${project.id}.`);
+        }
+        if (hrefs.has(project.href))
+            throw new Error(`Projects: two projects link to ${project.href}.`);
+        hrefs.add(project.href);
+        if (project.image) {
+            assertGenuineWork('Projects', project.image, `the photo of "${project.id}"`);
+            const other = images.get(project.image.src);
+            if (other)
+                throw new Error(`Projects: "${project.id}" and "${other}" use the same photo (${project.image.src}).`);
+            images.set(project.image.src, project.id);
+        }
+    }
+}
+export function Projects({ title, eyebrow, lead, projects, more, imageSizes, headingId = 'projects-heading', tone, layout, classes, }) {
+    if (!projectsReady({ projects }).render)
+        return null;
+    assertProjects(projects);
+    const columns = layout?.columns ?? 3;
+    const ratio = layout?.ratio ?? '4:3';
+    const sizing = frameSizing(imageSizes ?? gridImageSizes(columns));
+    return (_jsxs(Section, { id: "projects", labelledBy: headingId, tone: tone, classes: classes, hooks: { 'data-columns': String(columns), 'data-ratio': ratio }, children: [_jsx(SectionHeading, { id: headingId, title: title, eyebrow: eyebrow, lead: lead, classes: classes }), _jsx("ul", { role: "list", ...slot(classes, 'list'), children: projects.map((project) => (_jsx(Card, { as: "li", title: project.title, href: project.href, prefetch: LINK_PREFETCH_POLICY.contentCard, media: project.image ? _jsx(MediaFrame, { media: project.image, ratio: ratio, ...sizing }) : undefined, meta: project.meta, children: project.summary }, project.id))) }), more ? (_jsx("p", { ...slot(classes, 'more'), children: _jsx(Anchor, { href: more.href, prefetch: false, hooks: {}, children: more.label }) })) : null] }));
+}
+//# sourceMappingURL=projects.js.map

package/dist/ui-kit/sections/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../../src/ui-kit/sections/projects.tsx"],"names":[],"mappings":";AAiBA,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAE5D,OAAO,EAAE,aAAa,EAAiC,MAAM,2CAA2C,CAAA;AACxG,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,cAAc,EAA+D,MAAM,yBAAyB,CAAA;AAC9H,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAgB,MAAM,8BAA8B,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,IAAI,EAAkB,MAAM,YAAY,CAAA;AAEjD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAYjG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,WAAW,CAAA;AAkBnE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAgB,EAChB,OAA4H;IAE5H,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAA;IAC3F,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnC,CAAA;AACH,CAAC;AAmBD,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAmC;IACzE,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;AACvF,CAAC;AAED,SAAS,cAAc,CAAC,QAAoC;IAC1D,IAAI,QAAQ,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,sCAAsC,mBAAmB,6CAA6C,CAAC,CAAA;IACrJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,OAAO,CAAC,EAAE,0BAA0B,CAAC,CAAA;QAC3I,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACnB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAA;QAClG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,KAAK,CAAC,cAAc,OAAO,CAAC,EAAE,WAAW,OAAO,CAAC,IAAI,iFAAiF,OAAO,CAAC,EAAE,GAAG,CAAC,CAAA;QAChK,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAA;QAC/F,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACvB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,iBAAiB,OAAO,CAAC,EAAE,GAAG,CAAC,CAAA;YAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC3C,IAAI,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,OAAO,CAAC,EAAE,UAAU,KAAK,yBAAyB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;YACjH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,SAAS,GAAG,kBAAkB,EAC9B,IAAI,EACJ,MAAM,EACN,OAAO,GACO;IACd,IAAI,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACpD,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,CAAC,CAAA;IACpC,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,KAAK,CAAA;IACpC,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;IACjE,OAAO,CACL,MAAC,OAAO,IAAC,EAAE,EAAC,UAAU,EAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,aACzI,KAAC,cAAc,IAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAI,EAC/F,aAAI,IAAI,EAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,YACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACzB,KAAC,IAAI,IAEH,EAAE,EAAC,IAAI,EACP,KAAK,EAAE,OAAO,CAAC,KAAK,EACpB,IAAI,EAAE,OAAO,CAAC,IAAI,EAClB,QAAQ,EAAE,oBAAoB,CAAC,WAAW,EAC1C,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAC,UAAU,IAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,KAAM,MAAM,GAAI,CAAC,CAAC,CAAC,SAAS,EACjG,IAAI,EAAE,OAAO,CAAC,IAAI,YAEjB,OAAO,CAAC,OAAO,IARX,OAAO,CAAC,EAAE,CASV,CACR,CAAC,GACC,EACJ,IAAI,CAAC,CAAC,CAAC,CACN,eAAO,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,YAC1B,KAAC,MAAM,IAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,YAChD,IAAI,CAAC,KAAK,GACJ,GACP,CACL,CAAC,CAAC,CAAC,IAAI,IACA,CACX,CAAA;AACH,CAAC","sourcesContent":["/**\n * `Projects` (`projects`, 3.15.0): completed jobs as cards, each linking its project page (`/projects/{slug}`). Server\n * component. AA's `ProjectGrid`, re-implemented on the `Card` primitive.\n *\n * Locked:\n * - genuine photos only (v2 §11 imagery rule 4): a stock or AI image on a project card fails the build, and a project\n *   without a photo shows as a card without one;\n * - at most 8 cards (K11; the in-content intent-prefetch limit); each card is one link, its title, which prefetches on\n *   intent. The hub link after the list never prefetches;\n * - each card links its own project page, a child of the site's projects hub (`/projects/{slug}`, `/our-work/{slug}`);\n * - no default visible copy: the heading, titles, summaries and the suburb-and-month line all come from the site.\n *\n * `projectCardFromJob` builds a card from a site-core job log row (`./jobs`): the job's first genuine photo and its\n * outcome line; the title, the link and the meta line stay the site's.\n */\nimport type { ReactNode } from 'react'\nimport type { BrandlabJob } from '@brandlab-digital/site-core/jobs'\nimport { jobPhotos } from '@brandlab-digital/site-core/jobs'\nimport type { BrandlabMediaManifest, BrandlabMediaRatio } from '@brandlab-digital/site-core/media'\nimport { SECTION_READY, type BrandlabSectionReadiness } from '@brandlab-digital/site-core/section-order'\nimport { Card } from '../primitives/card.js'\nimport { Section, SectionHeading, type SectionHeadingSlot, type SectionSlot, type SectionTone } from '../primitives/layout.js'\nimport { Anchor } from '../primitives/links.js'\nimport { MediaFrame, type UiMedia } from '../primitives/media-frame.js'\nimport { LINK_PREFETCH_LIMITS, LINK_PREFETCH_POLICY } from '../prefetch.js'\nimport { slot, type SkinEntry } from '../skin.js'\nimport type { UiLink } from '../types.js'\nimport { assertGenuineWork, frameSizing, gridImageSizes, isInternalPath } from './work-photos.js'\n\n/** The cards' parts are the `Card` primitive's (`[data-bl=\"card\"]`), styled from the skin stylesheet. */\nexport type ProjectsSlot = SectionSlot | SectionHeadingSlot | 'list' | 'more'\nexport interface ProjectsLayout {\n  /** Columns on wide screens. Defaults to 3. */\n  readonly columns?: 2 | 3 | 4\n  /** The photos' crop. Defaults to 4:3. */\n  readonly ratio?: BrandlabMediaRatio\n}\nexport type ProjectsSkin = SkinEntry<ProjectsSlot, never, ProjectsLayout>\n\n/** The most project cards a section shows (K11; the in-content intent-prefetch limit). */\nexport const PROJECTS_CARD_LIMIT = LINK_PREFETCH_LIMITS.contentCard\n\n/** One completed job as a card. */\nexport interface ProjectCardData {\n  /** A stable slug (the job id), rendered as `data-item`. */\n  readonly id: string\n  /** The card's H3 and its link's whole name, for example \"Gum removal over a pool, Epping\". */\n  readonly title: string\n  /** The project page, for example `/projects/epping-gum-removal`. From the site's data. */\n  readonly href: string\n  /** What was done, in a line. */\n  readonly summary?: ReactNode\n  /** A short line under the summary, for example the suburb and month. */\n  readonly meta?: ReactNode\n  /** A genuine photo of this job from the media manifest. */\n  readonly image?: UiMedia\n}\n\n/**\n * A card from the job log: the job's first photo (`jobPhotos`, genuine ones only) and its outcome as the summary. The\n * site gives the title, the project page and the meta line in its own words.\n */\nexport function projectCardFromJob(\n  job: BrandlabJob,\n  options: { readonly media: BrandlabMediaManifest; readonly title: string; readonly href: string; readonly meta?: ReactNode },\n): ProjectCardData {\n  const photo = jobPhotos(job, options.media).find((entry) => entry.provenance === 'genuine')\n  return {\n    id: job.id,\n    title: options.title,\n    href: options.href,\n    summary: job.outcome,\n    ...(options.meta !== undefined ? { meta: options.meta } : {}),\n    ...(photo ? { image: photo } : {}),\n  }\n}\n\nexport interface ProjectsProps extends ProjectsSkin {\n  /** The H2, for example \"Recent tree removal jobs\". */\n  readonly title: ReactNode\n  readonly eyebrow?: ReactNode\n  readonly lead?: ReactNode\n  /** Up to 8 projects, newest or nearest first. */\n  readonly projects: readonly ProjectCardData[]\n  /** A link after the cards, for example the projects hub. Never prefetched. */\n  readonly more?: UiLink\n  /** The photos' `sizes`: a fluid `vw` string, or a number for a fixed CSS width. Defaults to one grid column. */\n  readonly imageSizes?: string | number\n  /** Defaults to `projects-heading`. */\n  readonly headingId?: string\n  /** Set by `SectionSequence`. */\n  readonly tone?: SectionTone\n}\n\n/** The section's guard for `SectionSequence`: skipped when no project is recorded. */\nexport function projectsReady({ projects }: Pick<ProjectsProps, 'projects'>): BrandlabSectionReadiness {\n  return projects.length > 0 ? SECTION_READY : { render: false, reason: 'no-projects' }\n}\n\nfunction assertProjects(projects: readonly ProjectCardData[]): void {\n  if (projects.length > PROJECTS_CARD_LIMIT) {\n    throw new Error(`Projects: ${projects.length} projects; a section shows at most ${PROJECTS_CARD_LIMIT} (K11). Link the projects hub for the rest.`)\n  }\n  const ids = new Set<string>()\n  const hrefs = new Set<string>()\n  const images = new Map<string, string>()\n  for (const project of projects) {\n    if (!project.id || ids.has(project.id)) throw new Error(`Projects: every project needs its own id (\"${project.id}\" is empty or repeated).`)\n    ids.add(project.id)\n    if (!project.title?.trim()) throw new Error(`Projects: the project \"${project.id}\" has no title.`)\n    if (!isInternalPath(project.href) || project.href.split('/').filter(Boolean).length < 2) {\n      throw new Error(`Projects: \"${project.id}\" links ${project.href}; a project card links its own page under the projects hub, such as /projects/${project.id}.`)\n    }\n    if (hrefs.has(project.href)) throw new Error(`Projects: two projects link to ${project.href}.`)\n    hrefs.add(project.href)\n    if (project.image) {\n      assertGenuineWork('Projects', project.image, `the photo of \"${project.id}\"`)\n      const other = images.get(project.image.src)\n      if (other) throw new Error(`Projects: \"${project.id}\" and \"${other}\" use the same photo (${project.image.src}).`)\n      images.set(project.image.src, project.id)\n    }\n  }\n}\n\nexport function Projects({\n  title,\n  eyebrow,\n  lead,\n  projects,\n  more,\n  imageSizes,\n  headingId = 'projects-heading',\n  tone,\n  layout,\n  classes,\n}: ProjectsProps) {\n  if (!projectsReady({ projects }).render) return null\n  assertProjects(projects)\n  const columns = layout?.columns ?? 3\n  const ratio = layout?.ratio ?? '4:3'\n  const sizing = frameSizing(imageSizes ?? gridImageSizes(columns))\n  return (\n    <Section id=\"projects\" labelledBy={headingId} tone={tone} classes={classes} hooks={{ 'data-columns': String(columns), 'data-ratio': ratio }}>\n      <SectionHeading id={headingId} title={title} eyebrow={eyebrow} lead={lead} classes={classes} />\n      <ul role=\"list\" {...slot(classes, 'list')}>\n        {projects.map((project) => (\n          <Card\n            key={project.id}\n            as=\"li\"\n            title={project.title}\n            href={project.href}\n            prefetch={LINK_PREFETCH_POLICY.contentCard}\n            media={project.image ? <MediaFrame media={project.image} ratio={ratio} {...sizing} /> : undefined}\n            meta={project.meta}\n          >\n            {project.summary}\n          </Card>\n        ))}\n      </ul>\n      {more ? (\n        <p {...slot(classes, 'more')}>\n          <Anchor href={more.href} prefetch={false} hooks={{}}>\n            {more.label}\n          </Anchor>\n        </p>\n      ) : null}\n    </Section>\n  )\n}\n"]}

package/dist/ui-kit/sections/quote-checklist.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `QuoteChecklist` (`data-bl="quote-checklist"`, 3.15.0): what to send for a fast, fair quote in this trade (photos of
+ * the tree and its access, the suburb, what's underneath it…), as a real list of ticks, then the button to the quote
+ * form. Server component built on `TickList`. It is a block, not a sequenced section of the matrix: a site places it
+ * inside its service detail, beside the contact form or as its own band (`headingLevel`).
+ *
+ * Locked: the list comes before the action; the action is the site's quote button (`lead_cta_click` placement
+ * `section`, id `quote-checklist`) to its quote form. No default visible copy: the heading, every item and the button
+ * label are the site's (spec: checklist content lives in each site's copy file, so same-trade sites never repeat each
+ * other). At most 8 items, so the list stays a checklist.
+ */
+import type { ReactNode } from 'react';
+import { type TickItem } from '../primitives/lists.js';
+import type { ButtonVariant } from '../primitives/links.js';
+import { type SkinEntry } from '../skin.js';
+export type QuoteChecklistSlot = 'root' | 'heading' | 'lead' | 'list' | 'action' | 'quote';
+export interface QuoteChecklistLayout {
+    /** The list's columns from the phone breakpoint up. Defaults to 1. */
+    readonly columns?: 1 | 2;
+    /** The quote button's variant. Defaults to `primary`. */
+    readonly quoteVariant?: ButtonVariant;
+}
+export type QuoteChecklistSkin = SkinEntry<QuoteChecklistSlot, never, QuoteChecklistLayout>;
+/** The most items a checklist holds. */
+export declare const QUOTE_CHECKLIST_MAX = 8;
+export interface QuoteChecklistProps extends QuoteChecklistSkin {
+    /** The heading, for example "What to send for a fast quote". */
+    readonly title: ReactNode;
+    readonly lead?: ReactNode;
+    /** What to send, in the site's words: 2 to 8 items. */
+    readonly items: readonly TickItem[];
+    /** The site's recorded quote label and its quote form, for example `{ label: 'Get a free quote', href: '#quote-hero' }`. */
+    readonly quote: {
+        readonly label: string;
+        readonly href: string;
+    };
+    /** 2 (the default) makes the block its own `<section>` labelled by an H2; 3 sits it inside a section's outline. */
+    readonly headingLevel?: 2 | 3;
+    /** Defaults to `quote-checklist-heading`. */
+    readonly headingId?: string;
+}
+export declare function QuoteChecklist({ title, lead, items, quote, headingLevel, headingId, layout, classes }: QuoteChecklistProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=quote-checklist.d.ts.map

package/dist/ui-kit/sections/quote-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-checklist.d.ts","sourceRoot":"","sources":["../../../src/ui-kit/sections/quote-checklist.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAC1F,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACxB,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAA;CACtC;AACD,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAA;AAE3F,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,4HAA4H;IAC5H,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACjE,mHAAmH;IACnH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAgB,EAAE,SAAqC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,mBAAmB,kDAoB1J"}

package/dist/ui-kit/sections/quote-checklist.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TickList } from '../primitives/lists.js';
+import { QuoteButton } from '../primitives/quote-button.js';
+import { slot } from '../skin.js';
+/** The most items a checklist holds. */
+export const QUOTE_CHECKLIST_MAX = 8;
+export function QuoteChecklist({ title, lead, items, quote, headingLevel = 2, headingId = 'quote-checklist-heading', layout, classes }) {
+    if (items.length === 0)
+        return null;
+    if (items.length < 2 || items.length > QUOTE_CHECKLIST_MAX) {
+        throw new Error(`QuoteChecklist: ${items.length} items; a checklist holds 2 to ${QUOTE_CHECKLIST_MAX}.`);
+    }
+    if (!quote?.label?.trim() || !quote.href?.trim())
+        throw new Error('QuoteChecklist: the quote button needs the site\'s label and its quote form.');
+    const Root = headingLevel === 2 ? 'section' : 'div';
+    const Heading = `h${headingLevel}`;
+    return (_jsxs(Root, { "data-bl": "quote-checklist", "aria-labelledby": headingLevel === 2 ? headingId : undefined, className: classes?.root, children: [_jsx(Heading, { id: headingId, ...slot(classes, 'heading'), children: title }), lead ? _jsx("p", { ...slot(classes, 'lead'), children: lead }) : null, _jsx(TickList, { items: items, layout: { columns: layout?.columns ?? 1 }, classes: { root: classes?.list } }), _jsx("p", { ...slot(classes, 'action'), children: _jsx(QuoteButton, { label: quote.label, href: quote.href, placement: "section", ctaId: "quote-checklist", variant: layout?.quoteVariant ?? 'primary', classes: { root: classes?.quote } }) })] }));
+}
+//# sourceMappingURL=quote-checklist.js.map

package/dist/ui-kit/sections/quote-checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-checklist.js","sourceRoot":"","sources":["../../../src/ui-kit/sections/quote-checklist.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,QAAQ,EAAiB,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAE3D,OAAO,EAAE,IAAI,EAAkB,MAAM,YAAY,CAAA;AAWjD,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAgBpC,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,EAAE,SAAS,GAAG,yBAAyB,EAAE,MAAM,EAAE,OAAO,EAAuB;IACzJ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,MAAM,kCAAkC,mBAAmB,GAAG,CAAC,CAAA;IAC1G,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAA;IACjJ,MAAM,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;IACnD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAW,CAAA;IAC3C,OAAO,CACL,MAAC,IAAI,eAAS,iBAAiB,qBAAkB,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,aACnH,KAAC,OAAO,IAAC,EAAE,EAAE,SAAS,KAAM,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,YACjD,KAAK,GACE,EACT,IAAI,CAAC,CAAC,CAAC,eAAO,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,YAAG,IAAI,GAAK,CAAC,CAAC,CAAC,IAAI,EACvD,KAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAI,EACvG,eAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,YAC5B,KAAC,WAAW,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAC,SAAS,EAAC,KAAK,EAAC,iBAAiB,EAAC,OAAO,EAAE,MAAM,EAAE,YAAY,IAAI,SAAS,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAI,GAC9K,IACC,CACR,CAAA;AACH,CAAC","sourcesContent":["/**\n * `QuoteChecklist` (`data-bl=\"quote-checklist\"`, 3.15.0): what to send for a fast, fair quote in this trade (photos of\n * the tree and its access, the suburb, what's underneath it…), as a real list of ticks, then the button to the quote\n * form. Server component built on `TickList`. It is a block, not a sequenced section of the matrix: a site places it\n * inside its service detail, beside the contact form or as its own band (`headingLevel`).\n *\n * Locked: the list comes before the action; the action is the site's quote button (`lead_cta_click` placement\n * `section`, id `quote-checklist`) to its quote form. No default visible copy: the heading, every item and the button\n * label are the site's (spec: checklist content lives in each site's copy file, so same-trade sites never repeat each\n * other). At most 8 items, so the list stays a checklist.\n */\nimport type { ReactNode } from 'react'\nimport { TickList, type TickItem } from '../primitives/lists.js'\nimport { QuoteButton } from '../primitives/quote-button.js'\nimport type { ButtonVariant } from '../primitives/links.js'\nimport { slot, type SkinEntry } from '../skin.js'\n\nexport type QuoteChecklistSlot = 'root' | 'heading' | 'lead' | 'list' | 'action' | 'quote'\nexport interface QuoteChecklistLayout {\n  /** The list's columns from the phone breakpoint up. Defaults to 1. */\n  readonly columns?: 1 | 2\n  /** The quote button's variant. Defaults to `primary`. */\n  readonly quoteVariant?: ButtonVariant\n}\nexport type QuoteChecklistSkin = SkinEntry<QuoteChecklistSlot, never, QuoteChecklistLayout>\n\n/** The most items a checklist holds. */\nexport const QUOTE_CHECKLIST_MAX = 8\n\nexport interface QuoteChecklistProps extends QuoteChecklistSkin {\n  /** The heading, for example \"What to send for a fast quote\". */\n  readonly title: ReactNode\n  readonly lead?: ReactNode\n  /** What to send, in the site's words: 2 to 8 items. */\n  readonly items: readonly TickItem[]\n  /** The site's recorded quote label and its quote form, for example `{ label: 'Get a free quote', href: '#quote-hero' }`. */\n  readonly quote: { readonly label: string; readonly href: string }\n  /** 2 (the default) makes the block its own `<section>` labelled by an H2; 3 sits it inside a section's outline. */\n  readonly headingLevel?: 2 | 3\n  /** Defaults to `quote-checklist-heading`. */\n  readonly headingId?: string\n}\n\nexport function QuoteChecklist({ title, lead, items, quote, headingLevel = 2, headingId = 'quote-checklist-heading', layout, classes }: QuoteChecklistProps) {\n  if (items.length === 0) return null\n  if (items.length < 2 || items.length > QUOTE_CHECKLIST_MAX) {\n    throw new Error(`QuoteChecklist: ${items.length} items; a checklist holds 2 to ${QUOTE_CHECKLIST_MAX}.`)\n  }\n  if (!quote?.label?.trim() || !quote.href?.trim()) throw new Error('QuoteChecklist: the quote button needs the site\\'s label and its quote form.')\n  const Root = headingLevel === 2 ? 'section' : 'div'\n  const Heading = `h${headingLevel}` as const\n  return (\n    <Root data-bl=\"quote-checklist\" aria-labelledby={headingLevel === 2 ? headingId : undefined} className={classes?.root}>\n      <Heading id={headingId} {...slot(classes, 'heading')}>\n        {title}\n      </Heading>\n      {lead ? <p {...slot(classes, 'lead')}>{lead}</p> : null}\n      <TickList items={items} layout={{ columns: layout?.columns ?? 1 }} classes={{ root: classes?.list }} />\n      <p {...slot(classes, 'action')}>\n        <QuoteButton label={quote.label} href={quote.href} placement=\"section\" ctaId=\"quote-checklist\" variant={layout?.quoteVariant ?? 'primary'} classes={{ root: classes?.quote }} />\n      </p>\n    </Root>\n  )\n}\n"]}

package/dist/ui-kit/sections/related-services.d.ts

@@ -0,0 +1,41 @@
+import type { ReactNode } from 'react';
+import { type BrandlabSectionReadiness } from '@brandlab-digital/site-core/section-order';
+import { type SectionHeadingSlot, type SectionSlot, type SectionTone } from '../primitives/layout.js';
+import type { RepeatedSlotOf } from '../repeated-slots.js';
+import { type SkinEntry } from '../skin.js';
+import type { UiLink } from '../types.js';
+import { type ServiceCardData, type ServicesGridLayout } from './services-grid.js';
+/** The most services the section lists (K11; the in-content intent-prefetch limit). */
+export declare const RELATED_SERVICES_LIMIT: 8;
+export declare const RELATED_SERVICES_VARIANTS: readonly ["list", "cards"];
+export type RelatedServicesVariant = (typeof RELATED_SERVICES_VARIANTS)[number];
+export type RelatedServicesSlot = SectionSlot | SectionHeadingSlot | 'list' | 'more' | RepeatedSlotOf<'relatedServices'>;
+/** `cards`: rendered once per service, styled from the skin stylesheet, never by class. */
+export type RelatedServicesRepeatedSlot = RepeatedSlotOf<'relatedServices'>;
+export interface RelatedServicesLayout {
+    /** Columns on wide screens: `list` 1 to 4 (default 3), `cards` 2 to 4 (default 3). */
+    readonly columns?: 1 | 2 | 3 | 4;
+    /** `cards`: the photo's crop. Defaults to 4:3. */
+    readonly ratio?: ServicesGridLayout['ratio'];
+}
+export type RelatedServicesSkin = SkinEntry<RelatedServicesSlot, RelatedServicesVariant, RelatedServicesLayout, RelatedServicesRepeatedSlot>;
+export interface RelatedServicesProps extends RelatedServicesSkin {
+    /** The H2, for example "Other services in Castle Hill". */
+    readonly title: ReactNode;
+    readonly eyebrow?: ReactNode;
+    readonly lead?: ReactNode;
+    /** The other services, in money order; `cards` uses their summaries and photos. */
+    readonly services: readonly ServiceCardData[];
+    /** A link after the list, for example the services hub. Never prefetched. */
+    readonly more?: UiLink;
+    /** `cards`: the photo `sizes`. */
+    readonly imageSizes?: string;
+    /** Defaults to `related-services-heading`. */
+    readonly headingId?: string;
+    /** Set by `SectionSequence`. */
+    readonly tone?: SectionTone;
+}
+/** The guard for `SectionSequence`. */
+export declare function relatedServicesReady({ services }: Pick<RelatedServicesProps, 'services'>): BrandlabSectionReadiness;
+export declare function RelatedServices({ title, eyebrow, lead, services, more, imageSizes, headingId, tone, variant, layout, classes, }: RelatedServicesProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=related-services.d.ts.map

package/dist/ui-kit/sections/related-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-services.d.ts","sourceRoot":"","sources":["../../../src/ui-kit/sections/related-services.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,2CAA2C,CAAA;AAGxG,OAAO,EAA2B,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAkC,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAElH,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,GAAmC,CAAA;AAEtE,eAAO,MAAM,yBAAyB,4BAA6B,CAAA;AACnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAC/E,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAA;AACxH,2FAA2F;AAC3F,MAAM,MAAM,2BAA2B,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAA;AAC3E,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;CAC7C;AACD,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,2BAA2B,CAAC,CAAA;AAE5I,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IAC7C,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,kCAAkC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,GAAG,wBAAwB,CAEnH;AAiBD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,SAAsC,EACtC,IAAI,EACJ,OAAgB,EAChB,MAAM,EACN,OAAO,GACR,EAAE,oBAAoB,kDA+CtB"}

package/dist/ui-kit/sections/related-services.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `RelatedServices` (S28, `related-services`, 3.15.0): the other services in this place ("Other services in Castle
+ * Hill") or a service page's siblings. Server component.
+ *
+ * Each entry links to its service-in-suburb page where one exists, or to its section on the suburb page
+ * (`#tree-pruning`); the href always comes from the site's data. At most 8 (K11). Variants:
+ * - `list` (the default, lean): a `LinkList` of plain `<li><a>` entries, nothing prefetched
+ *   (`data-bl-links="other-services"`, the `otherServicesInSuburb` role in `LINK_PREFETCH_POLICY`);
+ * - `cards`: `ServiceCard`s with a summary and photo, each card's one link prefetching on intent (`contentCard`).
+ */
+import Link from 'next/link';
+import { SECTION_READY } from '@brandlab-digital/site-core/section-order';
+import { LINK_PREFETCH_LIMITS, LINK_PREFETCH_POLICY } from '../prefetch.js';
+import { LinkList } from '../primitives/lists.js';
+import { Section, SectionHeading } from '../primitives/layout.js';
+import { slot } from '../skin.js';
+import { ServiceCard, defaultImageSizes } from './services-grid.js';
+/** The most services the section lists (K11; the in-content intent-prefetch limit). */
+export const RELATED_SERVICES_LIMIT = LINK_PREFETCH_LIMITS.contentCard;
+export const RELATED_SERVICES_VARIANTS = ['list', 'cards'];
+/** The guard for `SectionSequence`. */
+export function relatedServicesReady({ services }) {
+    return services.length > 0 ? SECTION_READY : { render: false, reason: 'no-other-services' };
+}
+function assertServices(services) {
+    if (services.length > RELATED_SERVICES_LIMIT) {
+        throw new Error(`RelatedServices: ${services.length} services; the section lists at most ${RELATED_SERVICES_LIMIT} (K11). Link the services hub for the rest.`);
+    }
+    const ids = new Set();
+    const hrefs = new Set();
+    for (const service of services) {
+        if (!service.id || ids.has(service.id))
+            throw new Error(`RelatedServices: every service needs its own id ("${service.id}" is empty or repeated).`);
+        ids.add(service.id);
+        if (!service.title?.trim() || !service.href?.trim())
+            throw new Error(`RelatedServices: "${service.id}" needs a title and a link.`);
+        if (hrefs.has(service.href))
+            throw new Error(`RelatedServices: two services link to ${service.href}.`);
+        hrefs.add(service.href);
+    }
+}
+export function RelatedServices({ title, eyebrow, lead, services, more, imageSizes, headingId = 'related-services-heading', tone, variant = 'list', layout, classes, }) {
+    if (services.length === 0)
+        return null;
+    assertServices(services);
+    const columns = layout?.columns ?? 3;
+    const ratio = layout?.ratio ?? '4:3';
+    const cardColumns = (columns < 2 ? 2 : columns);
+    return (_jsxs(Section, { id: "related-services", labelledBy: headingId, tone: tone, variant: variant, classes: classes, hooks: variant === 'cards' ? { 'data-columns': String(cardColumns), 'data-ratio': ratio } : undefined, children: [_jsx(SectionHeading, { id: headingId, title: title, eyebrow: eyebrow, lead: lead, classes: classes }), variant === 'cards' ? (_jsx("ul", { role: "list", ...slot(classes, 'list'), children: services.map((service) => (_jsx(ServiceCard, { service: service, variant: "cards", imageSizes: imageSizes ?? defaultImageSizes('cards', cardColumns), ratio: ratio, prefetch: LINK_PREFETCH_POLICY.contentCard }, service.id))) })) : (_jsx(LinkList, { links: services.map((service) => ({ label: service.title, href: service.href })), kind: "other-services", prefetch: LINK_PREFETCH_POLICY.otherServicesInSuburb, layout: { columns }, classes: { root: classes?.list } })), more ? (_jsx("p", { ...slot(classes, 'more'), children: _jsx(Link, { href: more.href, prefetch: false, children: more.label }) })) : null] }));
+}
+//# sourceMappingURL=related-services.js.map