@brandlab-digital/site-next 3.12.1 → 3.14.0

package/dist/ui-kit/icon-sprite.d.ts

@@ -0,0 +1,19 @@
+import { type SiteIconSet } from './icon-glyphs.js';
+/** The public folder the sprite is written to and served from. */
+export declare const ICON_SPRITE_FOLDER = "_bl";
+export interface IconSprite {
+    /** The sprite's markup. */
+    readonly svg: string;
+    /** The first 12 hex characters of the markup's SHA-256. */
+    readonly hash: string;
+    /** The served path, for example `/_bl/icons.0123456789ab.svg`. */
+    readonly href: string;
+}
+export declare function buildIconSprite(site?: SiteIconSet): IconSprite;
+/**
+ * Writes the sprite to `public/_bl/icons.<hash>.svg` under the project root and removes earlier sprites there, so the
+ * folder holds the current file only. Leaves an unchanged file untouched. Add `public/_bl/` to `.gitignore`: every
+ * build writes it again.
+ */
+export declare function writeIconSprite(projectRoot: string, site?: SiteIconSet): IconSprite;
+//# sourceMappingURL=icon-sprite.d.ts.map

package/dist/ui-kit/icon-sprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-sprite.d.ts","sourceRoot":"","sources":["../../src/ui-kit/icon-sprite.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAErE,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAGvC,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAiBnF"}

package/dist/ui-kit/icon-sprite.js

@@ -0,0 +1,44 @@
+/**
+ * Builds the icon sprite file (Node only; `defineBrandlabNextConfig({ icons })` calls it when the config loads). The
+ * sprite holds every library icon and the site's own, and its name carries a hash of its content, so it is served as
+ * an immutable static file and a changed icon set gets a new name.
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { iconSpriteMarkup } from './icon-glyphs.js';
+/** The public folder the sprite is written to and served from. */
+export const ICON_SPRITE_FOLDER = '_bl';
+const SPRITE_FILE = /^icons\.[0-9a-f]{12}\.svg$/;
+export function buildIconSprite(site) {
+    const svg = iconSpriteMarkup(site);
+    const hash = createHash('sha256').update(svg).digest('hex').slice(0, 12);
+    return { svg, hash, href: `/${ICON_SPRITE_FOLDER}/icons.${hash}.svg` };
+}
+/**
+ * Writes the sprite to `public/_bl/icons.<hash>.svg` under the project root and removes earlier sprites there, so the
+ * folder holds the current file only. Leaves an unchanged file untouched. Add `public/_bl/` to `.gitignore`: every
+ * build writes it again.
+ */
+export function writeIconSprite(projectRoot, site) {
+    const sprite = buildIconSprite(site);
+    const folder = join(projectRoot, 'public', ICON_SPRITE_FOLDER);
+    mkdirSync(folder, { recursive: true });
+    const name = `icons.${sprite.hash}.svg`;
+    for (const entry of readdirSync(folder)) {
+        if (entry !== name && SPRITE_FILE.test(entry))
+            rmSync(join(folder, entry), { force: true });
+    }
+    const path = join(folder, name);
+    let current = null;
+    try {
+        current = readFileSync(path, 'utf8');
+    }
+    catch {
+        current = null;
+    }
+    if (current !== sprite.svg)
+        writeFileSync(path, sprite.svg);
+    return sprite;
+}
+//# sourceMappingURL=icon-sprite.js.map

