@brandlab-digital/conformance 3.7.0 → 3.9.0

package/dist/site-system/rules/navigation/html.js

@@ -0,0 +1,219 @@
+/**
+ * A small tolerant HTML reader for the rendered rules: it builds an element tree from server HTML so a rule can ask
+ * for "the nav in the header" and read links and text in order. It is not a validating parser; it understands
+ * comments, void elements, raw-text elements, quoted and bare attributes, and the implied end of a list item.
+ */
+const VOID = new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
+const RAW_TEXT = new Set(["script", "style", "textarea", "noscript", "template"]);
+const LIST_BOUNDARY = new Set(["ul", "ol", "menu"]);
+const ENTITIES = {
+    amp: "&",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+    nbsp: " ",
+    ndash: "–",
+    mdash: "—",
+    lsquo: "‘",
+    rsquo: "’",
+    ldquo: "“",
+    rdquo: "”",
+    hellip: "…",
+    middot: "·",
+    rarr: "→",
+};
+export function decodeEntities(value) {
+    return value.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (whole, body) => {
+        if (body.startsWith("#")) {
+            const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
+            return Number.isFinite(code) && code > 0 && code < 0x110000 ? String.fromCodePoint(code) : whole;
+        }
+        return ENTITIES[body.toLowerCase()] ?? whole;
+    });
+}
+function isSpace(char) {
+    return char === " " || char === "\n" || char === "\t" || char === "\r" || char === "\f";
+}
+function readOpenTag(html, start) {
+    let index = start + 1;
+    let name = "";
+    while (index < html.length && !isSpace(html[index]) && html[index] !== "/" && html[index] !== ">") {
+        name += html[index];
+        index += 1;
+    }
+    if (!/^[a-zA-Z][a-zA-Z0-9:-]*$/.test(name))
+        return null;
+    const attrs = {};
+    let selfClosing = false;
+    while (index < html.length) {
+        while (isSpace(html[index]))
+            index += 1;
+        const char = html[index];
+        if (char === undefined)
+            return null;
+        if (char === ">")
+            return { tag: name.toLowerCase(), attrs, selfClosing, end: index + 1 };
+        if (char === "/") {
+            selfClosing = html[index + 1] === ">";
+            index += 1;
+            continue;
+        }
+        let key = "";
+        while (index < html.length && !isSpace(html[index]) && html[index] !== "=" && html[index] !== ">" && html[index] !== "/") {
+            key += html[index];
+            index += 1;
+        }
+        while (isSpace(html[index]))
+            index += 1;
+        let value = "";
+        if (html[index] === "=") {
+            index += 1;
+            while (isSpace(html[index]))
+                index += 1;
+            const quote = html[index];
+            if (quote === '"' || quote === "'") {
+                const close = html.indexOf(quote, index + 1);
+                if (close === -1)
+                    return null;
+                value = html.slice(index + 1, close);
+                index = close + 1;
+            }
+            else {
+                while (index < html.length && !isSpace(html[index]) && html[index] !== ">") {
+                    value += html[index];
+                    index += 1;
+                }
+            }
+        }
+        if (key !== "" && !(key.toLowerCase() in attrs))
+            attrs[key.toLowerCase()] = decodeEntities(value);
+    }
+    return null;
+}
+/** Builds the element tree for a document or fragment. The returned root is a `#document` element. */
+export function parseHtml(html) {
+    const root = { tag: "#document", attrs: {}, children: [], parent: null };
+    let current = root;
+    let index = 0;
+    const addText = (text) => {
+        if (text !== "")
+            current.children.push(text);
+    };
+    while (index < html.length) {
+        const lt = html.indexOf("<", index);
+        if (lt === -1) {
+            addText(decodeEntities(html.slice(index)));
+            break;
+        }
+        if (lt > index)
+            addText(decodeEntities(html.slice(index, lt)));
+        const next = html[lt + 1];
+        if (html.startsWith("<!--", lt)) {
+            const end = html.indexOf("-->", lt + 4);
+            index = end === -1 ? html.length : end + 3;
+            continue;
+        }
+        if (next === "!" || next === "?") {
+            const end = html.indexOf(">", lt);
+            index = end === -1 ? html.length : end + 1;
+            continue;
+        }
+        if (next === "/") {
+            const end = html.indexOf(">", lt);
+            const name = html.slice(lt + 2, end === -1 ? html.length : end).trim().toLowerCase();
+            index = end === -1 ? html.length : end + 1;
+            for (let open = current; open && open !== root; open = open.parent) {
+                if (open.tag === name) {
+                    current = open.parent ?? root;
+                    break;
+                }
+            }
+            continue;
+        }
+        const tag = readOpenTag(html, lt);
+        if (!tag) {
+            addText("<");
+            index = lt + 1;
+            continue;
+        }
+        index = tag.end;
+        if (tag.tag === "li") {
+            // An open list item ends when the next one starts.
+            for (let open = current; open && open !== root && !LIST_BOUNDARY.has(open.tag); open = open.parent) {
+                if (open.tag === "li") {
+                    current = open.parent ?? root;
+                    break;
+                }
+            }
+        }
+        const element = { tag: tag.tag, attrs: tag.attrs, children: [], parent: current };
+        current.children.push(element);
+        if (RAW_TEXT.has(tag.tag) && !tag.selfClosing) {
+            const close = new RegExp(`</${tag.tag}\\s*>`, "i").exec(html.slice(index));
+            index = close ? index + close.index + close[0].length : html.length;
+            continue;
+        }
+        if (VOID.has(tag.tag) || tag.selfClosing)
+            continue;
+        current = element;
+    }
+    return root;
+}
+export function elementChildren(element) {
+    return element.children.filter((child) => typeof child !== "string");
+}
+/** Every descendant element in document order. */
+export function descendants(element) {
+    const found = [];
+    const visit = (node) => {
+        for (const child of node.children) {
+            if (typeof child === "string")
+                continue;
+            found.push(child);
+            visit(child);
+        }
+    };
+    visit(element);
+    return found;
+}
+export function isInside(element, ancestor) {
+    for (let node = element.parent; node; node = node.parent) {
+        if (node === ancestor)
+            return true;
+    }
+    return false;
+}
+export function hasAncestor(element, test) {
+    for (let node = element.parent; node; node = node.parent) {
+        if (test(node))
+            return true;
+    }
+    return false;
+}
+const HIDDEN_TEXT_CLASS = /(^|\s)(sr-only|visually-hidden|screen-reader-text)(\s|$)/;
+/** The visible text of an element: no SVG, no screen-reader-only text, no hidden or aria-hidden parts. */
+export function textOf(element) {
+    const parts = [];
+    const visit = (node) => {
+        for (const child of node.children) {
+            if (typeof child === "string") {
+                parts.push(child);
+                continue;
+            }
+            if (child.tag === "svg" || child.tag === "br") {
+                if (child.tag === "br")
+                    parts.push(" ");
+                continue;
+            }
+            if ("hidden" in child.attrs || child.attrs["aria-hidden"] === "true" || HIDDEN_TEXT_CLASS.test(child.attrs.class ?? ""))
+                continue;
+            parts.push(" ");
+            visit(child);
+            parts.push(" ");
+        }
+    };
+    visit(element);
+    return parts.join("").replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=html.js.map

package/dist/site-system/rules/navigation/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/html.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A small tolerant HTML reader for the rendered rules: it builds an element tree from server HTML so a rule can ask\n * for \"the nav in the header\" and read links and text in order. It is not a validating parser; it understands\n * comments, void elements, raw-text elements, quoted and bare attributes, and the implied end of a list item.\n */\n\nexport interface HtmlElement {\n  readonly tag: string;\n  readonly attrs: Readonly<Record<string, string>>;\n  readonly children: HtmlChild[];\n  readonly parent: HtmlElement | null;\n}\n\nexport type HtmlChild = HtmlElement | string;\n\nconst VOID = new Set([\"area\", \"base\", \"br\", \"col\", \"embed\", \"hr\", \"img\", \"input\", \"link\", \"meta\", \"param\", \"source\", \"track\", \"wbr\"]);\nconst RAW_TEXT = new Set([\"script\", \"style\", \"textarea\", \"noscript\", \"template\"]);\nconst LIST_BOUNDARY = new Set([\"ul\", \"ol\", \"menu\"]);\n\nconst ENTITIES: Readonly<Record<string, string>> = {\n  amp: \"&\",\n  lt: \"<\",\n  gt: \">\",\n  quot: '\"',\n  apos: \"'\",\n  nbsp: \" \",\n  ndash: \"–\",\n  mdash: \"—\",\n  lsquo: \"‘\",\n  rsquo: \"’\",\n  ldquo: \"“\",\n  rdquo: \"”\",\n  hellip: \"…\",\n  middot: \"·\",\n  rarr: \"→\",\n};\n\nexport function decodeEntities(value: string): string {\n  return value.replace(/&(#x[0-9a-f]+|#\\d+|[a-z]+);/gi, (whole, body: string) => {\n    if (body.startsWith(\"#\")) {\n      const code = body[1] === \"x\" || body[1] === \"X\" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);\n      return Number.isFinite(code) && code > 0 && code < 0x110000 ? String.fromCodePoint(code) : whole;\n    }\n    return ENTITIES[body.toLowerCase()] ?? whole;\n  });\n}\n\nfunction isSpace(char: string | undefined): boolean {\n  return char === \" \" || char === \"\\n\" || char === \"\\t\" || char === \"\\r\" || char === \"\\f\";\n}\n\ninterface OpenTag {\n  readonly tag: string;\n  readonly attrs: Record<string, string>;\n  readonly selfClosing: boolean;\n  /** The index just after the closing `>`. */\n  readonly end: number;\n}\n\nfunction readOpenTag(html: string, start: number): OpenTag | null {\n  let index = start + 1;\n  let name = \"\";\n  while (index < html.length && !isSpace(html[index]) && html[index] !== \"/\" && html[index] !== \">\") {\n    name += html[index];\n    index += 1;\n  }\n  if (!/^[a-zA-Z][a-zA-Z0-9:-]*$/.test(name)) return null;\n  const attrs: Record<string, string> = {};\n  let selfClosing = false;\n  while (index < html.length) {\n    while (isSpace(html[index])) index += 1;\n    const char = html[index];\n    if (char === undefined) return null;\n    if (char === \">\") return { tag: name.toLowerCase(), attrs, selfClosing, end: index + 1 };\n    if (char === \"/\") {\n      selfClosing = html[index + 1] === \">\";\n      index += 1;\n      continue;\n    }\n    let key = \"\";\n    while (index < html.length && !isSpace(html[index]) && html[index] !== \"=\" && html[index] !== \">\" && html[index] !== \"/\") {\n      key += html[index];\n      index += 1;\n    }\n    while (isSpace(html[index])) index += 1;\n    let value = \"\";\n    if (html[index] === \"=\") {\n      index += 1;\n      while (isSpace(html[index])) index += 1;\n      const quote = html[index];\n      if (quote === '\"' || quote === \"'\") {\n        const close = html.indexOf(quote, index + 1);\n        if (close === -1) return null;\n        value = html.slice(index + 1, close);\n        index = close + 1;\n      } else {\n        while (index < html.length && !isSpace(html[index]) && html[index] !== \">\") {\n          value += html[index];\n          index += 1;\n        }\n      }\n    }\n    if (key !== \"\" && !(key.toLowerCase() in attrs)) attrs[key.toLowerCase()] = decodeEntities(value);\n  }\n  return null;\n}\n\n/** Builds the element tree for a document or fragment. The returned root is a `#document` element. */\nexport function parseHtml(html: string): HtmlElement {\n  const root: HtmlElement = { tag: \"#document\", attrs: {}, children: [], parent: null };\n  let current = root;\n  let index = 0;\n  const addText = (text: string) => {\n    if (text !== \"\") current.children.push(text);\n  };\n  while (index < html.length) {\n    const lt = html.indexOf(\"<\", index);\n    if (lt === -1) {\n      addText(decodeEntities(html.slice(index)));\n      break;\n    }\n    if (lt > index) addText(decodeEntities(html.slice(index, lt)));\n    const next = html[lt + 1];\n    if (html.startsWith(\"<!--\", lt)) {\n      const end = html.indexOf(\"-->\", lt + 4);\n      index = end === -1 ? html.length : end + 3;\n      continue;\n    }\n    if (next === \"!\" || next === \"?\") {\n      const end = html.indexOf(\">\", lt);\n      index = end === -1 ? html.length : end + 1;\n      continue;\n    }\n    if (next === \"/\") {\n      const end = html.indexOf(\">\", lt);\n      const name = html.slice(lt + 2, end === -1 ? html.length : end).trim().toLowerCase();\n      index = end === -1 ? html.length : end + 1;\n      for (let open: HtmlElement | null = current; open && open !== root; open = open.parent) {\n        if (open.tag === name) {\n          current = open.parent ?? root;\n          break;\n        }\n      }\n      continue;\n    }\n    const tag = readOpenTag(html, lt);\n    if (!tag) {\n      addText(\"<\");\n      index = lt + 1;\n      continue;\n    }\n    index = tag.end;\n    if (tag.tag === \"li\") {\n      // An open list item ends when the next one starts.\n      for (let open: HtmlElement | null = current; open && open !== root && !LIST_BOUNDARY.has(open.tag); open = open.parent) {\n        if (open.tag === \"li\") {\n          current = open.parent ?? root;\n          break;\n        }\n      }\n    }\n    const element: HtmlElement = { tag: tag.tag, attrs: tag.attrs, children: [], parent: current };\n    current.children.push(element);\n    if (RAW_TEXT.has(tag.tag) && !tag.selfClosing) {\n      const close = new RegExp(`</${tag.tag}\\\\s*>`, \"i\").exec(html.slice(index));\n      index = close ? index + close.index + close[0].length : html.length;\n      continue;\n    }\n    if (VOID.has(tag.tag) || tag.selfClosing) continue;\n    current = element;\n  }\n  return root;\n}\n\nexport function elementChildren(element: HtmlElement): HtmlElement[] {\n  return element.children.filter((child): child is HtmlElement => typeof child !== \"string\");\n}\n\n/** Every descendant element in document order. */\nexport function descendants(element: HtmlElement): HtmlElement[] {\n  const found: HtmlElement[] = [];\n  const visit = (node: HtmlElement) => {\n    for (const child of node.children) {\n      if (typeof child === \"string\") continue;\n      found.push(child);\n      visit(child);\n    }\n  };\n  visit(element);\n  return found;\n}\n\nexport function isInside(element: HtmlElement, ancestor: HtmlElement): boolean {\n  for (let node: HtmlElement | null = element.parent; node; node = node.parent) {\n    if (node === ancestor) return true;\n  }\n  return false;\n}\n\nexport function hasAncestor(element: HtmlElement, test: (ancestor: HtmlElement) => boolean): boolean {\n  for (let node: HtmlElement | null = element.parent; node; node = node.parent) {\n    if (test(node)) return true;\n  }\n  return false;\n}\n\nconst HIDDEN_TEXT_CLASS = /(^|\\s)(sr-only|visually-hidden|screen-reader-text)(\\s|$)/;\n\n/** The visible text of an element: no SVG, no screen-reader-only text, no hidden or aria-hidden parts. */\nexport function textOf(element: HtmlElement): string {\n  const parts: string[] = [];\n  const visit = (node: HtmlElement) => {\n    for (const child of node.children) {\n      if (typeof child === \"string\") {\n        parts.push(child);\n        continue;\n      }\n      if (child.tag === \"svg\" || child.tag === \"br\") {\n        if (child.tag === \"br\") parts.push(\" \");\n        continue;\n      }\n      if (\"hidden\" in child.attrs || child.attrs[\"aria-hidden\"] === \"true\" || HIDDEN_TEXT_CLASS.test(child.attrs.class ?? \"\")) continue;\n      parts.push(\" \");\n      visit(child);\n      parts.push(\" \");\n    }\n  };\n  visit(element);\n  return parts.join(\"\").replace(/\\s+/g, \" \").trim();\n}\n"]}

