@expofp/floorplan 0.0.0-experimental.cf063fc

package/dist/esm/data/tours.json

@@ -0,0 +1,280 @@
+{
+    "uitestdemo": [
+        {
+            "id": "connected-business-tour",
+            "layers": [
+                { "floor": "1", "id": "Pathway_1" },
+                { "floor": "2", "id": "Pathway_2" }
+            ],
+            "name": "Connected Business Tour",
+            "points": ["2345", "coffee-or-2119", "11-or-1289"]
+        }
+    ],
+    "uitest2026": [
+        {
+            "id": "knowledge-trail",
+            "layers": [{ "floor": "1", "id": "Pathway_1" }],
+            "name": "Knowledge Trail",
+            "description": "Designed for attendees focused on learning sessions and hands-on workshops, this route provides a clear path through the main educational areas of the event. It ensures quick access to conference rooms, interactive workshops, and the Innovation Lab, allowing participants to maximize their time, gain new knowledge, and engage directly with practical demonstrations.",
+            "points": ["2345", "coffee-or-2119", "11-or-1289", "255", "729"]
+        },
+        {
+            "id": "vip-express",
+            "layers": [{ "floor": "1", "id": "Pathway_2" }],
+            "name": "VIP Express",
+            "description": "A reserved route created specifically for VIP guests, allowing them to move efficiently between exclusive areas without interruptions. It connects the VIP Lounge with private meeting rooms and a dedicated exit, ensuring comfort, privacy, and quick access to high-priority zones throughout the event.",
+            "points": ["365", "burger-point", "backyard-or-1813", "2122", "2164", "mp12", "11-or-1289"]
+        },
+        {
+            "id": "startup-discovery-walk",
+            "layers": [{ "floor": "1", "id": "Pathway_3" }],
+            "name": "Startup Discovery Walk",
+            "description": "A route designed for attendees interested in exploring the newest and most innovative companies. It guides visitors through the Innovation Hub and Startup Pavilion, finishing at the Pitch Stage where emerging businesses showcase their ideas. This path helps attendees quickly discover fresh solutions and connect with founders shaping the future of logistics and supply chain.",
+            "points": [
+                "mc7",
+                "1895",
+                "coffee-or-2183",
+                "2345",
+                "innovation-stage-or-1303",
+                "biergarten-or-620",
+                "spa-or-573"
+            ]
+        },
+        {
+            "id": "global-networking-path",
+            "layers": [{ "floor": "1", "id": "Pathway_4" }],
+            "name": "Global Networking Path",
+            "description": "Created for participants who want to expand their global connections. This route leads from the Main Hall to the International Pavilion, highlighting exhibitors from around the world, and continues to the Networking Lounge. It ensures a smooth flow for meeting international partners, discovering global solutions, and engaging in meaningful business conversations.",
+            "points": [
+                "puppy-park-or-184",
+                "ocado-intelligent-automation",
+                "533",
+                "mocktails-or-941",
+                "infios",
+                "slip-robotics",
+                "penske-transportation-solutions",
+                "headshot-studio-or-1988",
+                "coffee-or-2183"
+            ]
+        }
+    ],
+    "uitestimex": [
+        {
+            "id": "startup-discovery-walk",
+            "layers": [{ "floor": "1", "id": "Pathway_1" }],
+            "name": "Startup Discovery Walk",
+            "description": "Designed for attendees focused on learning sessions and hands-on workshops, this route provides a clear path through the main educational areas of the event. It ensures quick access to conference rooms, interactive workshops, and the Innovation Lab, allowing participants to maximize their time, gain new knowledge, and engage directly with practical demonstrations.",
+            "points": ["84624", "E1235", "E1817", "E2105"]
+        },
+        {
+            "id": "tech-innovation-trail",
+            "layers": [{ "floor": "1", "id": "Pathway_2" }],
+            "name": "Tech Innovation Trail",
+            "description": "Focuses on technology exhibitors — mapping a route through companies offering event management software, AI tools, and digital signage solutions. Great for testing longer routes with multiple stops.",
+            "points": ["84628", "95111", "E1905", "39440", "91811", "40760", "10651"]
+        }
+    ],
+    "ifaberlin2025clone": [
+        {
+            "id": "knowledge-trail",
+            "layers": [{ "floor": "1", "id": "Pathway_2" }],
+            "name": "Knowledge Trail",
+            "description": "Designed for attendees focused on learning sessions and hands-on workshops, this route provides a clear path through the main educational areas of the event. It ensures quick access to conference rooms, interactive workshops, and the Innovation Lab, allowing participants to maximize their time, gain new knowledge, and engage directly with practical demonstrations.",
+            "points": [
+                "gr-ocg-107",
+                "gr-ocg-109",
+                "gr-ocg-102",
+                "gr-ocg-104",
+                "gr-ocg-106",
+                "gr-ocg-111",
+                "gr-ocg-110",
+                "Seating Lounge | Outdoor 1"
+            ]
+        }
+    ],
+    "demo": [
+        {
+            "id": "the-green-journey",
+            "layers": [{ "floor": "1", "id": "Pathway_1" }],
+            "name": "The Green Journey — From Idea to Implementation",
+            "description": "Embark on a curated journey through the exhibition’s most innovative sustainability zones. This tour highlights how modern industries rethink construction, manufacturing, and waste transformation to create a cleaner future. You’ll explore cutting-edge eco-materials, smart production methods, and next-generation recycling technologies — with a few pleasant stops along the way. The route ends in a relaxing lounge area, perfect for unwinding and reflecting on the ideas you’ve discovered.",
+            "points": [
+                "RXhoaWJpdG9yXzE4OTc5ODY=",
+                "RXhoaWJpdG9yXzE4OTc5NTg=",
+                "RXhoaWJpdG9yXzE4OTc5Mzk=",
+                "RXhoaWJpdG9yXzE4OTc5Mjc=",
+                "Coffe Bar | Hall 5.1"
+            ]
+        }
+    ],
+    "wcc2026": [
+        {
+            "id": "learning-on-show-floor",
+            "layers": [{ "floor": "L", "id": "Pathway_1" }],
+            "name": "Learning on show floor",
+            "points": ["Space Domain Theater | 723", "3307", "Unveiled Theater | 2241"]
+        },
+        {
+            "id": "networking-on-show-floor",
+            "layers": [{ "floor": "L", "id": "Pathway_2" }],
+            "name": "Networking on show floor",
+            "points": ["Restaurant | 406", "Meeting Hub | 636", "Brew Lounge | 1163"]
+        },
+        {
+            "id": "welcome-and-information-journey",
+            "layers": [
+                { "floor": "1", "id": "Pathway_5" },
+                { "floor": "3", "id": "Pathway_3" },
+                { "floor": "2", "id": "Pathway_4" },
+                { "floor": "C", "id": "Pathway_6" }
+            ],
+            "name": "Welcome and Information Journey",
+            "description": "Follow this route to get oriented, find visitor services, complete registration, and enter the exhibition hall."
+        }
+    ],
+    "lamma2026": [
+        {
+            "id": "innovation-trail",
+            "layers": [{ "floor": "1", "id": "Pathway_1" }],
+            "name": "Innovation Trail",
+            "points": [
+                "12120485",
+                "12120827",
+                "12120497",
+                "15552598",
+                "15552695",
+                "15552538",
+                "12120220",
+                "15552729",
+                "15784756",
+                "15552462",
+                "12120351",
+                "15552470"
+            ]
+        }
+    ],
+    "fdhw2026": [
+        {
+            "id": "association-of-convenience-stores-trail",
+            "layers": [{ "floor": "1", "id": "Pathway_1" }],
+            "name": "Association of Convenience Stores Trail",
+            "description": "Show: IFE.\nData Types Allowed to View: IFE Visitors / IFE Suppliers / IFE Press / IFEM Visitors / IFEM Suppliers / IFEM Press.",
+            "points": [
+                "16282530",
+                "16282664",
+                "16572191",
+                "16282882",
+                "16572254",
+                "16282294",
+                "16282527",
+                "16282319",
+                "16445163"
+            ]
+        },
+        {
+            "id": "newbies-at-the-pub-show",
+            "layers": [{ "floor": "1", "id": "Pathway_2" }],
+            "name": "Newbies at The Pub Show",
+            "description": "Show: The Pub Show.\nData Types Allowed to View: Pub Visitor / Pub Supplier / Pub Press / HRC Visitor / HRC Supplier / HRC Press.",
+            "points": [
+                "16282289",
+                "16282507",
+                "16282613",
+                "16282283",
+                "16282382",
+                "16282792",
+                "16830654",
+                "16282656",
+                "16282309",
+                "16282902",
+                "16282450",
+                "16283034",
+                "16282743",
+                "16572201",
+                "16282279",
+                "16369552",
+                "16282392",
+                "16282603"
+            ]
+        },
+        {
+            "id": "chef-steve-munkley-mbe-s-top-picks",
+            "layers": [{ "floor": "1", "id": "Pathway_3" }],
+            "name": "Chef Steve Munkley MBE's Top Picks",
+            "description": "Show: HRC.\nData Types Allowed to View: Pub Visitor / Pub Supplier / Pub Press / HRC Visitor / HRC Supplier / HRC Press.",
+            "points": [
+                "16282438",
+                "16282525",
+                "16282753",
+                "16282554",
+                "16282784",
+                "16282440",
+                "16282479",
+                "16282833",
+                "PastryHQ | S1290",
+                "16282914",
+                "16282776"
+            ]
+        },
+        {
+            "id": "radford-chancellor-s-must-see-exhibitors",
+            "layers": [{ "floor": "1", "id": "Pathway_4" }],
+            "name": "Radford Chancellor's Must See Exhibitors",
+            "description": "Show: HRC.\nData Types Allowed to View: Pub Visitor / Pub Supplier / Pub Press / HRC Visitor / HRC Supplier / HRC Press.",
+            "points": ["16282429", "16283073", "16600529"]
+        },
+        {
+            "id": "anna-sebastian-s-top-tipples",
+            "layers": [{ "floor": "1", "id": "Pathway_5" }],
+            "name": "Anna Sebastian's Top Tipples",
+            "description": "Show: HRC & The Pub Show.\nData Types Allowed to View: Pub Visitor / Pub Supplier / Pub Press / HRC Visitor / HRC Supplier / HRC Press.",
+            "points": ["16282311", "16445141", "16837929", "16369552", "16282279", "16282289", "16282603"]
+        },
+        {
+            "id": "fcsi-members-trail",
+            "layers": [{ "floor": "1", "id": "Pathway_6" }],
+            "name": " FCSI Members Trail",
+            "points": ["16282429", "16600529", "16282606", "16282806", "16282745", "16282964"]
+        }
+    ],
+    "retailtechnologyshow2026": [
+        {
+            "id": "innovation-awards-finalists",
+            "layers": [{ "floor": "1", "id": "Pathway_1" }],
+            "name": "Innovation Awards Finalists",
+            "points": [
+                "Business France | K10",
+                "16528837",
+                "16528943",
+                "16528881",
+                "16528816",
+                "16529021",
+                "16529050",
+                "16528953",
+                "16528893",
+                "16529071"
+            ]
+        },
+        {
+            "id": "zebra-partners-scavenger-hunt",
+            "layers": [{ "floor": "1", "id": "Pathway_2" }],
+            "name": "Zebra Partners Scavenger Hunt",
+            "points": [
+                "16528708",
+                "16528793",
+                "16529002",
+                "16529036",
+                "16529030",
+                "16529038",
+                "16528903",
+                "16528855",
+                "16528716",
+                "16528967",
+                "16528895",
+                "16529088",
+                "16529055",
+                "16529024"
+            ]
+        }
+    ]
+}

