@escape-game-over/atlas 0.1.115 → 0.1.117

package/src/meta/index.ts

@@ -37,7 +37,7 @@ import {
     serializeJsonLd,
 } from "../jsonld/index.ts";
 import type { HttpsUrl } from "../url.ts";
-import type { MetaContentBase, PageKind, ThemeColor } from "./content.ts";
+import type { MetaContent, ThemeColor } from "./content.ts";
 import { robotsContent, warnAboutRobots } from "./robots.ts";
 import {
     type OgImage,
@@ -47,13 +47,7 @@ import {
 import { link, type MetaTag, meta, preamble } from "./tag.ts";
 import { type SiteVerification, verificationTags } from "./verification.ts";
 
-export type {
-    ArticleContent,
-    MetaContent,
-    OpenGraphType,
-    PageKind,
-    ThemeColor,
-} from "./content.ts";
+export type { ArticleContent, MetaContent, ThemeColor } from "./content.ts";
 export type { RobotsDirective, RobotsPolicy } from "./robots.ts";
 export {
     fitDescription,
@@ -66,15 +60,8 @@ export {
 export type { MetaTag } from "./tag.ts";
 export type { SiteVerification } from "./verification.ts";
 
-/**
- * Everything the head needs: what the page supplies, plus what lib derives.
- *
- * `PageKind` is intersected rather than inherited so that `Omit` applies to the
- * base alone: omitting a key from a union would flatten it and lose the
- * exclusivity that union exists for.
- */
-export type MetaInput<L extends string> = Omit<MetaContentBase, "image"> &
-    PageKind &
+/** Everything the head needs: what the page supplies, plus what lib derives. */
+export type MetaInput<L extends string> = Omit<MetaContent, "image"> &
     MetaInputDerived<L>;
 
 interface MetaInputDerived<L extends string> extends ChromeInput {
@@ -90,14 +77,9 @@ interface MetaInputDerived<L extends string> extends ChromeInput {
     /** The share image, already resolved against the site origin. */
     readonly image: OgImage;
     /**
-     * `ArticleContent.images`, already resolved against the site origin.
-     *
-     * A sibling of `article` rather than a field inside it, because `PageKind`
-     * is a union and `Omit` on a union flattens it — which is the whole reason
-     * `MetaInput` intersects that union separately instead of omitting through
-     * it. So the resolved form arrives beside the page's own, exactly as
-     * `image` does: a page states `ShareImage`, lib hands `buildMeta` an
-     * `OgImage`.
+     * `ArticleContent.images`, already resolved against the site origin: the
+     * page states its crops, as it states `image`, and lib hands `buildMeta`
+     * their absolute URLs beside them.
      */
     readonly articleImages?: readonly HttpsUrl[];
     /**
@@ -288,16 +270,12 @@ export function buildMeta<L extends string>(input: MetaInput<L>): DocumentTags {
 
     // Open Graph
     //
-    // The type follows the content rather than being stated beside it: a page
-    // that described an article and called itself a website would be two claims
-    // about one thing, and only one of them could be right.
+    // The type follows the content rather than being stated beside it: an
+    // article is a page that describes one.
     tags.push(
         meta({
             property: "og:type",
-            content:
-                input.article === undefined
-                    ? (input.type ?? "website")
-                    : "article",
+            content: input.article === undefined ? "website" : "article",
         })
     );
     tags.push(meta({ property: "og:title", content: input.title }));

package/src/project.ts

@@ -1,6 +1,5 @@
 import type { AnalyticsSettings } from "./analytics/index.ts";
 import type {
-    LocaleMetaOverride,
     LocaleNotEnabled,
     LocalesOf,
     RoutingConfig,
@@ -131,10 +130,6 @@ export interface ProjectInput<L extends string, Routes> {
      * reads like the whole truth when it is only a patch.
      */
     readonly overrideRouting?: Partial<RoutingConfig<L>>;
-    /** Restates a locale's label. Its writing direction is not overridable. */
-    readonly overrideLocaleMeta?: Readonly<
-        Partial<Record<L, LocaleMetaOverride>>
-    >;
     /** Adds to the site's `defaultFonts`, or replaces one by key. */
     readonly overrideFonts?: Fonts;
     /**
@@ -237,8 +232,9 @@ export type ProjectChecks<
         // Against the published locales rather than the site's list: a
         // segment spelled for a language this deployment does not
         // publish is a word that appears in no URL it builds. Mapped
-        // over the keys written, for the reason `overrideLocaleMeta`
-        // below is.
+        // over the keys written: `T` is inferred from the literal, so a
+        // stray key just becomes part of `T` and there is no fresh object
+        // for excess-property checking to fire on.
         readonly pageSegmentByLocale?: {
             readonly [K in StringKeys<
                 NonNullable<T["overrideRouting"]>["pageSegmentByLocale"]
@@ -249,18 +245,8 @@ export type ProjectChecks<
         T["overrideRoutes"],
         StringKeys<Routes>
     >;
-    // Nested, so that `dir` is rejected inside each locale's entry.
-    // Declaring the field as `Pick<LocaleMeta, "label">` is not enough:
-    // `T` is *inferred* from the literal, so a stray `dir` just becomes
-    // part of `T` and there is no fresh object for excess-property
-    // checking to fire on.
-    readonly overrideLocaleMeta?: {
-        readonly [K in StringKeys<T["overrideLocaleMeta"]>]: K extends Published
-            ? NoExcessKeys<T["overrideLocaleMeta"][K], keyof LocaleMetaOverride>
-            : LocaleNotEnabled<K>;
-    };
     // The clock's locales must be ones this project publishes, as for
-    // `overrideLocaleMeta` above. That every one it publishes is there is
+    // `pageSegmentByLocale` above. That every one it publishes is there is
     // checked in `ProjectOverrideChecks`: a conditional on `T` here would make
     // the constraint circular.
     readonly formats?: {

package/src/routes/define.ts

@@ -353,19 +353,6 @@ export type SectionPrefixOf<Routes, Overrides> = FirstSegment<
     EnabledSlugs<Routes, Overrides>
 >;
 
-/**
- * The sections with no page of their own — a prefix that heads a group but is
- * not itself a slug anything is published at.
- *
- * These are the only sections whose link a consumer may choose. Where an index
- * page exists it is the answer, and offering a second one would invite a
- * heading that points somewhere other than the page it names.
- */
-export type OrphanSectionPrefixOf<Routes, Overrides> = Exclude<
-    SectionPrefixOf<Routes, Overrides>,
-    EnabledSlugs<Routes, Overrides>
->;
-
 /**
  * The route ids that survive a given override map, computed from literal types.
  *

package/src/routes/family.ts

@@ -43,15 +43,16 @@ type MemberId<M> = M extends string
  * The route ids a family produced.
  *
  * ```ts
- * const challengeRoutes = routeFamily(config, "challenges", challenges);
- * export type ChallengeRouteId = RouteIdsOf<typeof challengeRoutes>;
+ * const challenges = atlas.family("challenges", CHALLENGES);
+ * export type ChallengeRouteId = RouteIdsOf<typeof challenges>;
  * ```
  *
  * Reading them back off the family means the prefix is written once, in the
  * call. Spelling the ids out as `` `challenges-${string}` `` would be a second
  * copy of it, free to drift the day the URL changes.
  */
-export type RouteIdsOf<Family> = StringKeys<Family>;
+export type RouteIdsOf<Family extends { readonly routes: unknown }> =
+    StringKeys<Family["routes"]>;
 
 /**
  * A URL prefix as a route-id prefix: `"news/posts"` -> `"news-posts"`.
@@ -349,3 +350,134 @@ export function familyGuard<
     return <T extends string>(id: T): id is T & StringKeys<Family> =>
         Object.hasOwn(family, id);
 }
+
+/** A family's translated prefix, as `slugs` joins it. */
+type PrefixByOf<Options> = Options extends {
+    readonly prefixByLocale: infer P extends ByLocale;
+}
+    ? P
+    : Record<never, never>;
+
+/**
+ * A family, and what a project does with it: spread its `routes` into the
+ * table, and ask the family — not a string — anything about its members.
+ *
+ * Every helper is bound to the prefix the family was made with, so the prefix
+ * is written once: a project cannot enable `"challenge"` members of a
+ * `"challenges"` family, or build a member's path under the wrong prefix.
+ */
+export interface RouteFamily<
+    Prefix extends string,
+    Member extends string,
+    Routes,
+    PrefixBy extends ByLocale,
+> {
+    /** The member routes, to spread into `atlas.routes`. */
+    readonly routes: Routes;
+
+    /**
+     * Whether a route id is one of this family's, as a type guard. See
+     * {@link familyGuard} for why it is generic in the input.
+     */
+    is<T extends string>(id: T): id is T & StringKeys<Routes>;
+
+    /** A member's route id: `routeIdOf("blue-room")` is `"rooms-blue-room"`. */
+    routeIdOf(member: Member): StringKeys<Routes>;
+
+    /** The member a route id of this family is the page of. */
+    memberOf(routeId: StringKeys<Routes>): Member;
+
+    /**
+     * One override for many members, for a project's `overrideRoutes`: by
+     * default, `{ enabled: true }`. Keys stay literal; see {@link enableRoutes}.
+     */
+    enable<
+        const Picked extends readonly (Member | { readonly id: Member })[],
+        const Override extends { readonly enabled?: boolean } = {
+            readonly enabled: true;
+        },
+    >(
+        members: Picked,
+        override?: Override
+    ): {
+        readonly [M in Picked[number] as `${Dashed<Prefix>}-${MemberId<M> &
+            string}`]: Override;
+    };
+
+    /**
+     * A member's paths at a segment of a project's own, in every locale,
+     * under the family's prefix and its translations. See
+     * {@link familyMemberSlugs}.
+     */
+    slugs<
+        const Segment extends string,
+        const SegmentBy extends ByLocale = Record<never, never>,
+    >(
+        segment: Segment,
+        segmentByLocale?: SegmentBy
+    ): FamilyMemberSlugs<Prefix, Segment, PrefixBy, SegmentBy>;
+}
+
+/** Builds a {@link RouteFamily}: what `atlas.family` returns. */
+export function createFamily<
+    const C extends SiteConfigShape,
+    const Prefix extends string,
+    const Members extends readonly FamilyMemberInput<LocalesOf<C>>[],
+    const Options extends FamilyOptions<LocalesOf<C>> = Record<string, never>,
+>(
+    config: C,
+    prefix: Prefix,
+    members: Members,
+    options?: Options
+): RouteFamily<
+    Prefix,
+    MemberId<Members[number]> & string,
+    ReturnType<typeof routeFamily<C, Prefix, Members, Options>>,
+    PrefixByOf<Options>
+> {
+    const routes = routeFamily(config, prefix, members, options);
+    const enable = enableRoutes(prefix);
+    const ids = members.map((member) =>
+        typeof member === "string" ? member : member.id
+    );
+    const routeId = (member: string) =>
+        `${prefix.replaceAll("/", "-")}-${member}`;
+    const byRouteId = new Map(ids.map((member) => [routeId(member), member]));
+
+    return {
+        routes,
+        is: familyGuard(routes),
+        routeIdOf: (member) => {
+            if (!ids.includes(member)) {
+                throw new Error(
+                    `"${member}" is not a member of the "${prefix}" family.`
+                );
+            }
+            return routeId(member) as never;
+        },
+        memberOf: (id) => {
+            const member = byRouteId.get(id);
+            if (member === undefined) {
+                throw new Error(
+                    `"${id}" is not a route of the "${prefix}" family.`
+                );
+            }
+            return member as never;
+        },
+        enable: (picked, override) => enable(picked, override),
+        slugs: (segment, segmentByLocale) => {
+            // The join `familyMemberSlugs` makes, with the family's own prefix
+            // translations rather than a copy of them.
+            const slugByLocale = joinByLocale(
+                prefix,
+                segment,
+                options?.prefixByLocale,
+                segmentByLocale
+            );
+            return {
+                slug: `${prefix}/${segment}`,
+                ...(slugByLocale === undefined ? {} : { slugByLocale }),
+            } as never;
+        },
+    };
+}

package/src/site/api.ts

@@ -51,7 +51,6 @@ export interface LlmsOptions<
     RouteId extends string,
     L extends string,
     Prefix extends string = string,
-    OrphanPrefix extends string = Prefix,
 > {
     /**
      * This route's name and one-line summary, in the file's language.
@@ -88,21 +87,6 @@ export interface LlmsOptions<
      * comparison that quietly never matches and leaves the default in place.
      */
     sectionHeading?(prefix: Prefix, locale: L): string | undefined;
-    /**
-     * Where a section with no index page should link.
-     *
-     * Separate from the heading because it is an enrichment rather than half of
-     * one decision: a section can be renamed without being linked, and linked
-     * without being renamed.
-     *
-     * Only sections that *have* no page of their own are offered. Where an index
-     * page exists it is already the link, and `OrphanPrefix` excludes it — so
-     * pointing a named family somewhere other than the page it is named after is
-     * a compile error rather than a choice. Returning `undefined` leaves the
-     * heading unlinked, which is the right answer when those pages are listed
-     * nowhere else.
-     */
-    sectionLink?(prefix: OrphanPrefix, locale: L): RouteId | undefined;
     /** The `>` block under the title: what this site is, in a sentence or two. */
     readonly summary?: string;
     /**
@@ -132,8 +116,6 @@ export interface Site<
      * be, and no annotation should have to state it.
      */
     Prefix extends string = string,
-    /** Of those, the ones with no index page of their own. */
-    OrphanPrefix extends string = Prefix,
 > {
     readonly locales: readonly L[];
     readonly defaultLocale: L;
@@ -356,9 +338,7 @@ export interface Site<
      * the first time a route is switched off or a slug is retranslated, and
      * nothing reports it, because nothing reads the file during a build.
      */
-    llms(
-        options?: LlmsOptions<RouteId, L, Prefix, OrphanPrefix>
-    ): GeneratedFile;
+    llms(options?: LlmsOptions<RouteId, L, Prefix>): GeneratedFile;
 
     /**
      * Old URLs that must keep working, resolved — for `siteRoutes()` only.

package/src/site/create.ts

@@ -2,7 +2,7 @@ import { consentVendors } from "../analytics/index.ts";
 import {
     type LocaleMeta,
     type LocalesOf,
-    mergeLocaleMeta,
+    resolveLocaleMeta,
     type SiteConfigShape,
 } from "../config.ts";
 import {
@@ -21,7 +21,7 @@ import {
     mergeCatalog,
     type OverrideCatalog,
 } from "../i18n/define.ts";
-import { createTranslateFactory } from "../i18n/translate.ts";
+import { createTranslate, type TranslateFor } from "../i18n/translate.ts";
 import type { ImageAsset } from "../image.ts";
 import { buildLlms, type LlmsItem, type LlmsSection } from "../llms.ts";
 import {
@@ -43,11 +43,7 @@ import {
     statusFor,
 } from "../redirects.ts";
 import { buildRobots, type RobotsGroup } from "../robots.ts";
-import type {
-    OrphanSectionPrefixOf,
-    RouteRegistry,
-    SectionPrefixOf,
-} from "../routes/define.ts";
+import type { RouteRegistry, SectionPrefixOf } from "../routes/define.ts";
 import {
     buildPath,
     listRouteEntries,
@@ -122,8 +118,7 @@ export function createSite<
     Published,
     MessagesOf<Cat>,
     ProjectRouteId<Routes, P>,
-    SectionPrefixOf<Routes, P["overrideRoutes"]>,
-    OrphanSectionPrefixOf<Routes, P["overrideRoutes"]>
+    SectionPrefixOf<Routes, P["overrideRoutes"]>
 > {
     // The locales this *project* publishes, from its catalog, not the
     // universe the site config declares: `pathFor("home", "el-GR")` must not
@@ -171,10 +166,10 @@ export function createSite<
     // narrowing inside the closures below, which a property access would not.
     const siteUrl = project.url;
 
-    const localeMeta = mergeLocaleMeta<L>(
+    const localeMeta = resolveLocaleMeta<L>(
         config_.locales as Readonly<Record<L, LocaleMeta>>,
-        project.overrideLocaleMeta,
-        locales
+        locales,
+        catalog.labels
     );
     const fonts = mergeFonts(config_.defaultFonts, project.overrideFonts);
     const pathContext: PathContext<L> = {
@@ -205,7 +200,6 @@ export function createSite<
         catalog.override,
         catalog.add
     );
-    const translateFactory = createTranslateFactory<Full, L>();
 
     const resolved = mergeRoutes<L, Routes>(routes, project.overrideRoutes);
 
@@ -283,9 +277,7 @@ export function createSite<
      * Three callers, and two of them want one string out of it: `robots()` and
      * `llms()` each advertise `entry.url`, so an unmemoised call derived every
      * URL on the site — each with its alternates, each joined to the origin —
-     * three times over to answer a question about a filename. `siteRoutes`
-     * then does the whole thing again on every dev-server request that hits a
-     * generated file.
+     * three times over to answer a question about a filename.
      *
      * Safe to hold because everything it reads is settled before this closure
      * exists: `entries`, `localeMeta` and the origin are fixed for the life of
@@ -783,17 +775,11 @@ export function createSite<
                 options.sectionHeading?.(parent, locale) ??
                 (owner === undefined ? parent : describe(owner, locale).name);
 
-            // The owning page, or the one nominated for a section that has
-            // none. Both may be absent — a family with no index page listed
-            // nowhere else — and the heading is then left unlinked rather than
-            // pointed at a URL this build never wrote.
-            const target = owner ?? options.sectionLink?.(parent, locale);
-
+            // Linked to the owning page; a section with none, a family with no
+            // index page, is left unlinked rather than pointed somewhere else.
             sections.push({
                 heading,
-                ...(target === undefined
-                    ? {}
-                    : { url: urlFor(target, locale) }),
+                ...(owner === undefined ? {} : { url: urlFor(owner, locale) }),
                 items: members.map(item),
             });
         }
@@ -888,7 +874,12 @@ export function createSite<
         translate: <const Values extends string = never>(
             locale: L,
             bind?: { readonly values?: Readonly<Record<Values, string>> }
-        ) => translateFactory<Values>(messages, locale, bind?.values),
+        ): TranslateFor<Full, Values> =>
+            createTranslate({
+                catalog: messages,
+                locale,
+                values: bind?.values,
+            }),
         rich: <
             const Links extends string = never,
             const Values extends string = never,

package/src/site/define.ts

@@ -40,9 +40,9 @@ import {
     type ValidateSlugDepth,
 } from "../routes/define.ts";
 import {
+    createFamily,
     type FamilyMemberInput,
     type FamilyOptions,
-    routeFamily,
 } from "../routes/family.ts";
 import { createSite } from "./create.ts";
 
@@ -56,7 +56,7 @@ import { createSite } from "./create.ts";
  *
  * // config/routes.ts, messages.ts, projects/<name>/project.ts, site.ts
  * const rooms = atlas.family("rooms", ROOMS, { enabled: true });
- * export const defaultRoutes = atlas.routes({ ...rooms, home: {…} });
+ * export const defaultRoutes = atlas.routes({ ...rooms.routes, home: {…} });
  * export const defaultMessages = atlas.messages({…});
  * export const messages = atlas.catalog(defaultMessages, { locales: […], override: {…} });
  * export const { project, redirects } = atlas.project(messages, defaultRoutes, {…});
@@ -76,17 +76,21 @@ export function defineSite<
     return {
         config,
 
-        /** A route per member, under one prefix: `rooms/red-room` for `rooms`. */
+        /**
+         * A route per member, under one prefix: `rooms/red-room` for `rooms`.
+         * Spread its `routes` into `routes()`; ask it the rest.
+         */
         family<
             const Prefix extends string,
             const Members extends readonly FamilyMemberInput<L>[],
             const Options extends FamilyOptions<L> = Record<string, never>,
-        >(
-            prefix: Prefix,
-            members: Members,
-            options?: Options
-        ): ReturnType<typeof routeFamily<C, Prefix, Members, Options>> {
-            return routeFamily(config, prefix, members, options);
+        >(prefix: Prefix, members: Members, options?: Options) {
+            return createFamily<C, Prefix, Members, Options>(
+                config,
+                prefix,
+                members,
+                options
+            );
         },
 
         /** The route table every project starts from. */

package/src/site/page.ts

@@ -89,16 +89,7 @@ export interface PageMeta {
  * the trail and had to be handed ids this project actually builds. The trail
  * now arrives finished, so nothing here mentions a route.
  */
-export type PageContent = MetaContent & PageExtras;
-
-/**
- * The two things a document cannot answer about itself.
- *
- * Split out because `MetaContent` is an intersection with a union — an
- * interface cannot extend one — and the union is what stops a page being both
- * an article and something else.
- */
-interface PageExtras {
+export interface PageContent extends MetaContent {
     /**
      * Which page of a paginated list this is, from 1.
      *

package/src/warn.ts

@@ -43,12 +43,12 @@ const RESET = `${ESC}[0m`;
  * `process` and simply gets colour, which is what a browser console renders
  * anyway.
  */
-const env = () =>
-    (
-        globalThis as {
-            process?: { env?: Readonly<Record<string, string | undefined>> };
-        }
-    ).process?.env;
+const env = () => {
+    const host: typeof globalThis & {
+        process?: { env?: Readonly<Record<string, string | undefined>> };
+    } = globalThis;
+    return host.process?.env;
+};
 
 // Functions, not values worked out at import: a browser bundle that imports
 // anything near this file would otherwise run the reads on every page.

package/src/analytics/axon-pixel.ts

@@ -1,24 +0,0 @@
-import { invalidId, UUID, type Uuid } from "./ids.ts";
-
-/**
- * AppLovin's Axon pixel. Marketing: it loads only once a visitor grants that.
- *
- * @see https://support.applovin.com/en/growth/promoting-your-websites/axon-pixel-integration/axon-pixel-native-js
- * @see https://support.applovin.com/en/growth/promoting-your-websites/axon-pixel-integration/events-and-objects
- */
-export interface AxonPixelSettings {
-    /** From the Axon dashboard: a UUID. */
-    readonly eventKey: Uuid;
-}
-
-/** Fails the build on a key that is not an event key: it would report nowhere. */
-export function checkAxonPixel(
-    axon: AxonPixelSettings | undefined,
-    at: string
-): void {
-    if (axon === undefined || UUID.test(axon.eventKey)) return;
-    invalidId(
-        at,
-        `Axon event key "${axon.eventKey}" is not a UUID, so it would report nowhere. Copy it from the Axon dashboard.`
-    );
-}

package/src/analytics/clarity.ts

@@ -1,29 +0,0 @@
-import { CLARITY_PROJECT_ID, invalidId } from "./ids.ts";
-
-/**
- * Microsoft Clarity. It has a cookieless mode, so like Google it loads for
- * every visitor: without consent it records each page view on its own and sets
- * no cookie, and the visitor's answer switches its cookies on or off.
- *
- * @see https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-setup
- * @see https://learn.microsoft.com/en-us/clarity/setup-and-installation/consent-mode
- * @see https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-consent-api-v2
- */
-export interface ClaritySettings {
-    /** From the Clarity project's settings: 10 lowercase letters and digits. */
-    readonly projectId: string;
-}
-
-/** Fails the build on an id that is not a project id: it would report nowhere. */
-export function checkClarity(
-    clarity: ClaritySettings | undefined,
-    at: string
-): void {
-    if (clarity === undefined || CLARITY_PROJECT_ID.test(clarity.projectId)) {
-        return;
-    }
-    invalidId(
-        at,
-        `Clarity project id "${clarity.projectId}" is not 10 lowercase letters and digits, so it would report nowhere. Copy it from the Clarity project's settings.`
-    );
-}

package/src/analytics/drip.ts

@@ -1,20 +0,0 @@
-import { DRIP_ACCOUNT_ID, invalidId, type NumericId } from "./ids.ts";
-
-/**
- * Drip's site tracking. Marketing: it loads only once a visitor grants that.
- *
- * @see https://help.drip.com/hc/en-us/articles/4424702539789-Install-Your-JavaScript-Snippet
- */
-export interface DripSettings {
-    /** From Drip's Site Setup: digits, the `_dcs.account` of its snippet. */
-    readonly accountId: NumericId;
-}
-
-/** Fails the build on an id that is not an account id: it would report nowhere. */
-export function checkDrip(drip: DripSettings | undefined, at: string): void {
-    if (drip === undefined || DRIP_ACCOUNT_ID.test(drip.accountId)) return;
-    invalidId(
-        at,
-        `Drip account id "${drip.accountId}" is not all digits, so it would report nowhere. Copy it from Drip's Site Setup.`
-    );
-}

package/src/analytics/meta-pixel.ts

@@ -1,29 +0,0 @@
-import type { NonEmpty } from "../types.ts";
-import { invalidId, META_PIXEL_ID, type NumericId } from "./ids.ts";
-
-/**
- * Meta's pixel. Marketing: it loads only once a visitor grants that.
- *
- * @see https://developers.facebook.com/docs/meta-pixel/get-started
- * @see https://developers.facebook.com/docs/meta-pixel/reference
- * @see https://developers.facebook.com/docs/meta-pixel/implementation/gdpr
- */
-export interface MetaPixelSettings {
-    /** From Events Manager: 15 or 16 digits. Several share one script. */
-    readonly pixelIds: NonEmpty<NumericId>;
-}
-
-/** Fails the build on an id that is not a pixel id: it would report nowhere. */
-export function checkMetaPixel(
-    meta: MetaPixelSettings | undefined,
-    at: string
-): void {
-    for (const id of meta?.pixelIds ?? []) {
-        if (!META_PIXEL_ID.test(id)) {
-            invalidId(
-                at,
-                `Meta pixel id "${id}" is not 15 or 16 digits, so it would report nowhere. Copy it from Events Manager.`
-            );
-        }
-    }
-}