package/dist/site-system/rules/navigation/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * N1, the rendered side: the header menu on the home page must satisfy the same rules as `defineBrandlabNavigation`
+ * (required links when their pages exist, About in the first two items, services before Areas, Contact last, labels
+ * from the closed list, every dropdown holding its hub link, no prices, split mode, a recorded order kept exactly).
+ * It reads the `<nav aria-label="Main">` in the `<header>`, so it works on the ui-kit header and on bespoke ones.
+ *
+ * The rules themselves live in `@brandlab-digital/site-core/navigation` and are read at run time, like the other
+ * site-core modules, so this package compiles without a site-core build and checks against the site's own copy.
+ *
+ * Which pages exist is read from the pages supplied and from the links on every one of them outside its own main menu
+ * (a page the footer links to exists). Money-service dropdowns are read from the header itself. What Romie recorded
+ * (an exact order, labels, an Areas dropdown) comes from `navigation` in `src/data/strategy.ts`.
+ */
+import type { SiteSystemFinding } from "../../checks.js";
+export interface NavigationRulesInput {
+    baseUrl: string;
+    pages: readonly {
+        path: string;
+        html: string;
+    }[];
+    projectRoot: string;
+}
+/**
+ * Applies N1 to the header menu on the home page. `recorded` is the `navigation` of the site's strategy record;
+ * `runNavigationRules` reads it from `src/data/strategy.ts` for you.
+ */
+export declare function checkRenderedNavigation(input: {
+    baseUrl: string;
+    pages: readonly {
+        path: string;
+        html: string;
+    }[];
+    recorded?: Record<string, unknown>;
+}): Promise<SiteSystemFinding[]>;
+/** The N1 rendered rule, in the shape the ready gate's rendered runners share. */
+export declare function runNavigationRules(input: NavigationRulesInput): Promise<readonly SiteSystemFinding[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/site-system/rules/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AASzD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAgHD;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA4D/B;AAED,kFAAkF;AAClF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAI3G"}

package/dist/site-system/rules/navigation/index.js

@@ -0,0 +1,163 @@
+import { extractMainNavigation, headerActions, linkedPaths, findMainNav } from "./extract.js";
+import { parseHtml } from "./html.js";
+import { readRecordedNavigation } from "./record.js";
+const NAVIGATION_MODULE = "@brandlab-digital/site-core/navigation";
+let siteCoreNavigation;
+function loadSiteCoreNavigation() {
+    siteCoreNavigation ??= import(NAVIGATION_MODULE).then((module) => {
+        if (typeof module.validateBrandlabNavigation !== "function" ||
+            typeof module.navigationPagesFromRoutes !== "function" ||
+            !module.BRANDLAB_NAV_PAGE_ALIASES ||
+            !module.BRANDLAB_NAV_LABELS) {
+            throw new Error("@brandlab-digital/site-core/navigation has no validateBrandlabNavigation: install site-core 3.9.0 or later with the conformance package.");
+        }
+        return module;
+    });
+    return siteCoreNavigation;
+}
+function finding(status, target, message) {
+    return { checkId: "N1", status, ...(target === undefined ? {} : { target }), message };
+}
+function canonical(path) {
+    const [beforeHash = ""] = path.split("#");
+    const [beforeQuery = ""] = beforeHash.split("?");
+    const trimmed = beforeQuery.length > 1 ? beforeQuery.replace(/\/+$/, "") : beforeQuery;
+    return (trimmed || "/").toLowerCase();
+}
+function asList(value) {
+    return value === undefined ? [] : typeof value === "string" ? [value] : [...value];
+}
+/** The page each dropdown label is the hub of, for a label that is a button rather than a link. */
+const HUB_PAGES = {
+    services: ["services"],
+    "more services": ["services"],
+    areas: ["areas"],
+    "our work": ["projects", "gallery"],
+    projects: ["projects"],
+    gallery: ["gallery"],
+    resources: ["guides", "faqs"],
+    guides: ["guides"],
+    blog: ["guides"],
+    about: ["about"],
+    faqs: ["faqs"],
+    contact: ["contact"],
+};
+/** A dropdown whose label is a button has no hub of its own; its hub is the panel link to the page the label names. */
+function withHubs(items, pages) {
+    return items.map((item) => {
+        if (item.kind !== "menu" || item.href !== "")
+            return item;
+        const wanted = (HUB_PAGES[item.label.toLowerCase()] ?? []).flatMap((key) => asList(pages[key])).map(canonical);
+        const hub = item.links.find((link) => wanted.includes(canonical(link.href)));
+        return hub ? { ...item, href: hub.href, hubLabel: hub.label, links: item.links.filter((link) => link !== hub) } : item;
+    });
+}
+/**
+ * The money services the header itself shows. A dropdown is a money-service dropdown when its label is not a closed
+ * label, its hub is a page of its own (not the services hub or any other page the menu names) and its panel holds two
+ * or more links besides the hub. Plain links under the services hub count as money services without sub-services.
+ * None are inferred when the header has the one combined Services dropdown, which is not split mode.
+ */
+function inferMoneyServices(items, pages, closedLabels) {
+    const named = new Set(Object.values(pages).flatMap(asList).map(canonical));
+    const servicesHubs = asList(pages["services"]).map(canonical);
+    const combined = items.some((item) => servicesHubs.includes(canonical(item.href)) && item.label !== "More services");
+    if (combined)
+        return [];
+    const found = [];
+    for (const item of items) {
+        if (closedLabels.includes(item.label) || !item.href.startsWith("/"))
+            continue;
+        const hub = canonical(item.href);
+        const underServices = servicesHubs.some((root) => hub.startsWith(`${root}/`));
+        if (item.kind === "menu" && !named.has(hub) && item.links.length >= 2) {
+            found.push({ label: item.label, href: item.href, subServices: item.links.length });
+        }
+        else if (underServices) {
+            found.push({ label: item.label, href: item.href, subServices: item.kind === "menu" ? item.links.length : 0 });
+        }
+    }
+    return found;
+}
+const ALWAYS_REQUIRED = [
+    { key: "about", labels: ["About"] },
+    { key: "services", labels: ["Services", "More services"] },
+    { key: "contact", labels: ["Contact"] },
+];
+/**
+ * Applies N1 to the header menu on the home page. `recorded` is the `navigation` of the site's strategy record;
+ * `runNavigationRules` reads it from `src/data/strategy.ts` for you.
+ */
+export async function checkRenderedNavigation(input) {
+    const home = input.pages.find((page) => canonical(page.path) === "/");
+    if (!home)
+        return [finding("fail", undefined, "N1 could not run: the home page was not supplied, and the header menu is read from it.")];
+    let core;
+    try {
+        core = await loadSiteCoreNavigation();
+    }
+    catch (error) {
+        return [finding("fail", "/", error instanceof Error ? error.message : String(error))];
+    }
+    const extracted = extractMainNavigation(home.html, input.baseUrl);
+    if (!extracted) {
+        return [finding("fail", "/", 'The header on / has no <nav aria-label="Main">, so N1 cannot read the menu.')];
+    }
+    if (extracted.items.length === 0) {
+        return [finding("fail", "/", "The main navigation on the home page has no links in the server HTML.")];
+    }
+    // Which pages exist: the pages supplied, and every link on any of them outside its own main menu.
+    const evidence = new Set(input.pages.map((page) => canonical(page.path)));
+    for (const page of input.pages) {
+        const root = page === home ? extracted.root : parseHtml(page.html);
+        for (const path of linkedPaths(root, input.baseUrl, page === home ? extracted.nav : findMainNav(root)))
+            evidence.add(canonical(path));
+    }
+    for (const aliases of Object.values(core.BRANDLAB_NAV_PAGE_ALIASES)) {
+        for (const alias of aliases) {
+            if ([...evidence].some((path) => path.startsWith(`${alias}/`)))
+                evidence.add(alias);
+        }
+    }
+    const pages = core.navigationPagesFromRoutes([...evidence].map((path) => ({ path })));
+    // About, Services and Contact are always required; a hub at an unusual path is read from the menu item that names it.
+    for (const { key, labels } of ALWAYS_REQUIRED) {
+        if ((core.BRANDLAB_NAV_PAGE_ALIASES[key] ?? []).some((alias) => evidence.has(alias)))
+            continue;
+        const named = extracted.items.find((item) => labels.includes(item.label));
+        if (named?.href.startsWith("/"))
+            pages[key] = [canonical(named.href)];
+    }
+    const items = withHubs(extracted.items, pages);
+    const moneyServices = inferMoneyServices(items, pages, core.BRANDLAB_NAV_LABELS);
+    const recorded = input.recorded;
+    // Panel shapes are the library's; a header built by hand has its own. Whether a site has both a gallery and
+    // projects can't be known from the pages supplied. Whether Areas is a dropdown is only enforced where recorded.
+    const skip = ["panel", "proof-label"];
+    if (recorded?.["areas"] === undefined)
+        skip.push("areas-mode");
+    const context = {
+        pages,
+        ...(moneyServices.length > 0 ? { moneyServices } : {}),
+        ...(recorded ? { recorded } : {}),
+    };
+    const problems = core.validateBrandlabNavigation({ items }, context, { skip }).map((problem) => `Header menu on /: ${problem.message}`);
+    // The phone and the quote button sit in the header beside the menu; they are required links but not menu items.
+    const actions = headerActions(extracted.header);
+    if (!actions.phone)
+        problems.push("The header on / has no phone link (tel:); the phone sits beside the quote button in the header.");
+    if (!actions.quote)
+        problems.push("The header on / has no quote button; it sits beside the phone in the header.");
+    if (problems.length === 0) {
+        return [finding("pass", "/", `The header menu on / passes N1 (${items.length} items: ${items.map((item) => item.label).join(", ")}).`)];
+    }
+    return problems.map((problem) => finding("fail", "/", problem));
+}
+/** The N1 rendered rule, in the shape the ready gate's rendered runners share. */
+export async function runNavigationRules(input) {
+    const { recorded, problem } = readRecordedNavigation(input.projectRoot);
+    if (problem)
+        return [finding("fail", "src/data/strategy.ts", problem)];
+    return checkRenderedNavigation({ baseUrl: input.baseUrl, pages: input.pages, ...(recorded ? { recorded } : {}) });
+}
+//# sourceMappingURL=index.js.map

package/dist/site-system/rules/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * N1, the rendered side: the header menu on the home page must satisfy the same rules as `defineBrandlabNavigation`\n * (required links when their pages exist, About in the first two items, services before Areas, Contact last, labels\n * from the closed list, every dropdown holding its hub link, no prices, split mode, a recorded order kept exactly).\n * It reads the `<nav aria-label=\"Main\">` in the `<header>`, so it works on the ui-kit header and on bespoke ones.\n *\n * The rules themselves live in `@brandlab-digital/site-core/navigation` and are read at run time, like the other\n * site-core modules, so this package compiles without a site-core build and checks against the site's own copy.\n *\n * Which pages exist is read from the pages supplied and from the links on every one of them outside its own main menu\n * (a page the footer links to exists). Money-service dropdowns are read from the header itself. What Romie recorded\n * (an exact order, labels, an Areas dropdown) comes from `navigation` in `src/data/strategy.ts`.\n */\nimport type { SiteSystemFinding } from \"../../checks.js\";\nimport { extractMainNavigation, headerActions, linkedPaths, findMainNav, type NavigationItemLike } from \"./extract.js\";\nimport { parseHtml } from \"./html.js\";\nimport { readRecordedNavigation } from \"./record.js\";\n\nconst NAVIGATION_MODULE: string = \"@brandlab-digital/site-core/navigation\";\n\ntype PageValue = string | readonly string[];\n\nexport interface NavigationRulesInput {\n  baseUrl: string;\n  pages: readonly { path: string; html: string }[];\n  projectRoot: string;\n}\n\ninterface SiteCoreFinding {\n  rule: string;\n  message: string;\n  item?: string;\n}\n\ninterface SiteCoreNavigation {\n  validateBrandlabNavigation(\n    nav: { items: readonly NavigationItemLike[] },\n    context: Record<string, unknown>,\n    options?: { skip?: readonly string[] },\n  ): readonly SiteCoreFinding[];\n  navigationPagesFromRoutes(routes: readonly { path: string; kind?: string }[]): Record<string, PageValue | undefined>;\n  BRANDLAB_NAV_PAGE_ALIASES: Readonly<Record<string, readonly string[]>>;\n  BRANDLAB_NAV_LABELS: readonly string[];\n}\n\nlet siteCoreNavigation: Promise<SiteCoreNavigation> | undefined;\n\nfunction loadSiteCoreNavigation(): Promise<SiteCoreNavigation> {\n  siteCoreNavigation ??= (import(NAVIGATION_MODULE) as Promise<Partial<SiteCoreNavigation>>).then((module) => {\n    if (\n      typeof module.validateBrandlabNavigation !== \"function\" ||\n      typeof module.navigationPagesFromRoutes !== \"function\" ||\n      !module.BRANDLAB_NAV_PAGE_ALIASES ||\n      !module.BRANDLAB_NAV_LABELS\n    ) {\n      throw new Error(\"@brandlab-digital/site-core/navigation has no validateBrandlabNavigation: install site-core 3.9.0 or later with the conformance package.\");\n    }\n    return module as SiteCoreNavigation;\n  });\n  return siteCoreNavigation;\n}\n\nfunction finding(status: SiteSystemFinding[\"status\"], target: string | undefined, message: string): SiteSystemFinding {\n  return { checkId: \"N1\", status, ...(target === undefined ? {} : { target }), message };\n}\n\nfunction canonical(path: string): string {\n  const [beforeHash = \"\"] = path.split(\"#\");\n  const [beforeQuery = \"\"] = beforeHash.split(\"?\");\n  const trimmed = beforeQuery.length > 1 ? beforeQuery.replace(/\\/+$/, \"\") : beforeQuery;\n  return (trimmed || \"/\").toLowerCase();\n}\n\nfunction asList(value: PageValue | undefined): string[] {\n  return value === undefined ? [] : typeof value === \"string\" ? [value] : [...value];\n}\n\n/** The page each dropdown label is the hub of, for a label that is a button rather than a link. */\nconst HUB_PAGES: Readonly<Record<string, readonly string[]>> = {\n  services: [\"services\"],\n  \"more services\": [\"services\"],\n  areas: [\"areas\"],\n  \"our work\": [\"projects\", \"gallery\"],\n  projects: [\"projects\"],\n  gallery: [\"gallery\"],\n  resources: [\"guides\", \"faqs\"],\n  guides: [\"guides\"],\n  blog: [\"guides\"],\n  about: [\"about\"],\n  faqs: [\"faqs\"],\n  contact: [\"contact\"],\n};\n\n/** A dropdown whose label is a button has no hub of its own; its hub is the panel link to the page the label names. */\nfunction withHubs(items: readonly NavigationItemLike[], pages: Record<string, PageValue | undefined>): NavigationItemLike[] {\n  return items.map((item) => {\n    if (item.kind !== \"menu\" || item.href !== \"\") return item;\n    const wanted = (HUB_PAGES[item.label.toLowerCase()] ?? []).flatMap((key) => asList(pages[key])).map(canonical);\n    const hub = item.links.find((link) => wanted.includes(canonical(link.href)));\n    return hub ? { ...item, href: hub.href, hubLabel: hub.label, links: item.links.filter((link) => link !== hub) } : item;\n  });\n}\n\n/**\n * The money services the header itself shows. A dropdown is a money-service dropdown when its label is not a closed\n * label, its hub is a page of its own (not the services hub or any other page the menu names) and its panel holds two\n * or more links besides the hub. Plain links under the services hub count as money services without sub-services.\n * None are inferred when the header has the one combined Services dropdown, which is not split mode.\n */\nfunction inferMoneyServices(\n  items: readonly NavigationItemLike[],\n  pages: Record<string, PageValue | undefined>,\n  closedLabels: readonly string[],\n): { label: string; href: string; subServices: number }[] {\n  const named = new Set(Object.values(pages).flatMap(asList).map(canonical));\n  const servicesHubs = asList(pages[\"services\"]).map(canonical);\n  const combined = items.some((item) => servicesHubs.includes(canonical(item.href)) && item.label !== \"More services\");\n  if (combined) return [];\n  const found: { label: string; href: string; subServices: number }[] = [];\n  for (const item of items) {\n    if (closedLabels.includes(item.label) || !item.href.startsWith(\"/\")) continue;\n    const hub = canonical(item.href);\n    const underServices = servicesHubs.some((root) => hub.startsWith(`${root}/`));\n    if (item.kind === \"menu\" && !named.has(hub) && item.links.length >= 2) {\n      found.push({ label: item.label, href: item.href, subServices: item.links.length });\n    } else if (underServices) {\n      found.push({ label: item.label, href: item.href, subServices: item.kind === \"menu\" ? item.links.length : 0 });\n    }\n  }\n  return found;\n}\n\nconst ALWAYS_REQUIRED = [\n  { key: \"about\", labels: [\"About\"] },\n  { key: \"services\", labels: [\"Services\", \"More services\"] },\n  { key: \"contact\", labels: [\"Contact\"] },\n] as const;\n\n/**\n * Applies N1 to the header menu on the home page. `recorded` is the `navigation` of the site's strategy record;\n * `runNavigationRules` reads it from `src/data/strategy.ts` for you.\n */\nexport async function checkRenderedNavigation(input: {\n  baseUrl: string;\n  pages: readonly { path: string; html: string }[];\n  recorded?: Record<string, unknown>;\n}): Promise<SiteSystemFinding[]> {\n  const home = input.pages.find((page) => canonical(page.path) === \"/\");\n  if (!home) return [finding(\"fail\", undefined, \"N1 could not run: the home page was not supplied, and the header menu is read from it.\")];\n\n  let core: SiteCoreNavigation;\n  try {\n    core = await loadSiteCoreNavigation();\n  } catch (error) {\n    return [finding(\"fail\", \"/\", error instanceof Error ? error.message : String(error))];\n  }\n\n  const extracted = extractMainNavigation(home.html, input.baseUrl);\n  if (!extracted) {\n    return [finding(\"fail\", \"/\", 'The header on / has no <nav aria-label=\"Main\">, so N1 cannot read the menu.')];\n  }\n  if (extracted.items.length === 0) {\n    return [finding(\"fail\", \"/\", \"The main navigation on the home page has no links in the server HTML.\")];\n  }\n\n  // Which pages exist: the pages supplied, and every link on any of them outside its own main menu.\n  const evidence = new Set<string>(input.pages.map((page) => canonical(page.path)));\n  for (const page of input.pages) {\n    const root = page === home ? extracted.root : parseHtml(page.html);\n    for (const path of linkedPaths(root, input.baseUrl, page === home ? extracted.nav : findMainNav(root))) evidence.add(canonical(path));\n  }\n  for (const aliases of Object.values(core.BRANDLAB_NAV_PAGE_ALIASES)) {\n    for (const alias of aliases) {\n      if ([...evidence].some((path) => path.startsWith(`${alias}/`))) evidence.add(alias);\n    }\n  }\n  const pages: Record<string, PageValue | undefined> = core.navigationPagesFromRoutes([...evidence].map((path) => ({ path })));\n  // About, Services and Contact are always required; a hub at an unusual path is read from the menu item that names it.\n  for (const { key, labels } of ALWAYS_REQUIRED) {\n    if ((core.BRANDLAB_NAV_PAGE_ALIASES[key] ?? []).some((alias) => evidence.has(alias))) continue;\n    const named = extracted.items.find((item) => (labels as readonly string[]).includes(item.label));\n    if (named?.href.startsWith(\"/\")) pages[key] = [canonical(named.href)];\n  }\n\n  const items = withHubs(extracted.items, pages);\n  const moneyServices = inferMoneyServices(items, pages, core.BRANDLAB_NAV_LABELS);\n  const recorded = input.recorded;\n  // Panel shapes are the library's; a header built by hand has its own. Whether a site has both a gallery and\n  // projects can't be known from the pages supplied. Whether Areas is a dropdown is only enforced where recorded.\n  const skip = [\"panel\", \"proof-label\"];\n  if (recorded?.[\"areas\"] === undefined) skip.push(\"areas-mode\");\n  const context: Record<string, unknown> = {\n    pages,\n    ...(moneyServices.length > 0 ? { moneyServices } : {}),\n    ...(recorded ? { recorded } : {}),\n  };\n\n  const problems = core.validateBrandlabNavigation({ items }, context, { skip }).map((problem) => `Header menu on /: ${problem.message}`);\n  // The phone and the quote button sit in the header beside the menu; they are required links but not menu items.\n  const actions = headerActions(extracted.header);\n  if (!actions.phone) problems.push(\"The header on / has no phone link (tel:); the phone sits beside the quote button in the header.\");\n  if (!actions.quote) problems.push(\"The header on / has no quote button; it sits beside the phone in the header.\");\n  if (problems.length === 0) {\n    return [finding(\"pass\", \"/\", `The header menu on / passes N1 (${items.length} items: ${items.map((item) => item.label).join(\", \")}).`)];\n  }\n  return problems.map((problem) => finding(\"fail\", \"/\", problem));\n}\n\n/** The N1 rendered rule, in the shape the ready gate's rendered runners share. */\nexport async function runNavigationRules(input: NavigationRulesInput): Promise<readonly SiteSystemFinding[]> {\n  const { recorded, problem } = readRecordedNavigation(input.projectRoot);\n  if (problem) return [finding(\"fail\", \"src/data/strategy.ts\", problem)];\n  return checkRenderedNavigation({ baseUrl: input.baseUrl, pages: input.pages, ...(recorded ? { recorded } : {}) });\n}\n"]}

package/dist/site-system/rules/navigation/record.d.ts

@@ -0,0 +1,8 @@
+export interface RecordedNavigationRead {
+    /** The recorded menu as plain data; absent when the strategy records none. */
+    recorded?: Record<string, unknown>;
+    /** Why a recorded menu could not be read. */
+    problem?: string;
+}
+export declare function readRecordedNavigation(projectRoot: string): RecordedNavigationRead;
+//# sourceMappingURL=record.d.ts.map

package/dist/site-system/rules/navigation/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/record.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAgBlF"}

package/dist/site-system/rules/navigation/record.js

@@ -0,0 +1,39 @@
+/**
+ * What Romie recorded for the menu: the `navigation` of `defineSiteStrategy` in `src/data/strategy.ts` (an exact
+ * order, labels outside the closed list, whether Areas is a dropdown). It is read as plain data with the same literal
+ * reader the other strategy checks use, so the site never has to run.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import ts from "typescript";
+import { D4_STRATEGY_FILE } from "../design/d4-distinctness.js";
+import { isFullyResolved, isLiteralObject, LiteralReader } from "../enquiry/literal.js";
+function propertyKey(name) {
+    return ts.isIdentifier(name) || ts.isStringLiteralLike(name) ? name.text : undefined;
+}
+export function readRecordedNavigation(projectRoot) {
+    const file = join(projectRoot, D4_STRATEGY_FILE);
+    if (!existsSync(file))
+        return {};
+    const reader = new LiteralReader(readFileSync(file, "utf8"), D4_STRATEGY_FILE);
+    const argument = reader.callArguments("defineSiteStrategy")[0] ?? reader.constant("strategy");
+    // A strategy that is not a literal is reported by check D4; there is nothing for N1 to add.
+    if (!argument || !ts.isObjectLiteralExpression(argument))
+        return {};
+    for (const property of argument.properties) {
+        if (ts.isPropertyAssignment(property) && propertyKey(property.name) === "navigation") {
+            return readValue(reader.evaluate(property.initializer));
+        }
+        if (ts.isShorthandPropertyAssignment(property) && property.name.text === "navigation") {
+            return readValue(reader.evaluate(property.name));
+        }
+    }
+    return {};
+}
+function readValue(value) {
+    if (!isLiteralObject(value) || !isFullyResolved(value)) {
+        return { problem: `${D4_STRATEGY_FILE} records a navigation that is not plain data, so N1 cannot read it; write it as a literal.` };
+    }
+    return { recorded: value };
+}
+//# sourceMappingURL=record.js.map

package/dist/site-system/rules/navigation/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../src/site-system/rules/navigation/record.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AASxF,SAAS,WAAW,CAAC,IAAqB;IACxC,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9F,4FAA4F;IAC5F,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACpE,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3C,IAAI,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,YAAY,EAAE,CAAC;YACrF,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,EAAE,CAAC,6BAA6B,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACtF,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,SAAS,CAAC,KAA4C;IAC7D,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,GAAG,gBAAgB,4FAA4F,EAAE,CAAC;IACtI,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAgC,EAAE,CAAC;AACxD,CAAC","sourcesContent":["/**\n * What Romie recorded for the menu: the `navigation` of `defineSiteStrategy` in `src/data/strategy.ts` (an exact\n * order, labels outside the closed list, whether Areas is a dropdown). It is read as plain data with the same literal\n * reader the other strategy checks use, so the site never has to run.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport ts from \"typescript\";\nimport { D4_STRATEGY_FILE } from \"../design/d4-distinctness.js\";\nimport { isFullyResolved, isLiteralObject, LiteralReader } from \"../enquiry/literal.js\";\n\nexport interface RecordedNavigationRead {\n  /** The recorded menu as plain data; absent when the strategy records none. */\n  recorded?: Record<string, unknown>;\n  /** Why a recorded menu could not be read. */\n  problem?: string;\n}\n\nfunction propertyKey(name: ts.PropertyName): string | undefined {\n  return ts.isIdentifier(name) || ts.isStringLiteralLike(name) ? name.text : undefined;\n}\n\nexport function readRecordedNavigation(projectRoot: string): RecordedNavigationRead {\n  const file = join(projectRoot, D4_STRATEGY_FILE);\n  if (!existsSync(file)) return {};\n  const reader = new LiteralReader(readFileSync(file, \"utf8\"), D4_STRATEGY_FILE);\n  const argument = reader.callArguments(\"defineSiteStrategy\")[0] ?? reader.constant(\"strategy\");\n  // A strategy that is not a literal is reported by check D4; there is nothing for N1 to add.\n  if (!argument || !ts.isObjectLiteralExpression(argument)) return {};\n  for (const property of argument.properties) {\n    if (ts.isPropertyAssignment(property) && propertyKey(property.name) === \"navigation\") {\n      return readValue(reader.evaluate(property.initializer));\n    }\n    if (ts.isShorthandPropertyAssignment(property) && property.name.text === \"navigation\") {\n      return readValue(reader.evaluate(property.name));\n    }\n  }\n  return {};\n}\n\nfunction readValue(value: ReturnType<LiteralReader[\"evaluate\"]>): RecordedNavigationRead {\n  if (!isLiteralObject(value) || !isFullyResolved(value)) {\n    return { problem: `${D4_STRATEGY_FILE} records a navigation that is not plain data, so N1 cannot read it; write it as a literal.` };\n  }\n  return { recorded: value as Record<string, unknown> };\n}\n"]}

package/dist/site-system/rules/sections/exif.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Reads location metadata out of an image file without a dependency (T9). A photo straight off a phone carries the GPS
+ * position of the job site, and often the street and suburb; none of it may ship in `public/`.
+ *
+ * What counts as location metadata:
+ * - an EXIF GPS block with any tag beyond the version (latitude, longitude, altitude, a timestamp, a processing method);
+ * - XMP `exif:GPS*` properties and `photoshop:City`, `photoshop:State` and `Iptc4xmpCore:Location` (sublocation);
+ * - IPTC-IIM city (2:90), sublocation (2:92) and province or state (2:95) records.
+ *
+ * Formats: JPEG (APP1 EXIF and XMP, APP13 IPTC), PNG (`eXIf`, and `iTXt`/`tEXt` XMP), WebP (`EXIF` and `XMP ` chunks)
+ * and HEIC/HEIF/AVIF (the `Exif` item is found by its TIFF header, and XMP by its packet; this is a scan, not a full
+ * ISO box parser). A file in none of those formats, or one the reader cannot walk, reports nothing.
+ */
+export interface LocationMetadata {
+    /** Short names of what was found, for example "EXIF GPS (latitude, longitude)". */
+    readonly found: readonly string[];
+}
+/** Reads a TIFF block (EXIF) and returns the names of the GPS tags it carries. */
+export declare function gpsTagsInTiff(bytes: Uint8Array, start: number): string[];
+/** The location metadata an image file carries; an empty `found` for a clean file or a format this reader skips. */
+export declare function locationMetadata(bytes: Uint8Array): LocationMetadata;
+//# sourceMappingURL=exif.d.ts.map

package/dist/site-system/rules/sections/exif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exif.d.ts","sourceRoot":"","sources":["../../../../src/site-system/rules/sections/exif.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAiBD,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuCxE;AA4HD,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAUpE"}