package/dist/esm/data/venue-scene-preload.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Resolves one lazily-loaded layer payload. Injected so tests can drive the
+ * seam without a config; production resolves the layer's `$ref` through
+ * `@expofp/resolve`.
+ */
+type ResolveLayer = (layerName: string) => Promise<void>;
+export declare function getPlanLayerNames(): string[];
+/**
+ * Replacing scene layer names declared by one raw venue, in declaration order.
+ * The single home for the "`render: 'scene'` that suppresses the procedural
+ * scene" predicate — the preloader, `VenueStore` and `parseVenues` must agree on
+ * it or the SDK fetches payloads the parser then ignores.
+ */
+export declare function getReplacingSceneLayerNames(venue: unknown): string[];
+/** Returns plausible Revision 2 replacing scene refs in plan-layer order. */
+export declare function getReplacingVenueSceneLayerNames(data: unknown): string[];
+/**
+ * A `$ref` fetch that hangs rather than rejects (captive portals, dead wifi)
+ * would otherwise leave `withPreloadedVenueScenes` — and every plan boot
+ * behind it — pending forever. Bounded so a stuck request always yields to
+ * the procedural fallback within a fixed budget.
+ */
+export declare const PRELOAD_TIMEOUT_MS = 10000;
+export declare function ensureVenueSceneLayerPayload(layerName: string, resolveLayer?: ResolveLayer): Promise<boolean>;
+/**
+ * Preloads only Revision 2 scene layers that suppress the procedural scene.
+ * Layers are independent `$ref`s, so they load concurrently — this blocks first
+ * paint, and serializing it would cost one network round-trip per layer.
+ */
+export declare function preloadVenueSceneLayers(data: unknown, resolveLayer?: ResolveLayer): Promise<void>;
+/** Keeps the asynchronous preload ahead of a synchronous module-init continuation. */
+export declare function withPreloadedVenueScenes<T>(data: unknown, initialize: () => T | Promise<T>, resolveLayer?: ResolveLayer): Promise<T>;
+export {};
+//# sourceMappingURL=venue-scene-preload.d.ts.map