package/dist/ui-kit/icon-sprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-sprite.js","sourceRoot":"","sources":["../../src/ui-kit/icon-sprite.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAA;AAErE,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAA;AACvC,MAAM,WAAW,GAAG,4BAA4B,CAAA;AAWhD,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACxE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,kBAAkB,UAAU,IAAI,MAAM,EAAE,CAAA;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,IAAkB;IACrE,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAA;IAC9D,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,SAAS,MAAM,CAAC,IAAI,MAAM,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7F,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/B,IAAI,OAAO,GAAkB,IAAI,CAAA;IACjC,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,CAAC,GAAG;QAAE,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/**\n * Builds the icon sprite file (Node only; `defineBrandlabNextConfig({ icons })` calls it when the config loads). The\n * sprite holds every library icon and the site's own, and its name carries a hash of its content, so it is served as\n * an immutable static file and a changed icon set gets a new name.\n */\nimport { createHash } from 'node:crypto'\nimport { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { iconSpriteMarkup, type SiteIconSet } from './icon-glyphs.js'\n\n/** The public folder the sprite is written to and served from. */\nexport const ICON_SPRITE_FOLDER = '_bl'\nconst SPRITE_FILE = /^icons\\.[0-9a-f]{12}\\.svg$/\n\nexport interface IconSprite {\n  /** The sprite's markup. */\n  readonly svg: string\n  /** The first 12 hex characters of the markup's SHA-256. */\n  readonly hash: string\n  /** The served path, for example `/_bl/icons.0123456789ab.svg`. */\n  readonly href: string\n}\n\nexport function buildIconSprite(site?: SiteIconSet): IconSprite {\n  const svg = iconSpriteMarkup(site)\n  const hash = createHash('sha256').update(svg).digest('hex').slice(0, 12)\n  return { svg, hash, href: `/${ICON_SPRITE_FOLDER}/icons.${hash}.svg` }\n}\n\n/**\n * Writes the sprite to `public/_bl/icons.<hash>.svg` under the project root and removes earlier sprites there, so the\n * folder holds the current file only. Leaves an unchanged file untouched. Add `public/_bl/` to `.gitignore`: every\n * build writes it again.\n */\nexport function writeIconSprite(projectRoot: string, site?: SiteIconSet): IconSprite {\n  const sprite = buildIconSprite(site)\n  const folder = join(projectRoot, 'public', ICON_SPRITE_FOLDER)\n  mkdirSync(folder, { recursive: true })\n  const name = `icons.${sprite.hash}.svg`\n  for (const entry of readdirSync(folder)) {\n    if (entry !== name && SPRITE_FILE.test(entry)) rmSync(join(folder, entry), { force: true })\n  }\n  const path = join(folder, name)\n  let current: string | null = null\n  try {\n    current = readFileSync(path, 'utf8')\n  } catch {\n    current = null\n  }\n  if (current !== sprite.svg) writeFileSync(path, sprite.svg)\n  return sprite\n}\n"]}

package/dist/ui-kit/icons.d.ts

@@ -1,10 +1,25 @@
+/**
+ * The ui-kit's icons (no icon font). Every icon is decorative (`aria-hidden`): the control around it carries the
+ * accessible name. Stroke and fill use `currentColor`, so a skin colours them through its classes or tokens.
+ * `data-icon` names the glyph for skins and tests.
+ *
+ * From 3.14.0 an icon is `<svg aria-hidden="true" viewBox data-icon><use href="/_bl/icons.<hash>.svg#name"/></svg>`:
+ * the glyphs live once in a static, immutable sprite that `defineBrandlabNextConfig({ icons })` builds, instead of
+ * once per use in the HTML and the RSC payload. Without the sprite (tests, a site that has not opted in) the same
+ * `<svg>` carries the glyph inline.
+ */
 import type { UiSocialKind } from './types.js';
+import { type IconGlyph, type SiteIconSet, type UiIconName } from './icon-glyphs.js';
+export { UI_ICON_NAMES, type UiIconName } from './icon-glyphs.js';
 export interface IconProps {
     readonly className?: string | undefined;
 }
-export declare const UI_ICON_NAMES: readonly ["phone", "chevron", "arrow", "arrow-up", "menu", "close", "star", "check", "camera", "mail", "facebook", "instagram", "google", "linkedin", "youtube", "tiktok"];
-export type UiIconName = (typeof UI_ICON_NAMES)[number];
-/** One icon from the set by name. */
+/**
+ * The sprite's path when `defineBrandlabNextConfig({ icons })` built one, or undefined. Next inlines the variable into
+ * the server and browser bundles, so both render the same markup.
+ */
+export declare function iconSpriteHref(): string | undefined;
+/** One icon from the library set by name. */
 export declare function Icon({ name, className }: IconProps & {
     name: UiIconName;
 }): import("react/jsx-runtime").JSX.Element;
@@ -12,4 +27,24 @@ export declare function Icon({ name, className }: IconProps & {
 export declare function SocialIcon({ kind, className }: IconProps & {
     kind: UiSocialKind;
 }): import("react/jsx-runtime").JSX.Element;
+/**
+ * The component for a site's own icons, typed on its names. The same markup as `Icon`: a `<use>` into the shared
+ * sprite once the config lists the set in `icons.site`, the glyph inline otherwise.
+ *
+ * ```tsx
+ * export const SiteIcon = createSiteIcon(siteIcons) // src/site/ui.tsx
+ * <SiteIcon name="leaf" />
+ * ```
+ */
+export declare function createSiteIcon<Name extends string>(icons: SiteIconSet<Name>): ({ name, className }: IconProps & {
+    name: Name;
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * The one star the rating row repeats: its `<use>` reference into the sprite, or its glyph for the inline fallback.
+ * `RatingStars` places five of them in one `<svg>`.
+ */
+export declare function starGlyph(): {
+    readonly href?: string;
+    readonly glyph: IconGlyph;
+};
 //# sourceMappingURL=icons.d.ts.map

package/dist/ui-kit/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/ui-kit/icons.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED,eAAO,MAAM,aAAa,4KAiBhB,CAAA;AACV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAwGvD,qCAAqC;AACrC,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,2CAOzE;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,2CAEjF"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/ui-kit/icons.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAEjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAGnD;AAgBD,6CAA6C;AAC7C,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,2CAEzE;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,2CAEjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,yBACnC,SAAS,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,6CAMlE;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAGjF"}

package/dist/ui-kit/icons.js

@@ -1,72 +1,55 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-export const UI_ICON_NAMES = [
-    'phone',
-    'chevron',
-    'arrow',
-    'arrow-up',
-    'menu',
-    'close',
-    'star',
-    'check',
-    'camera',
-    'mail',
-    'facebook',
-    'instagram',
-    'google',
-    'linkedin',
-    'youtube',
-    'tiktok',
-];
-function Svg({ name, viewBox = '0 0 24 24', className, children }) {
-    return (_jsx("svg", { "aria-hidden": "true", focusable: "false", viewBox: viewBox, className: className, "data-icon": name, children: children }));
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_ICON_VIEW_BOX, UI_ICON_GLYPHS, } from './icon-glyphs.js';
+export { UI_ICON_NAMES } from './icon-glyphs.js';
+/**
+ * The sprite's path when `defineBrandlabNextConfig({ icons })` built one, or undefined. Next inlines the variable into
+ * the server and browser bundles, so both render the same markup.
+ */
+export function iconSpriteHref() {
+    const href = process.env.NEXT_PUBLIC_BL_ICON_SPRITE;
+    return typeof href === 'string' && /^\/[\w./-]+\.svg$/.test(href) ? href : undefined;
 }
-const stroke = { fill: 'none', stroke: 'currentColor', strokeLinecap: 'round', strokeLinejoin: 'round' };
-const GLYPHS = {
-    phone: {
-        body: (_jsx("path", { ...stroke, strokeWidth: "1.6", d: "M2.25 6.75c0 8.284 6.716 15 15 15h2.25a2.25 2.25 0 0 0 2.25-2.25v-1.372c0-.516-.351-.966-.852-1.091l-4.423-1.106a1.125 1.125 0 0 0-1.173.417l-.97 1.293a1.125 1.125 0 0 1-1.21.38 12.035 12.035 0 0 1-7.143-7.143 1.125 1.125 0 0 1 .38-1.21l1.293-.97c.363-.271.527-.734.417-1.173L6.963 3.102a1.125 1.125 0 0 0-1.091-.852H4.5A2.25 2.25 0 0 0 2.25 4.5v2.25Z" })),
-    },
-    chevron: { body: _jsx("path", { ...stroke, strokeWidth: "1.8", d: "m6 9 6 6 6-6" }) },
-    arrow: { body: _jsx("path", { ...stroke, strokeWidth: "1.6", d: "M13.5 4.5 21 12l-7.5 7.5M3 12h17.25" }) },
-    'arrow-up': { body: _jsx("path", { ...stroke, strokeWidth: "1.8", d: "M12 20V4m0 0-7 7m7-7 7 7" }) },
-    menu: { body: _jsx("path", { ...stroke, strokeWidth: "1.7", d: "M4 7h16M4 12h16M4 17h16" }) },
-    close: { body: _jsx("path", { ...stroke, strokeWidth: "1.7", d: "M6 18 18 6M6 6l12 12" }) },
-    star: {
-        viewBox: '0 0 20 20',
-        body: _jsx("path", { fill: "currentColor", d: "M10 1.6 12.6 7l5.9.7-4.4 4 1.2 5.8L10 14.6l-5.3 2.9L5.9 11.7l-4.4-4L7.4 7 10 1.6Z" }),
-    },
-    check: { body: _jsx("path", { ...stroke, strokeWidth: "2", d: "m4.5 12.75 6 6 9-13.5" }) },
-    camera: {
-        body: (_jsxs(_Fragment, { children: [_jsx("path", { ...stroke, strokeWidth: "1.6", d: "M3 8.25A2.25 2.25 0 0 1 5.25 6h1.372c.516 0 .966-.351 1.091-.852l.38-1.52A1.125 1.125 0 0 1 9.184 2.7h5.632c.516 0 .966.351 1.091.852l.38 1.52c.125.5.575.852 1.091.852h1.372A2.25 2.25 0 0 1 21 8.25v9.75a2.25 2.25 0 0 1-2.25 2.25H5.25A2.25 2.25 0 0 1 3 18V8.25Z" }), _jsx("circle", { ...stroke, strokeWidth: "1.6", cx: "12", cy: "12.75", r: "3.75" })] })),
-    },
-    mail: {
-        body: (_jsx("path", { ...stroke, strokeWidth: "1.6", d: "M21.75 6.75v10.5a2.25 2.25 0 0 1-2.25 2.25h-15a2.25 2.25 0 0 1-2.25-2.25V6.75m19.5 0A2.25 2.25 0 0 0 19.5 4.5h-15a2.25 2.25 0 0 0-2.25 2.25m19.5 0-8.69 5.6a2.25 2.25 0 0 1-2.12 0l-8.69-5.6" })),
-    },
-    facebook: {
-        body: (_jsx("path", { fill: "currentColor", d: "M9 8H6v4h3v12h5V12h3.642L18 8h-4V6.333C14 5.378 14.192 5 15.115 5H18V0h-3.808C10.596 0 9 1.583 9 4.615V8Z" })),
-    },
-    instagram: {
-        body: (_jsxs(_Fragment, { children: [_jsx("rect", { x: "3", y: "3", width: "18", height: "18", rx: "5", fill: "none", stroke: "currentColor", strokeWidth: "2" }), _jsx("circle", { cx: "12", cy: "12", r: "4.2", fill: "none", stroke: "currentColor", strokeWidth: "2" }), _jsx("circle", { cx: "17.4", cy: "6.6", r: "1.3", fill: "currentColor" })] })),
-    },
-    google: {
-        body: (_jsx("path", { fill: "currentColor", d: "M21.6 12.23c0-.68-.06-1.33-.17-1.96H12v3.7h5.39a4.6 4.6 0 0 1-2 3.02v2.5h3.24c1.9-1.75 2.97-4.32 2.97-7.26ZM12 22c2.7 0 4.96-.9 6.62-2.43l-3.24-2.5c-.9.6-2.04.95-3.38.95-2.6 0-4.8-1.75-5.59-4.11H3.07v2.59A10 10 0 0 0 12 22Zm-5.59-8.09A6 6 0 0 1 6.1 12c0-.66.11-1.31.31-1.91V7.5H3.07A10 10 0 0 0 2 12c0 1.61.39 3.14 1.07 4.5l3.34-2.59ZM12 5.98c1.47 0 2.79.5 3.83 1.5l2.87-2.87A9.6 9.6 0 0 0 12 2a10 10 0 0 0-8.93 5.5l3.34 2.59C7.2 7.73 9.4 5.98 12 5.98Z" })),
-    },
-    linkedin: {
-        body: (_jsx("path", { fill: "currentColor", d: "M4.98 3.5a2.5 2.5 0 1 1 0 5 2.5 2.5 0 0 1 0-5ZM3 9.75h4v11.5H3V9.75Zm6.5 0h3.83v1.57h.06c.53-1 1.84-2.07 3.79-2.07 4.05 0 4.8 2.67 4.8 6.13v5.87h-4v-5.2c0-1.24-.02-2.84-1.73-2.84-1.73 0-2 1.35-2 2.75v5.29h-4V9.75Z" })),
-    },
-    youtube: {
-        body: (_jsx("path", { fill: "currentColor", d: "M23 7.2a3 3 0 0 0-2.1-2.1C19 4.6 12 4.6 12 4.6s-7 0-8.9.5A3 3 0 0 0 1 7.2 31 31 0 0 0 .5 12a31 31 0 0 0 .5 4.8 3 3 0 0 0 2.1 2.1c1.9.5 8.9.5 8.9.5s7 0 8.9-.5a3 3 0 0 0 2.1-2.1 31 31 0 0 0 .5-4.8 31 31 0 0 0-.5-4.8ZM9.75 15.02V8.98L15.5 12l-5.75 3.02Z" })),
-    },
-    tiktok: {
-        body: (_jsx("path", { fill: "currentColor", d: "M16.6 2h-3.4v13.4a2.9 2.9 0 1 1-2.9-2.9c.3 0 .6 0 .9.1V9.1a6.3 6.3 0 1 0 5.4 6.3V8.6a8.1 8.1 0 0 0 4.4 1.3V6.5a4.5 4.5 0 0 1-4.4-4.5Z" })),
-    },
-};
-/** One icon from the set by name. */
+function SvgIcon({ name, glyph, className }) {
+    const viewBox = glyph.viewBox ?? DEFAULT_ICON_VIEW_BOX;
+    const sprite = iconSpriteHref();
+    if (sprite) {
+        return (_jsx("svg", { "aria-hidden": "true", viewBox: viewBox, className: className, "data-icon": name, children: _jsx("use", { href: `${sprite}#${name}` }) }));
+    }
+    // The fallback: the glyph inline. Library glyphs are constants; site glyphs passed defineSiteIcons' shape checks.
+    return _jsx("svg", { "aria-hidden": "true", viewBox: viewBox, className: className, "data-icon": name, dangerouslySetInnerHTML: { __html: glyph.body } });
+}
+/** One icon from the library set by name. */
 export function Icon({ name, className }) {
-    const glyph = GLYPHS[name];
-    return (_jsx(Svg, { name: name, viewBox: glyph.viewBox, className: className, children: glyph.body }));
+    return _jsx(SvgIcon, { name: name, glyph: UI_ICON_GLYPHS[name], className: className });
 }
 /** The icon for a social or Business Profile link. */
 export function SocialIcon({ kind, className }) {
     return _jsx(Icon, { name: kind, className: className });
 }
+/**
+ * The component for a site's own icons, typed on its names. The same markup as `Icon`: a `<use>` into the shared
+ * sprite once the config lists the set in `icons.site`, the glyph inline otherwise.
+ *
+ * ```tsx
+ * export const SiteIcon = createSiteIcon(siteIcons) // src/site/ui.tsx
+ * <SiteIcon name="leaf" />
+ * ```
+ */
+export function createSiteIcon(icons) {
+    function SiteIcon({ name, className }) {
+        const glyph = icons.glyphs[name];
+        if (!glyph)
+            throw new Error(`Site icon "${name}" is not in the registered set.`);
+        return _jsx(SvgIcon, { name: name, glyph: glyph, className: className });
+    }
+    return SiteIcon;
+}
+/**
+ * The one star the rating row repeats: its `<use>` reference into the sprite, or its glyph for the inline fallback.
+ * `RatingStars` places five of them in one `<svg>`.
+ */
+export function starGlyph() {
+    const sprite = iconSpriteHref();
+    return sprite ? { href: `${sprite}#star`, glyph: UI_ICON_GLYPHS.star } : { glyph: UI_ICON_GLYPHS.star };
+}
 //# sourceMappingURL=icons.js.map

package/dist/ui-kit/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/ui-kit/icons.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The ui-kit's inline SVG icon set (no icon font). Every icon is decorative (`aria-hidden`, not focusable): the\n * control around it carries the accessible name. Stroke and fill use `currentColor`, so a skin colours them through\n * its classes or tokens. `data-icon` names the glyph for skins and tests.\n */\nimport type { ReactNode } from 'react'\nimport type { UiSocialKind } from './types.js'\n\nexport interface IconProps {\n  readonly className?: string | undefined\n}\n\nexport const UI_ICON_NAMES = [\n  'phone',\n  'chevron',\n  'arrow',\n  'arrow-up',\n  'menu',\n  'close',\n  'star',\n  'check',\n  'camera',\n  'mail',\n  'facebook',\n  'instagram',\n  'google',\n  'linkedin',\n  'youtube',\n  'tiktok',\n] as const\nexport type UiIconName = (typeof UI_ICON_NAMES)[number]\n\nfunction Svg({ name, viewBox = '0 0 24 24', className, children }: IconProps & { name: UiIconName; viewBox?: string; children: ReactNode }) {\n  return (\n    <svg aria-hidden=\"true\" focusable=\"false\" viewBox={viewBox} className={className} data-icon={name}>\n      {children}\n    </svg>\n  )\n}\n\nconst stroke = { fill: 'none', stroke: 'currentColor', strokeLinecap: 'round', strokeLinejoin: 'round' } as const\n\nconst GLYPHS: Record<UiIconName, { viewBox?: string; body: ReactNode }> = {\n  phone: {\n    body: (\n      <path\n        {...stroke}\n        strokeWidth=\"1.6\"\n        d=\"M2.25 6.75c0 8.284 6.716 15 15 15h2.25a2.25 2.25 0 0 0 2.25-2.25v-1.372c0-.516-.351-.966-.852-1.091l-4.423-1.106a1.125 1.125 0 0 0-1.173.417l-.97 1.293a1.125 1.125 0 0 1-1.21.38 12.035 12.035 0 0 1-7.143-7.143 1.125 1.125 0 0 1 .38-1.21l1.293-.97c.363-.271.527-.734.417-1.173L6.963 3.102a1.125 1.125 0 0 0-1.091-.852H4.5A2.25 2.25 0 0 0 2.25 4.5v2.25Z\"\n      />\n    ),\n  },\n  chevron: { body: <path {...stroke} strokeWidth=\"1.8\" d=\"m6 9 6 6 6-6\" /> },\n  arrow: { body: <path {...stroke} strokeWidth=\"1.6\" d=\"M13.5 4.5 21 12l-7.5 7.5M3 12h17.25\" /> },\n  'arrow-up': { body: <path {...stroke} strokeWidth=\"1.8\" d=\"M12 20V4m0 0-7 7m7-7 7 7\" /> },\n  menu: { body: <path {...stroke} strokeWidth=\"1.7\" d=\"M4 7h16M4 12h16M4 17h16\" /> },\n  close: { body: <path {...stroke} strokeWidth=\"1.7\" d=\"M6 18 18 6M6 6l12 12\" /> },\n  star: {\n    viewBox: '0 0 20 20',\n    body: <path fill=\"currentColor\" d=\"M10 1.6 12.6 7l5.9.7-4.4 4 1.2 5.8L10 14.6l-5.3 2.9L5.9 11.7l-4.4-4L7.4 7 10 1.6Z\" />,\n  },\n  check: { body: <path {...stroke} strokeWidth=\"2\" d=\"m4.5 12.75 6 6 9-13.5\" /> },\n  camera: {\n    body: (\n      <>\n        <path\n          {...stroke}\n          strokeWidth=\"1.6\"\n          d=\"M3 8.25A2.25 2.25 0 0 1 5.25 6h1.372c.516 0 .966-.351 1.091-.852l.38-1.52A1.125 1.125 0 0 1 9.184 2.7h5.632c.516 0 .966.351 1.091.852l.38 1.52c.125.5.575.852 1.091.852h1.372A2.25 2.25 0 0 1 21 8.25v9.75a2.25 2.25 0 0 1-2.25 2.25H5.25A2.25 2.25 0 0 1 3 18V8.25Z\"\n        />\n        <circle {...stroke} strokeWidth=\"1.6\" cx=\"12\" cy=\"12.75\" r=\"3.75\" />\n      </>\n    ),\n  },\n  mail: {\n    body: (\n      <path\n        {...stroke}\n        strokeWidth=\"1.6\"\n        d=\"M21.75 6.75v10.5a2.25 2.25 0 0 1-2.25 2.25h-15a2.25 2.25 0 0 1-2.25-2.25V6.75m19.5 0A2.25 2.25 0 0 0 19.5 4.5h-15a2.25 2.25 0 0 0-2.25 2.25m19.5 0-8.69 5.6a2.25 2.25 0 0 1-2.12 0l-8.69-5.6\"\n      />\n    ),\n  },\n  facebook: {\n    body: (\n      <path\n        fill=\"currentColor\"\n        d=\"M9 8H6v4h3v12h5V12h3.642L18 8h-4V6.333C14 5.378 14.192 5 15.115 5H18V0h-3.808C10.596 0 9 1.583 9 4.615V8Z\"\n      />\n    ),\n  },\n  instagram: {\n    body: (\n      <>\n        <rect x=\"3\" y=\"3\" width=\"18\" height=\"18\" rx=\"5\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" />\n        <circle cx=\"12\" cy=\"12\" r=\"4.2\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" />\n        <circle cx=\"17.4\" cy=\"6.6\" r=\"1.3\" fill=\"currentColor\" />\n      </>\n    ),\n  },\n  google: {\n    body: (\n      <path\n        fill=\"currentColor\"\n        d=\"M21.6 12.23c0-.68-.06-1.33-.17-1.96H12v3.7h5.39a4.6 4.6 0 0 1-2 3.02v2.5h3.24c1.9-1.75 2.97-4.32 2.97-7.26ZM12 22c2.7 0 4.96-.9 6.62-2.43l-3.24-2.5c-.9.6-2.04.95-3.38.95-2.6 0-4.8-1.75-5.59-4.11H3.07v2.59A10 10 0 0 0 12 22Zm-5.59-8.09A6 6 0 0 1 6.1 12c0-.66.11-1.31.31-1.91V7.5H3.07A10 10 0 0 0 2 12c0 1.61.39 3.14 1.07 4.5l3.34-2.59ZM12 5.98c1.47 0 2.79.5 3.83 1.5l2.87-2.87A9.6 9.6 0 0 0 12 2a10 10 0 0 0-8.93 5.5l3.34 2.59C7.2 7.73 9.4 5.98 12 5.98Z\"\n      />\n    ),\n  },\n  linkedin: {\n    body: (\n      <path\n        fill=\"currentColor\"\n        d=\"M4.98 3.5a2.5 2.5 0 1 1 0 5 2.5 2.5 0 0 1 0-5ZM3 9.75h4v11.5H3V9.75Zm6.5 0h3.83v1.57h.06c.53-1 1.84-2.07 3.79-2.07 4.05 0 4.8 2.67 4.8 6.13v5.87h-4v-5.2c0-1.24-.02-2.84-1.73-2.84-1.73 0-2 1.35-2 2.75v5.29h-4V9.75Z\"\n      />\n    ),\n  },\n  youtube: {\n    body: (\n      <path\n        fill=\"currentColor\"\n        d=\"M23 7.2a3 3 0 0 0-2.1-2.1C19 4.6 12 4.6 12 4.6s-7 0-8.9.5A3 3 0 0 0 1 7.2 31 31 0 0 0 .5 12a31 31 0 0 0 .5 4.8 3 3 0 0 0 2.1 2.1c1.9.5 8.9.5 8.9.5s7 0 8.9-.5a3 3 0 0 0 2.1-2.1 31 31 0 0 0 .5-4.8 31 31 0 0 0-.5-4.8ZM9.75 15.02V8.98L15.5 12l-5.75 3.02Z\"\n      />\n    ),\n  },\n  tiktok: {\n    body: (\n      <path\n        fill=\"currentColor\"\n        d=\"M16.6 2h-3.4v13.4a2.9 2.9 0 1 1-2.9-2.9c.3 0 .6 0 .9.1V9.1a6.3 6.3 0 1 0 5.4 6.3V8.6a8.1 8.1 0 0 0 4.4 1.3V6.5a4.5 4.5 0 0 1-4.4-4.5Z\"\n      />\n    ),\n  },\n}\n\n/** One icon from the set by name. */\nexport function Icon({ name, className }: IconProps & { name: UiIconName }) {\n  const glyph = GLYPHS[name]\n  return (\n    <Svg name={name} viewBox={glyph.viewBox} className={className}>\n      {glyph.body}\n    </Svg>\n  )\n}\n\n/** The icon for a social or Business Profile link. */\nexport function SocialIcon({ kind, className }: IconProps & { kind: UiSocialKind }) {\n  return <Icon name={kind} className={className} />\n}\n"]}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/ui-kit/icons.tsx"],"names":[],"mappings":";AAWA,OAAO,EACL,qBAAqB,EACrB,cAAc,GAIf,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAmB,MAAM,kBAAkB,CAAA;AAMjE;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAA;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACtF,CAAC;AAED,SAAS,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAkD;IACzF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,qBAAqB,CAAA;IACtD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CACL,6BAAiB,MAAM,EAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,eAAa,IAAI,YAC7E,cAAK,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,EAAE,GAAI,GAC9B,CACP,CAAA;IACH,CAAC;IACD,kHAAkH;IAClH,OAAO,6BAAiB,MAAM,EAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,eAAa,IAAI,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,GAAI,CAAA;AAC7I,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAoC;IACxE,OAAO,KAAC,OAAO,IAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,GAAI,CAAA;AACnF,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAsC;IAChF,OAAO,KAAC,IAAI,IAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,GAAI,CAAA;AACnD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAsB,KAAwB;IAC1E,SAAS,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAA8B;QAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,iCAAiC,CAAC,CAAA;QAChF,OAAO,KAAC,OAAO,IAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAI,CAAA;IACpE,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,CAAA;AACzG,CAAC","sourcesContent":["/**\n * The ui-kit's icons (no icon font). Every icon is decorative (`aria-hidden`): the control around it carries the\n * accessible name. Stroke and fill use `currentColor`, so a skin colours them through its classes or tokens.\n * `data-icon` names the glyph for skins and tests.\n *\n * From 3.14.0 an icon is `<svg aria-hidden=\"true\" viewBox data-icon><use href=\"/_bl/icons.<hash>.svg#name\"/></svg>`:\n * the glyphs live once in a static, immutable sprite that `defineBrandlabNextConfig({ icons })` builds, instead of\n * once per use in the HTML and the RSC payload. Without the sprite (tests, a site that has not opted in) the same\n * `<svg>` carries the glyph inline.\n */\nimport type { UiSocialKind } from './types.js'\nimport {\n  DEFAULT_ICON_VIEW_BOX,\n  UI_ICON_GLYPHS,\n  type IconGlyph,\n  type SiteIconSet,\n  type UiIconName,\n} from './icon-glyphs.js'\n\nexport { UI_ICON_NAMES, type UiIconName } from './icon-glyphs.js'\n\nexport interface IconProps {\n  readonly className?: string | undefined\n}\n\n/**\n * The sprite's path when `defineBrandlabNextConfig({ icons })` built one, or undefined. Next inlines the variable into\n * the server and browser bundles, so both render the same markup.\n */\nexport function iconSpriteHref(): string | undefined {\n  const href = process.env.NEXT_PUBLIC_BL_ICON_SPRITE\n  return typeof href === 'string' && /^\\/[\\w./-]+\\.svg$/.test(href) ? href : undefined\n}\n\nfunction SvgIcon({ name, glyph, className }: IconProps & { name: string; glyph: IconGlyph }) {\n  const viewBox = glyph.viewBox ?? DEFAULT_ICON_VIEW_BOX\n  const sprite = iconSpriteHref()\n  if (sprite) {\n    return (\n      <svg aria-hidden=\"true\" viewBox={viewBox} className={className} data-icon={name}>\n        <use href={`${sprite}#${name}`} />\n      </svg>\n    )\n  }\n  // The fallback: the glyph inline. Library glyphs are constants; site glyphs passed defineSiteIcons' shape checks.\n  return <svg aria-hidden=\"true\" viewBox={viewBox} className={className} data-icon={name} dangerouslySetInnerHTML={{ __html: glyph.body }} />\n}\n\n/** One icon from the library set by name. */\nexport function Icon({ name, className }: IconProps & { name: UiIconName }) {\n  return <SvgIcon name={name} glyph={UI_ICON_GLYPHS[name]} className={className} />\n}\n\n/** The icon for a social or Business Profile link. */\nexport function SocialIcon({ kind, className }: IconProps & { kind: UiSocialKind }) {\n  return <Icon name={kind} className={className} />\n}\n\n/**\n * The component for a site's own icons, typed on its names. The same markup as `Icon`: a `<use>` into the shared\n * sprite once the config lists the set in `icons.site`, the glyph inline otherwise.\n *\n * ```tsx\n * export const SiteIcon = createSiteIcon(siteIcons) // src/site/ui.tsx\n * <SiteIcon name=\"leaf\" />\n * ```\n */\nexport function createSiteIcon<Name extends string>(icons: SiteIconSet<Name>) {\n  function SiteIcon({ name, className }: IconProps & { name: Name }) {\n    const glyph = icons.glyphs[name]\n    if (!glyph) throw new Error(`Site icon \"${name}\" is not in the registered set.`)\n    return <SvgIcon name={name} glyph={glyph} className={className} />\n  }\n  return SiteIcon\n}\n\n/**\n * The one star the rating row repeats: its `<use>` reference into the sprite, or its glyph for the inline fallback.\n * `RatingStars` places five of them in one `<svg>`.\n */\nexport function starGlyph(): { readonly href?: string; readonly glyph: IconGlyph } {\n  const sprite = iconSpriteHref()\n  return sprite ? { href: `${sprite}#star`, glyph: UI_ICON_GLYPHS.star } : { glyph: UI_ICON_GLYPHS.star }\n}\n"]}

package/dist/ui-kit/prefetch.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Prefetch by link role (W2, 3.13.0). Next's default `<Link>` prefetches the whole route when the link comes within
+ * about 200 px of the viewport, so a long page of suburb, footer and map links fetched 16 to 45 pages on a full scroll
+ * while visitors read 1.0 to 1.3 pages a session. Each link role now has one setting:
+ *
+ * - `auto` (Next's default): the top-level header links (7 at most, never the current page) and the main quote or
+ *   contact action;
+ * - `intent`: in-content service, project and blog cards (8 at most, matching K11). They render `prefetch={false}`
+ *   and `data-prefetch="intent"`; `IntentPrefetch` (mounted once in the root layout) prefetches one of them when a
+ *   visitor points at, focuses or touches it;
+ * - `false`: header panels, the drawer, the footer, area and suburb lists, nearby suburbs, area maps, suburb finder
+ *   results, other services in this suburb and any link inside a hidden container.
+ *
+ * The ready gate's W2 journey fails a page that prefetches more than 8 destinations on landing or 12 after a full
+ * scroll, or prefetches from an off role, a hidden link or the current page. It finds a site's own off-role
+ * containers by the shared section ids (`coverage`, `nearby-areas`, `area-map`), the area map's `data-area-map` or
+ * `data-bl-links` with one of `area`, `nearby`, `map`, `finder` or `other-services` on the list's container.
+ */
+/** A link's prefetch setting: Next's default, on intent only, or off. */
+export type LinkPrefetch = 'auto' | 'intent' | false;
+export declare const LINK_PREFETCH_POLICY: Readonly<{
+    readonly headerTopLevel: "auto";
+    readonly primaryAction: "auto";
+    readonly contentCard: "intent";
+    readonly headerPanel: false;
+    readonly drawer: false;
+    readonly footer: false;
+    readonly areaList: false;
+    readonly nearbySuburbs: false;
+    readonly areaMap: false;
+    readonly finderResults: false;
+    readonly otherServicesInSuburb: false;
+    readonly hiddenContainer: false;
+}>;
+export type LinkPrefetchRole = keyof typeof LINK_PREFETCH_POLICY;
+/** The most links of each prefetching role on one page, and W2's page limits. */
+export declare const LINK_PREFETCH_LIMITS: Readonly<{
+    headerTopLevel: 7;
+    contentCard: 8;
+    landingDestinations: 8;
+    scrolledDestinations: 12;
+}>;
+/** The marker `IntentPrefetch` listens for. */
+export declare const INTENT_PREFETCH_SELECTOR = "a[data-prefetch=\"intent\"]";
+/** The `next/link` props for a setting: nothing for `auto`, prefetch off for `false`, and off plus the marker for `intent`. */
+export declare function linkPrefetchProps(prefetch: LinkPrefetch | undefined): {
+    prefetch?: false;
+    'data-prefetch'?: 'intent';
+};
+//# sourceMappingURL=prefetch.d.ts.map

package/dist/ui-kit/prefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../../src/ui-kit/prefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEpD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;EAaiB,CAAA;AAElD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,oBAAoB,CAAA;AAEhE,iFAAiF;AACjF,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAA;AAEF,+CAA+C;AAC/C,eAAO,MAAM,wBAAwB,gCAA8B,CAAA;AAEnE,+HAA+H;AAC/H,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,eAAe,CAAC,EAAE,QAAQ,CAAA;CAAE,CAItH"}

package/dist/ui-kit/prefetch.js

@@ -0,0 +1,50 @@
+/**
+ * Prefetch by link role (W2, 3.13.0). Next's default `<Link>` prefetches the whole route when the link comes within
+ * about 200 px of the viewport, so a long page of suburb, footer and map links fetched 16 to 45 pages on a full scroll
+ * while visitors read 1.0 to 1.3 pages a session. Each link role now has one setting:
+ *
+ * - `auto` (Next's default): the top-level header links (7 at most, never the current page) and the main quote or
+ *   contact action;
+ * - `intent`: in-content service, project and blog cards (8 at most, matching K11). They render `prefetch={false}`
+ *   and `data-prefetch="intent"`; `IntentPrefetch` (mounted once in the root layout) prefetches one of them when a
+ *   visitor points at, focuses or touches it;
+ * - `false`: header panels, the drawer, the footer, area and suburb lists, nearby suburbs, area maps, suburb finder
+ *   results, other services in this suburb and any link inside a hidden container.
+ *
+ * The ready gate's W2 journey fails a page that prefetches more than 8 destinations on landing or 12 after a full
+ * scroll, or prefetches from an off role, a hidden link or the current page. It finds a site's own off-role
+ * containers by the shared section ids (`coverage`, `nearby-areas`, `area-map`), the area map's `data-area-map` or
+ * `data-bl-links` with one of `area`, `nearby`, `map`, `finder` or `other-services` on the list's container.
+ */
+export const LINK_PREFETCH_POLICY = Object.freeze({
+    headerTopLevel: 'auto',
+    primaryAction: 'auto',
+    contentCard: 'intent',
+    headerPanel: false,
+    drawer: false,
+    footer: false,
+    areaList: false,
+    nearbySuburbs: false,
+    areaMap: false,
+    finderResults: false,
+    otherServicesInSuburb: false,
+    hiddenContainer: false,
+});
+/** The most links of each prefetching role on one page, and W2's page limits. */
+export const LINK_PREFETCH_LIMITS = Object.freeze({
+    headerTopLevel: 7,
+    contentCard: 8,
+    landingDestinations: 8,
+    scrolledDestinations: 12,
+});
+/** The marker `IntentPrefetch` listens for. */
+export const INTENT_PREFETCH_SELECTOR = 'a[data-prefetch="intent"]';
+/** The `next/link` props for a setting: nothing for `auto`, prefetch off for `false`, and off plus the marker for `intent`. */
+export function linkPrefetchProps(prefetch) {
+    if (prefetch === 'intent')
+        return { prefetch: false, 'data-prefetch': 'intent' };
+    if (prefetch === false)
+        return { prefetch: false };
+    return {};
+}
+//# sourceMappingURL=prefetch.js.map

package/dist/ui-kit/prefetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.js","sourceRoot":"","sources":["../../src/ui-kit/prefetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,cAAc,EAAE,MAAM;IACtB,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,KAAK;IAClB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,KAAK;IACpB,OAAO,EAAE,KAAK;IACd,aAAa,EAAE,KAAK;IACpB,qBAAqB,EAAE,KAAK;IAC5B,eAAe,EAAE,KAAK;CACyB,CAAC,CAAA;AAIlD,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,cAAc,EAAE,CAAC;IACjB,WAAW,EAAE,CAAC;IACd,mBAAmB,EAAE,CAAC;IACtB,oBAAoB,EAAE,EAAE;CACzB,CAAC,CAAA;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAA;AAEnE,+HAA+H;AAC/H,MAAM,UAAU,iBAAiB,CAAC,QAAkC;IAClE,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAA;IAChF,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;IAClD,OAAO,EAAE,CAAA;AACX,CAAC","sourcesContent":["/**\n * Prefetch by link role (W2, 3.13.0). Next's default `<Link>` prefetches the whole route when the link comes within\n * about 200 px of the viewport, so a long page of suburb, footer and map links fetched 16 to 45 pages on a full scroll\n * while visitors read 1.0 to 1.3 pages a session. Each link role now has one setting:\n *\n * - `auto` (Next's default): the top-level header links (7 at most, never the current page) and the main quote or\n *   contact action;\n * - `intent`: in-content service, project and blog cards (8 at most, matching K11). They render `prefetch={false}`\n *   and `data-prefetch=\"intent\"`; `IntentPrefetch` (mounted once in the root layout) prefetches one of them when a\n *   visitor points at, focuses or touches it;\n * - `false`: header panels, the drawer, the footer, area and suburb lists, nearby suburbs, area maps, suburb finder\n *   results, other services in this suburb and any link inside a hidden container.\n *\n * The ready gate's W2 journey fails a page that prefetches more than 8 destinations on landing or 12 after a full\n * scroll, or prefetches from an off role, a hidden link or the current page. It finds a site's own off-role\n * containers by the shared section ids (`coverage`, `nearby-areas`, `area-map`), the area map's `data-area-map` or\n * `data-bl-links` with one of `area`, `nearby`, `map`, `finder` or `other-services` on the list's container.\n */\n\n/** A link's prefetch setting: Next's default, on intent only, or off. */\nexport type LinkPrefetch = 'auto' | 'intent' | false\n\nexport const LINK_PREFETCH_POLICY = Object.freeze({\n  headerTopLevel: 'auto',\n  primaryAction: 'auto',\n  contentCard: 'intent',\n  headerPanel: false,\n  drawer: false,\n  footer: false,\n  areaList: false,\n  nearbySuburbs: false,\n  areaMap: false,\n  finderResults: false,\n  otherServicesInSuburb: false,\n  hiddenContainer: false,\n} as const satisfies Record<string, LinkPrefetch>)\n\nexport type LinkPrefetchRole = keyof typeof LINK_PREFETCH_POLICY\n\n/** The most links of each prefetching role on one page, and W2's page limits. */\nexport const LINK_PREFETCH_LIMITS = Object.freeze({\n  headerTopLevel: 7,\n  contentCard: 8,\n  landingDestinations: 8,\n  scrolledDestinations: 12,\n})\n\n/** The marker `IntentPrefetch` listens for. */\nexport const INTENT_PREFETCH_SELECTOR = 'a[data-prefetch=\"intent\"]'\n\n/** The `next/link` props for a setting: nothing for `auto`, prefetch off for `false`, and off plus the marker for `intent`. */\nexport function linkPrefetchProps(prefetch: LinkPrefetch | undefined): { prefetch?: false; 'data-prefetch'?: 'intent' } {\n  if (prefetch === 'intent') return { prefetch: false, 'data-prefetch': 'intent' }\n  if (prefetch === false) return { prefetch: false }\n  return {}\n}\n"]}

package/dist/ui-kit/primitives/badge.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `Badge` and `Chip` (3.14.0): a short label as text, never an image of text, with an optional decorative icon.
+ * Server components. A badge marks a fact ("Licensed", "Fully insured"); a chip names a filter or a tag, and is the only
+ * one a skin may make a pill (Romie, Absolute: "too many round elements").
+ *
+ * Both are rendered once per entry of a list, so their parts take no class (3.14.0 repeated slots): the site styles
+ * `[data-bl="badge"]` and `[data-bl="chip"]` once in `src/site/skin.css`.
+ */
+import { type UiIconName } from '../icons.js';
+import type { RepeatedSlotOf } from '../repeated-slots.js';
+import { type SkinEntry } from '../skin.js';
+export type BadgeSlot = RepeatedSlotOf<'badge'>;
+export type BadgeSkin = SkinEntry<BadgeSlot, never, Record<never, never>, BadgeSlot>;
+export type ChipSlot = RepeatedSlotOf<'chip'>;
+export type ChipSkin = SkinEntry<ChipSlot, never, Record<never, never>, ChipSlot>;
+export interface BadgeProps extends BadgeSkin {
+    /** The label, in the site's words. */
+    readonly children: string;
+    /** A decorative icon before the label. */
+    readonly icon?: UiIconName;
+}
+export type ChipProps = BadgeProps & ChipSkin;
+export declare function Badge({ children, icon }: BadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function Chip({ children, icon }: ChipProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=badge.d.ts.map

package/dist/ui-kit/primitives/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/ui-kit/primitives/badge.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAA;AACpF,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;AAC7C,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAA;AAEjF,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;CAC3B;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAA;AAe7C,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,UAAU,2CAMnD;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,SAAS,2CAMjD"}

package/dist/ui-kit/primitives/badge.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `Badge` and `Chip` (3.14.0): a short label as text, never an image of text, with an optional decorative icon.
+ * Server components. A badge marks a fact ("Licensed", "Fully insured"); a chip names a filter or a tag, and is the only
+ * one a skin may make a pill (Romie, Absolute: "too many round elements").
+ *
+ * Both are rendered once per entry of a list, so their parts take no class (3.14.0 repeated slots): the site styles
+ * `[data-bl="badge"]` and `[data-bl="chip"]` once in `src/site/skin.css`.
+ */
+import { Icon } from '../icons.js';
+import { repeatedSlot } from '../skin.js';
+function Label({ hook, children, icon }) {
+    return (_jsxs("span", { "data-bl": hook, children: [icon ? (_jsx("span", { ...repeatedSlot('icon'), children: _jsx(Icon, { name: icon }) })) : null, _jsx("span", { ...repeatedSlot('label'), children: children })] }));
+}
+export function Badge({ children, icon }) {
+    return (_jsx(Label, { hook: "badge", icon: icon, children: children }));
+}
+export function Chip({ children, icon }) {
+    return (_jsx(Label, { hook: "chip", icon: icon, children: children }));
+}
+//# sourceMappingURL=badge.js.map

package/dist/ui-kit/primitives/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../../src/ui-kit/primitives/badge.tsx"],"names":[],"mappings":";AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAmB,MAAM,aAAa,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAA;AAgBzD,SAAS,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAA+E;IAClH,OAAO,CACL,2BAAe,IAAI,aAChB,IAAI,CAAC,CAAC,CAAC,CACN,kBAAU,YAAY,CAAC,MAAM,CAAC,YAC5B,KAAC,IAAI,IAAC,IAAI,EAAE,IAAI,GAAI,GACf,CACR,CAAC,CAAC,CAAC,IAAI,EACR,kBAAU,YAAY,CAAC,OAAO,CAAC,YAAG,QAAQ,GAAQ,IAC7C,CACR,CAAA;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAc;IAClD,OAAO,CACL,KAAC,KAAK,IAAC,IAAI,EAAC,OAAO,EAAC,IAAI,EAAE,IAAI,YAC3B,QAAQ,GACH,CACT,CAAA;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAa;IAChD,OAAO,CACL,KAAC,KAAK,IAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAE,IAAI,YAC1B,QAAQ,GACH,CACT,CAAA;AACH,CAAC","sourcesContent":["/**\n * `Badge` and `Chip` (3.14.0): a short label as text, never an image of text, with an optional decorative icon.\n * Server components. A badge marks a fact (\"Licensed\", \"Fully insured\"); a chip names a filter or a tag, and is the only\n * one a skin may make a pill (Romie, Absolute: \"too many round elements\").\n *\n * Both are rendered once per entry of a list, so their parts take no class (3.14.0 repeated slots): the site styles\n * `[data-bl=\"badge\"]` and `[data-bl=\"chip\"]` once in `src/site/skin.css`.\n */\nimport { Icon, type UiIconName } from '../icons.js'\nimport type { RepeatedSlotOf } from '../repeated-slots.js'\nimport { repeatedSlot, type SkinEntry } from '../skin.js'\n\nexport type BadgeSlot = RepeatedSlotOf<'badge'>\nexport type BadgeSkin = SkinEntry<BadgeSlot, never, Record<never, never>, BadgeSlot>\nexport type ChipSlot = RepeatedSlotOf<'chip'>\nexport type ChipSkin = SkinEntry<ChipSlot, never, Record<never, never>, ChipSlot>\n\nexport interface BadgeProps extends BadgeSkin {\n  /** The label, in the site's words. */\n  readonly children: string\n  /** A decorative icon before the label. */\n  readonly icon?: UiIconName\n}\n\nexport type ChipProps = BadgeProps & ChipSkin\n\nfunction Label({ hook, children, icon }: { hook: 'badge' | 'chip'; children: string; icon?: UiIconName | undefined }) {\n  return (\n    <span data-bl={hook}>\n      {icon ? (\n        <span {...repeatedSlot('icon')}>\n          <Icon name={icon} />\n        </span>\n      ) : null}\n      <span {...repeatedSlot('label')}>{children}</span>\n    </span>\n  )\n}\n\nexport function Badge({ children, icon }: BadgeProps) {\n  return (\n    <Label hook=\"badge\" icon={icon}>\n      {children}\n    </Label>\n  )\n}\n\nexport function Chip({ children, icon }: ChipProps) {\n  return (\n    <Label hook=\"chip\" icon={icon}>\n      {children}\n    </Label>\n  )\n}\n"]}

package/dist/ui-kit/primitives/breadcrumbs.d.ts

@@ -0,0 +1,27 @@
+import type { BreadcrumbItem } from '@brandlab-digital/site-core/breadcrumbs';
+import { type Schema } from '@brandlab-digital/site-core/schema';
+import type { BrandlabRouteBreadcrumbOutput } from '../../breadcrumbs.js';
+import type { RepeatedSlotOf } from '../repeated-slots.js';
+import { type SkinEntry } from '../skin.js';
+export type BreadcrumbsSlot = 'root' | 'list' | 'item' | 'link' | 'current';
+/** Rendered once per crumb: styled from the skin stylesheet, never by class. */
+export type BreadcrumbsRepeatedSlot = RepeatedSlotOf<'breadcrumbs'>;
+export type BreadcrumbsSkin = SkinEntry<BreadcrumbsSlot, never, Record<never, never>, BreadcrumbsRepeatedSlot>;
+/** The breadcrumb landmark's accessible name. Locked. */
+export declare const BREADCRUMBS_LABEL = "Breadcrumb";
+/** A trail with the site's URL, for a page without a route catalogue. */
+export interface BreadcrumbTrail {
+    readonly items: readonly BreadcrumbItem[];
+    /** The site's origin, for example `https://www.aatreeservices.com.au`. */
+    readonly siteUrl: string;
+}
+export interface BreadcrumbsProps extends BreadcrumbsSkin {
+    /** The route lineage's output (`createRouteBreadcrumbOutput`) or a trail with the site's URL. Home first. */
+    readonly trail: BrandlabRouteBreadcrumbOutput | BreadcrumbTrail;
+    /** Opt in to writing the `BreadcrumbList` JSON-LD beside the trail. Off by default: the page's schema builder emits it (F14). */
+    readonly jsonLd?: boolean;
+}
+/** The `BreadcrumbList` for a trail: the route output's own, or one built from the trail and the site's URL. */
+export declare function breadcrumbsSchema(trail: BreadcrumbsProps['trail']): Schema<unknown>;
+export declare function Breadcrumbs({ trail, jsonLd, classes }: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/ui-kit/primitives/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../../src/ui-kit/primitives/breadcrumbs.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAE7E,OAAO,EAA2C,KAAK,MAAM,EAAE,MAAM,oCAAoC,CAAA;AACzG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAA;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;AAC3E,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,aAAa,CAAC,CAAA;AACnE,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,uBAAuB,CAAC,CAAA;AAE9G,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,eAAe,CAAA;AAE7C,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,6GAA6G;IAC7G,QAAQ,CAAC,KAAK,EAAE,6BAA6B,GAAG,eAAe,CAAA;IAC/D,iIAAiI;IACjI,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAMD,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAGnF;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,MAAc,EAAE,OAAO,EAAE,EAAE,gBAAgB,kDA4B/E"}

package/dist/ui-kit/primitives/breadcrumbs.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `Breadcrumbs` (F11, 3.14.0): the visible trail and its `BreadcrumbList` JSON-LD from one source. Server component.
+ * A `nav` named "Breadcrumb" (locked) holding an ordered list; earlier crumbs are links with prefetch off, the current
+ * page is plain text with `aria-current="page"`. The list is lean: no separator elements and no icons, so a long trail
+ * costs a few bytes per crumb. The separator is drawn by `structure.css` (a `/` with empty alternative text), which a
+ * skin may restyle on `[data-bl='breadcrumbs'] [data-slot='item'] + [data-slot='item']::before`.
+ *
+ * Components never write JSON-LD (F14): the page's schema builder emits the `BreadcrumbList`, so `jsonLd` is off by
+ * default. `breadcrumbsSchema(trail)` gives the page the matching schema from the same trail, through the site-core
+ * builders (`buildBreadcrumbListSchema`), either from a route lineage (`createRouteBreadcrumbOutput`, which also checks
+ * the two agree) or from a trail and the site's URL. A page without its own emitter may opt in with `jsonLd`. The
+ * trail is checked either way, so a bad trail fails the build whether or not the JSON-LD is written here.
+ */
+import Link from 'next/link';
+import { getAbsoluteUrl } from '@brandlab-digital/site-core/metadata';
+import { buildBreadcrumbListSchema, createSchema } from '@brandlab-digital/site-core/schema';
+import { SchemaScript } from '../../schema.js';
+import { repeatedSlot, slot } from '../skin.js';
+/** The breadcrumb landmark's accessible name. Locked. */
+export const BREADCRUMBS_LABEL = 'Breadcrumb';
+function isRouteOutput(trail) {
+    return 'schema' in trail;
+}
+/** The `BreadcrumbList` for a trail: the route output's own, or one built from the trail and the site's URL. */
+export function breadcrumbsSchema(trail) {
+    if (isRouteOutput(trail))
+        return trail.schema;
+    return createSchema(buildBreadcrumbListSchema([...trail.items], { absoluteUrl: (path) => getAbsoluteUrl(trail.siteUrl, path) }));
+}
+export function Breadcrumbs({ trail, jsonLd = false, classes }) {
+    const items = trail.items;
+    if (items.length === 0)
+        return null;
+    // Built even when not written, so a trail Google would reject fails here too.
+    const schema = breadcrumbsSchema(trail);
+    const last = items.length - 1;
+    return (_jsxs(_Fragment, { children: [_jsx("nav", { "aria-label": BREADCRUMBS_LABEL, "data-bl": "breadcrumbs", className: classes?.root, children: _jsx("ol", { ...slot(classes, 'list'), children: items.map((item, index) => (_jsx("li", { ...repeatedSlot('item'), children: index < last && item.href ? (_jsx(Link, { href: item.href, prefetch: false, ...repeatedSlot('link'), children: item.name })) : (_jsx("span", { ...repeatedSlot('current'), "aria-current": index === last ? 'page' : undefined, children: item.name })) }, `${item.href ?? 'current'}:${item.name}`))) }) }), jsonLd ? _jsx(SchemaScript, { id: "breadcrumbs", schema: schema }) : null] }));
+}
+//# sourceMappingURL=breadcrumbs.js.map

package/dist/ui-kit/primitives/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../../../src/ui-kit/primitives/breadcrumbs.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AACrE,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAe,MAAM,oCAAoC,CAAA;AAEzG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAkB,MAAM,YAAY,CAAA;AAO/D,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAA;AAgB7C,SAAS,aAAa,CAAC,KAAgC;IACrD,OAAO,QAAQ,IAAI,KAAK,CAAA;AAC1B,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,iBAAiB,CAAC,KAAgC;IAChE,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAA;IAC7C,OAAO,YAAY,CAAC,yBAAyB,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AAClI,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,EAAoB;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,8EAA8E;IAC9E,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7B,OAAO,CACL,8BACE,4BAAiB,iBAAiB,aAAU,aAAa,EAAC,SAAS,EAAE,OAAO,EAAE,IAAI,YAChF,gBAAQ,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,YAC1B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC1B,gBAAuD,YAAY,CAAC,MAAM,CAAC,YACxE,KAAK,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,KAAC,IAAI,IAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,KAAM,YAAY,CAAC,MAAM,CAAC,YAC7D,IAAI,CAAC,IAAI,GACL,CACR,CAAC,CAAC,CAAC,CACF,kBAAU,YAAY,CAAC,SAAS,CAAC,kBAAgB,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YACjF,IAAI,CAAC,IAAI,GACL,CACR,IATM,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAU5C,CACN,CAAC,GACC,GACD,EACL,MAAM,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,EAAE,EAAC,aAAa,EAAC,MAAM,EAAE,MAAM,GAAI,CAAC,CAAC,CAAC,IAAI,IACjE,CACJ,CAAA;AACH,CAAC","sourcesContent":["/**\n * `Breadcrumbs` (F11, 3.14.0): the visible trail and its `BreadcrumbList` JSON-LD from one source. Server component.\n * A `nav` named \"Breadcrumb\" (locked) holding an ordered list; earlier crumbs are links with prefetch off, the current\n * page is plain text with `aria-current=\"page\"`. The list is lean: no separator elements and no icons, so a long trail\n * costs a few bytes per crumb. The separator is drawn by `structure.css` (a `/` with empty alternative text), which a\n * skin may restyle on `[data-bl='breadcrumbs'] [data-slot='item'] + [data-slot='item']::before`.\n *\n * Components never write JSON-LD (F14): the page's schema builder emits the `BreadcrumbList`, so `jsonLd` is off by\n * default. `breadcrumbsSchema(trail)` gives the page the matching schema from the same trail, through the site-core\n * builders (`buildBreadcrumbListSchema`), either from a route lineage (`createRouteBreadcrumbOutput`, which also checks\n * the two agree) or from a trail and the site's URL. A page without its own emitter may opt in with `jsonLd`. The\n * trail is checked either way, so a bad trail fails the build whether or not the JSON-LD is written here.\n */\nimport Link from 'next/link'\nimport type { BreadcrumbItem } from '@brandlab-digital/site-core/breadcrumbs'\nimport { getAbsoluteUrl } from '@brandlab-digital/site-core/metadata'\nimport { buildBreadcrumbListSchema, createSchema, type Schema } from '@brandlab-digital/site-core/schema'\nimport type { BrandlabRouteBreadcrumbOutput } from '../../breadcrumbs.js'\nimport { SchemaScript } from '../../schema.js'\nimport type { RepeatedSlotOf } from '../repeated-slots.js'\nimport { repeatedSlot, slot, type SkinEntry } from '../skin.js'\n\nexport type BreadcrumbsSlot = 'root' | 'list' | 'item' | 'link' | 'current'\n/** Rendered once per crumb: styled from the skin stylesheet, never by class. */\nexport type BreadcrumbsRepeatedSlot = RepeatedSlotOf<'breadcrumbs'>\nexport type BreadcrumbsSkin = SkinEntry<BreadcrumbsSlot, never, Record<never, never>, BreadcrumbsRepeatedSlot>\n\n/** The breadcrumb landmark's accessible name. Locked. */\nexport const BREADCRUMBS_LABEL = 'Breadcrumb'\n\n/** A trail with the site's URL, for a page without a route catalogue. */\nexport interface BreadcrumbTrail {\n  readonly items: readonly BreadcrumbItem[]\n  /** The site's origin, for example `https://www.aatreeservices.com.au`. */\n  readonly siteUrl: string\n}\n\nexport interface BreadcrumbsProps extends BreadcrumbsSkin {\n  /** The route lineage's output (`createRouteBreadcrumbOutput`) or a trail with the site's URL. Home first. */\n  readonly trail: BrandlabRouteBreadcrumbOutput | BreadcrumbTrail\n  /** Opt in to writing the `BreadcrumbList` JSON-LD beside the trail. Off by default: the page's schema builder emits it (F14). */\n  readonly jsonLd?: boolean\n}\n\nfunction isRouteOutput(trail: BreadcrumbsProps['trail']): trail is BrandlabRouteBreadcrumbOutput {\n  return 'schema' in trail\n}\n\n/** The `BreadcrumbList` for a trail: the route output's own, or one built from the trail and the site's URL. */\nexport function breadcrumbsSchema(trail: BreadcrumbsProps['trail']): Schema<unknown> {\n  if (isRouteOutput(trail)) return trail.schema\n  return createSchema(buildBreadcrumbListSchema([...trail.items], { absoluteUrl: (path) => getAbsoluteUrl(trail.siteUrl, path) }))\n}\n\nexport function Breadcrumbs({ trail, jsonLd = false, classes }: BreadcrumbsProps) {\n  const items = trail.items\n  if (items.length === 0) return null\n  // Built even when not written, so a trail Google would reject fails here too.\n  const schema = breadcrumbsSchema(trail)\n  const last = items.length - 1\n  return (\n    <>\n      <nav aria-label={BREADCRUMBS_LABEL} data-bl=\"breadcrumbs\" className={classes?.root}>\n        <ol {...slot(classes, 'list')}>\n          {items.map((item, index) => (\n            <li key={`${item.href ?? 'current'}:${item.name}`} {...repeatedSlot('item')}>\n              {index < last && item.href ? (\n                <Link href={item.href} prefetch={false} {...repeatedSlot('link')}>\n                  {item.name}\n                </Link>\n              ) : (\n                <span {...repeatedSlot('current')} aria-current={index === last ? 'page' : undefined}>\n                  {item.name}\n                </span>\n              )}\n            </li>\n          ))}\n        </ol>\n      </nav>\n      {jsonLd ? <SchemaScript id=\"breadcrumbs\" schema={schema} /> : null}\n    </>\n  )\n}\n"]}