package/dist/esm/data/venue-scene-preload.js

@@ -0,0 +1,205 @@
+import { getConfig } from '@expofp/config';
+import { resolve as resolveRef } from '@expofp/resolve';
+import { eventScopedCache } from '../tools/event-scoped-cache.js';
+import { getFpPaths, getFpSvg, getFpSvgJs } from './fp-payloads.js';
+/**
+ * In-flight loads keyed by layer name, so concurrent callers for the same layer
+ * share one resolution instead of racing it. Entries are dropped once settled —
+ * a later call must re-check the payload rather than replay a stale verdict.
+ * Per event: two events can name a layer alike, and the next plan must not
+ * await the previous plan's load (ADR-0011).
+ */
+const payloadLoadsInFlight = eventScopedCache();
+/**
+ * The drawing payload is only readable once the config carries a `fpSvgJsRef`
+ * (`getFpSvgJs` throws otherwise). Preloading runs during bootstrap and in
+ * tests that never build a config, so every read here is best-effort.
+ */
+function readPayload(read) {
+    try {
+        return read();
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasPayload(layerName) {
+    return (readPayload(() => getFpSvg(layerName)) !== undefined ||
+        readPayload(() => getFpPaths(layerName)) !== undefined);
+}
+/**
+ * Parses the base plan SVG at most once per payload. The base plan can be
+ * megabytes, and this module would otherwise re-parse it once per scene layer
+ * plus once more for `VenueStore.init` — all blocking, all before first paint.
+ * Keyed on the payload string so a replaced drawing is picked up.
+ */
+let parsedBase = null;
+function baseDocument() {
+    const baseSvg = readPayload(() => getFpSvg());
+    if (typeof baseSvg !== 'string' || typeof DOMParser !== 'function')
+        return null;
+    if (parsedBase?.source === baseSvg)
+        return parsedBase.document;
+    let document;
+    try {
+        document = new DOMParser().parseFromString(baseSvg, 'image/svg+xml');
+    }
+    catch {
+        document = null;
+    }
+    parsedBase = { source: baseSvg, document };
+    return document;
+}
+function embeddedLayerHasGeometry(layerName) {
+    const document = baseDocument();
+    if (!document)
+        return false;
+    return Array.from(document.querySelectorAll('[data-layer]')).some((element) => element.getAttribute('data-layer') === layerName &&
+        element.querySelector('polygon, rect, path') !== null);
+}
+export function getPlanLayerNames() {
+    const names = [];
+    const layers = readPayload(() => getFpSvgJs().__fpLayers);
+    if (Array.isArray(layers)) {
+        for (const layer of layers) {
+            if (typeof layer?.name === 'string' && layer.name && !names.includes(layer.name)) {
+                names.push(layer.name);
+            }
+        }
+    }
+    const document = baseDocument();
+    if (!document)
+        return names;
+    for (const element of Array.from(document.querySelectorAll('[data-layer]'))) {
+        const name = element.getAttribute('data-layer');
+        if (name && !names.includes(name))
+            names.push(name);
+    }
+    return names;
+}
+/**
+ * Replacing scene layer names declared by one raw venue, in declaration order.
+ * The single home for the "`render: 'scene'` that suppresses the procedural
+ * scene" predicate — the preloader, `VenueStore` and `parseVenues` must agree on
+ * it or the SDK fetches payloads the parser then ignores.
+ */
+export function getReplacingSceneLayerNames(venue) {
+    if (typeof venue !== 'object' || venue === null)
+        return [];
+    const { layers } = venue;
+    if (!Array.isArray(layers))
+        return [];
+    const names = [];
+    for (const layer of layers) {
+        if (typeof layer === 'object' &&
+            layer !== null &&
+            typeof layer.layer === 'string' &&
+            layer.layer.length > 0 &&
+            layer.render === 'scene' &&
+            (layer.replacesDefault === undefined || layer.replacesDefault === true) &&
+            !names.includes(layer.layer)) {
+            names.push(layer.layer);
+        }
+    }
+    return names;
+}
+/** Returns plausible Revision 2 replacing scene refs in plan-layer order. */
+export function getReplacingVenueSceneLayerNames(data) {
+    if (typeof data !== 'object' || data === null)
+        return [];
+    const { venuesVersion, venues } = data;
+    if (venuesVersion !== undefined && venuesVersion !== 1)
+        return [];
+    if (!Array.isArray(venues))
+        return [];
+    const candidates = new Set();
+    for (const venue of venues) {
+        if (typeof venue !== 'object' ||
+            venue === null ||
+            typeof venue.id !== 'string' ||
+            !venue.id ||
+            typeof venue.name !== 'string' ||
+            !venue.name ||
+            !Array.isArray(venue.levels) ||
+            venue.levels.length === 0 ||
+            !venue.levels.every((level) => typeof level === 'object' &&
+                level !== null &&
+                typeof level.layer === 'string' &&
+                Number.isFinite(level.ordinal)) ||
+            !Array.isArray(venue.layers)) {
+            continue;
+        }
+        for (const name of getReplacingSceneLayerNames(venue))
+            candidates.add(name);
+    }
+    return getPlanLayerNames().filter((name) => candidates.has(name));
+}
+/**
+ * A `$ref` fetch that hangs rather than rejects (captive portals, dead wifi)
+ * would otherwise leave `withPreloadedVenueScenes` — and every plan boot
+ * behind it — pending forever. Bounded so a stuck request always yields to
+ * the procedural fallback within a fixed budget.
+ */
+export const PRELOAD_TIMEOUT_MS = 10_000;
+/**
+ * Resolves the layer's `$ref` from the config. The ref carries its own URL and
+ * processing — `@expofp/config` folds converter-specific globals onto the
+ * canonical `__fp`/`__fpPaths` keys as the payload settles — so unlike the old
+ * script loader this needs no URL building and no base-global save/restore.
+ * Bounded by {@link PRELOAD_TIMEOUT_MS}: on expiry the fetch is aborted (not
+ * just abandoned in flight) and this rejects, which the caller treats the
+ * same as any other resolution failure.
+ */
+const resolveLayerRef = async (layerName) => {
+    const ref = getConfig().fpSvgLayerJsRefs[layerName];
+    if (!ref)
+        return;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), PRELOAD_TIMEOUT_MS);
+    try {
+        await resolveRef(ref, { signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+};
+/**
+ * Loads one generated layer payload. Success is determined by reading the
+ * payload back, not by the resolver settling: a plan can declare a scene layer
+ * the converter never emitted, and that must not count as loaded.
+ */
+async function loadVenueSceneLayerPayload(layerName, resolveLayer) {
+    if (hasPayload(layerName) || embeddedLayerHasGeometry(layerName))
+        return true;
+    try {
+        await resolveLayer(layerName);
+    }
+    catch {
+        return false;
+    }
+    return hasPayload(layerName);
+}
+export function ensureVenueSceneLayerPayload(layerName, resolveLayer = resolveLayerRef) {
+    const loads = payloadLoadsInFlight();
+    const pending = loads.get(layerName);
+    if (pending)
+        return pending;
+    const operation = loadVenueSceneLayerPayload(layerName, resolveLayer).finally(() => {
+        loads.delete(layerName);
+    });
+    loads.set(layerName, operation);
+    return operation;
+}
+/**
+ * Preloads only Revision 2 scene layers that suppress the procedural scene.
+ * Layers are independent `$ref`s, so they load concurrently — this blocks first
+ * paint, and serializing it would cost one network round-trip per layer.
+ */
+export async function preloadVenueSceneLayers(data, resolveLayer = resolveLayerRef) {
+    await Promise.all(getReplacingVenueSceneLayerNames(data).map((layerName) => ensureVenueSceneLayerPayload(layerName, resolveLayer)));
+}
+/** Keeps the asynchronous preload ahead of a synchronous module-init continuation. */
+export async function withPreloadedVenueScenes(data, initialize, resolveLayer = resolveLayerRef) {
+    await preloadVenueSceneLayers(data, resolveLayer);
+    return initialize();
+}

package/dist/esm/data/venues.d.ts

@@ -0,0 +1,145 @@
+import { Box, type Point2Like } from '@expofp/geometry';
+import type { RawVenue, RawVenueAuxLayer, RawVenueEntrance, RawVenueLevel, VenuePayload, VenueRenderMode, VenueSizeBound } from '@expofp/schema';
+import type { VenueDiagnostic, VenueDiagnosticEffect } from '../types';
+export type { RawVenue, RawVenueAuxLayer, RawVenueEntrance, RawVenueLevel, VenueDiagnostic, VenueDiagnosticEffect, VenuePayload, VenueRenderMode, VenueSizeBound, };
+/** Geometry a referenced plan layer contributes to the temporary hull fallback. */
+export interface VenueLevelGeometry {
+    rect?: Box | null;
+    viewbox?: Box | null;
+}
+/**
+ * Geometry a scene layer offers for §6 contour resolution. Structurally the
+ * `VenueContourExtraction` produced by `extractVenueContour`, restated here so
+ * this module stays free of renderer imports.
+ *
+ * A layer that supplied no ring says why: `unusableElementKinds` names the
+ * shapes it drew that can never be a footprint source — everything but
+ * `<path>` (§6) — so the diagnostic emitted here can tell an author what to
+ * redraw. The extractor reports; only this module emits.
+ */
+export interface VenueSceneCandidate {
+    layer: string;
+    extraction: {
+        ring: Point2Like[];
+        boundsFallback: boolean;
+    } | {
+        ring: null;
+        unusableElementKinds: readonly string[];
+    };
+}
+export interface ParsedVenueLevel {
+    layer: string;
+    ordinal: number;
+    name?: string;
+    /** Resolved initialization state; this does not represent user activation. */
+    initial: boolean;
+}
+export interface ParsedVenueAuxLayer {
+    layer: string;
+    render: VenueRenderMode;
+    replacesDefault: boolean;
+    /** Resolved from `replacesDefault` and the render mode when unauthored (§7). */
+    suppressesLabel: boolean;
+    minSizePx?: number;
+    maxSizePx?: VenueSizeBound;
+}
+/**
+ * A door of a venue, on one of its own surviving levels (§6.1). Empty for the
+ * many plans that author none — permanent, supported behavior, not a gap.
+ */
+export interface ParsedVenueEntrance {
+    /** Level layer the door stands on; always one of this venue's own levels. */
+    layer: string;
+    point: Point2Like;
+    name?: string;
+}
+export interface ParsedVenue {
+    id: string;
+    name: string;
+    order: number;
+    levels: ParsedVenueLevel[];
+    contour: Point2Like[];
+    markerPoint: Point2Like;
+    bounds: Box;
+    detailMinSizePx?: number;
+    /** The authored marker ⇄ scene edge (§4, Revision 5); absent means the default 60. */
+    markerMaxSizePx?: number;
+    auxLayers: ParsedVenueAuxLayer[];
+    entrances: ParsedVenueEntrance[];
+}
+export interface ParseVenuesResult {
+    venues: ParsedVenue[];
+    diagnostics: VenueDiagnostic[];
+    /** Existing references owned only by venues that were dropped entirely. */
+    quarantinedLayerNames: string[];
+    /**
+     * The authored whole-campus frame (§3, Revision 9), plan-local. Null when no
+     * venue carries a usable one, and on a plan without a venue model.
+     */
+    campusViewbox: Box | null;
+}
+/** Contract defaults for the size axis (§4). Re-exported by `venue-legibility`. */
+export declare const DEFAULT_MARKER_MAX_SIZE_PX = 60;
+export declare const DEFAULT_DETAIL_MIN_SIZE_PX = 240;
+/**
+ * Floor for an authored `detailMinSizePx`, and the reason it is not simply 60:
+ *
+ * 66 is the **marker/scene sticky enter edge** for the contract's defaults —
+ * `stickyEnterSizePx(60)`, where the `× 1.1` is the ±10% size hysteresis
+ * (`SIZE_HYSTERESIS_RATIO` in `venue-legibility.ts`) — the size at which a
+ * venue climbing out of the marker band actually enters the scene band.
+ * Clamping here keeps floor detail from beginning before the scene band has
+ * been entered.
+ *
+ * **A literal, never derived** (contract §4, App. C). The contract states the
+ * floor to authors as the number 66, and every implementation must hold that
+ * number exactly: an author who writes `detailMinSizePx: 66` clears the
+ * producer's export gate and must not then be clamped at runtime. Derived, the
+ * floor is a float expression the contract cannot promise equals 66 — it does
+ * for these two operands, and would stop the moment either the ceiling or the
+ * ratio moved, silently invalidating the documented value. So it is written as
+ * 66 here and in every other implementation, with the relationship above
+ * documented rather than computed.
+ *
+ * Nor can the relationship be expressed in code: `venue-legibility.ts` imports
+ * the band defaults from this module, so the dependency is one-way and
+ * `stickyEnterSizePx` is not importable here.
+ *
+ * It is deliberately NOT "the smallest value above 60" (that would be 61):
+ * 61 clears the impossible-range guard below — which needs only
+ * `resolvedDetailMinSizePx > resolvedMin`, and a defaulted scene aux resolves
+ * `minSizePx` to 60 — but leaves a ~1px-wide scene band wedged between the
+ * two sticky edges, which flickers rather than hands off. Do not "simplify"
+ * this to `DEFAULT_MARKER_MAX_SIZE_PX + 1`; it silently breaks the handoff.
+ *
+ * This is the floor for the **default** ceiling. A venue that authors its own
+ * `markerMaxSizePx` (Revision 5) gets its floor from {@link detailMinSizeFloor}.
+ */
+export declare const MIN_DETAIL_MIN_SIZE_PX = 66;
+/**
+ * Whether a detail edge leaves room above a marker edge for the hysteresis
+ * band (§4, Revision 5). Stated as the contract's integer comparison rather
+ * than `× 1.1`, so every implementation agrees on the boundary exactly.
+ */
+export declare function detailEdgeClearsMarkerEdge(detailMinSizePx: number, markerMaxSizePx: number): boolean;
+/**
+ * The smallest `detailMinSizePx` a venue with this marker edge may carry: the
+ * least value satisfying {@link detailEdgeClearsMarkerEdge}. For the default
+ * ceiling it is the literal {@link MIN_DETAIL_MIN_SIZE_PX}, so the number §4
+ * has always stated to authors cannot drift.
+ */
+export declare function detailMinSizeFloor(markerMaxSizePx: number): number;
+/**
+ * Codepoint order for venue `id`s — the contract's "alphabetically by `id`"
+ * (§9), pinned to one answer every implementation of this contract can
+ * reproduce. `localeCompare` cannot: it is ICU-collated, so `hall-1`, `hall_a`
+ * and `halla` sort differently across runtimes, and a layer-ownership winner
+ * that depends on the reader is exactly what §10 keys off `id` to avoid.
+ */
+export declare const compareIds: (a: string, b: string) => number;
+/**
+ * Parses a complete venue payload. Candidate entries are validated before any
+ * ownership is committed; all surviving levels claim globally before aux refs.
+ */
+export declare function parseVenues(payload: unknown, geometries: ReadonlyMap<string, VenueLevelGeometry>, sceneCandidates?: readonly (readonly VenueSceneCandidate[])[]): ParseVenuesResult;
+//# sourceMappingURL=venues.d.ts.map