@seatlayer/core 0.101.0 → 0.103.0

package/dist/core/chart-ops/index.d.ts

@@ -1,8 +1,8 @@
-import { c as SeatViewMetadata, i as SectionObject, aI as ZoneDef, C as ChartDoc, P as Point, t as CubicPath, o as Category, w as CategoryTier, a4 as ReferenceDirectSeatImportSource, I as ChartTheme, R as RowObject, ai as ReferenceScanSectionProposal, ag as ReferenceScanProposal, B as BoothObject, G as GAAreaObject, s as ShapeObject, T as TableObject, u as TextObject, aC as TextBackground, j as SeatOverride, a as ChartObject, e as SeatGlyphKind, A as AccessibilityType, at as SeatConfidenceEvidence, J as ConfidenceEvidenceScope } from '../../types-5AlKCD4j.js';
+import { c as SeatViewMetadata, i as SectionObject, aN as ZoneDef, C as ChartDoc, P as Point, v as CubicPath, o as Category, u as CategoryTier, a9 as ReferenceDirectSeatImportSource, e as SeatGlyphKind, N as ChartTheme, R as RowObject, an as ReferenceScanSectionProposal, al as ReferenceScanProposal, B as BoothObject, z as BoothType, G as GAAreaObject, y as RowAisleSeats, s as ShapeObject, T as TableObject, x as TableChairNumbering, w as TextObject, aH as TextBackground, j as SeatOverride, a as ChartObject, A as AccessibilityType, ay as SeatConfidenceEvidence, O as ConfidenceEvidenceScope, aS as GateUse, aT as GateShape, aU as RouteShape } from '../../types-ZviQR7ch.js';
 import { S as StageKind } from '../../stage-CKb7aNoH.js';
-import { e as CategoryInventoryObjectType } from '../../categoryInventory-DZ5IcDOy.js';
-import { R as RelabelOptions } from '../../labeling-CP3GhUrf.js';
-export { D as DEFAULT_SECTION_CORNER_SMOOTHING } from '../../labeling-CP3GhUrf.js';
+import { e as CategoryInventoryObjectType } from '../../categoryInventory-i-mGCBD3.js';
+import { R as RelabelOptions } from '../../labeling-20iLar-Q.js';
+export { D as DEFAULT_SECTION_CORNER_SMOOTHING } from '../../labeling-20iLar-Q.js';
 
 type ChartObjectIdFactory = (prefix: string) => string;
 type AutomaticPlacement = 'auto' | 'front' | 'rear' | 'left' | 'right';
@@ -402,7 +402,7 @@ declare function applySectionRowFit(doc: ChartDoc, input: SectionRowFitInput): S
 interface PolygonHolePreview {
     floorId: string;
     objectId: string;
-    objectType: 'section' | 'gaArea';
+    objectType: 'section' | 'gaArea' | 'shape';
     holeIndex: number;
     vertexCount: number;
     excludedObjectIds: string[];
@@ -437,6 +437,15 @@ declare function removePolygonHole(doc: ChartDoc, input: {
     changed: true;
 };
 
+/** Okabe-Ito colorblind-safe hues (black dropped — unreadable on dark charts).
+ *  Single source of truth for the colorblind-safe palette. The author-time
+ *  preview, the new-category seed, the reassign op in chart-ops/categories, and
+ *  SeatmapRenderer's colorblind mode all key off THIS array by category document
+ *  order, so a reassigned chart reads identically with colorblind mode on or off.
+ *  A dependency-free leaf so render assets (the venue pictogram badges) can use
+ *  it without importing the chart-ops graph. */
+declare const COLORBLIND_SAFE_PALETTE: readonly ["#e69f00", "#56b4e9", "#009e73", "#f0e442", "#0072b2", "#d55e00", "#cc79a7"];
+
 type SharedCategoryPatch = Partial<Pick<Category, 'label' | 'color' | 'price' | 'notForSale' | 'seatGlyph'>> & {
     tiers?: CategoryTier[] | null;
 };
@@ -476,12 +485,7 @@ declare function reorderChartCategories(doc: ChartDoc, input: {
     categoryKeys: string[];
     categories: Category[];
 };
-/** Okabe-Ito colorblind-safe hues (black dropped — unreadable on dark charts).
- *  Single source of truth for the colorblind-safe palette. The author-time
- *  preview, the new-category seed, the reassign op below, and SeatmapRenderer's
- *  colorblind mode all key off THIS array by category document order, so a
- *  reassigned chart reads identically with colorblind mode on or off. */
-declare const COLORBLIND_SAFE_PALETTE: readonly ["#e69f00", "#56b4e9", "#009e73", "#f0e442", "#0072b2", "#d55e00", "#cc79a7"];
+
 /**
  * First Okabe-Ito hue that stays distinct from every color already in use, so
  * the next category seeds a colorblind-safe hue. Falls back to indexing into the
@@ -536,9 +540,26 @@ declare function addChartCategory(doc: ChartDoc, input: {
     category: Category;
     categories: Category[];
 };
+/**
+ * Distinct, contrast-safe hues for auto-created inventory-family categories.
+ * Members are widely separated so a minted sibling never trips the palette
+ * contrast or colorblind-similarity warnings on the default authoring path.
+ *
+ * Board 10, N5 "First colours": teal, indigo, amber, purple, and red never
+ * first. Red reads as "sold" or "error" on a seat map, so the reds sit at the
+ * end and are only reached once every calmer hue is taken. This seeds NEW
+ * categories only; a chart's existing colours never change. The purple is a
+ * touch warmer than the board's first #9b6bd1, which sits ΔE 19 from the
+ * indigo, and the amber a touch deeper than #d9922b so a standing area filled
+ * with it still reads 3:1 on a light and a dark map (board 10, N5).
+ */
+declare const FIRST_CATEGORY_COLOURS: readonly ["#3e8e7e", "#6e7ff0", "#b0700f", "#b05fc4"];
 /** Plain-language derived name for a family sibling, e.g. “Standard – Tables”.
  *  Any family suffix already on the base is stripped first so the words never
- *  stack (“Standard – Tables” + booth → “Standard – Booths”). */
+ *  stack (“Standard – Tables” + booth → “Standard – Booths”). A base that is
+ *  itself a plain kind word (“Seats”, the name a first row is given) says
+ *  nothing about the new place, so its sibling is the plain word too: “Tables”,
+ *  never “Seats – Tables” (board 10, N4). */
 declare function familyCategoryLabel(baseLabel: string, objectType: CategoryInventoryObjectType): string;
 interface ResolveCreationCategoryOptions {
     idFactory: ChartObjectIdFactory;
@@ -576,7 +597,10 @@ declare function planCreationCategory(doc: ChartDoc, activeCategoryKey: string,
  *      designer's active key stays empty through that first mint;
  *   3. else reuse an existing, still family-safe sibling with the derived name
  *      (e.g. “Standard – Tables”) if one already exists;
- *   4. else mint a sibling from the base category — same price and ticket tiers,
+ *   4. else reuse the category this family is already priced by, even with an
+ *      active category of another kind (the Standing tool with “Seats” active
+ *      takes the standing category the chart already has);
+ *   5. else mint a sibling from the base category — same price and ticket tiers,
  *      a plain “<Base> – Tables/Booths/Standing/Seats” name, and a distinct
  *      colorblind-safe color so no contrast/CVD warning appears. With no active
  *      category there is no author intent to inherit, so the mint is a plain
@@ -595,6 +619,42 @@ declare function removeChartCategory(doc: ChartDoc, input: {
     categories: Category[];
 };
 
+interface CategoryDraft {
+    label: string;
+    color: string;
+    price?: number;
+    tiers?: CategoryTier[];
+    notForSale?: boolean;
+    seatGlyph?: SeatGlyphKind;
+}
+/**
+ * Add every draft in order. Labels that are already taken get " 2", " 3"… so
+ * a starter set or a plan's key never fails on one duplicate name.
+ */
+declare function addChartCategories(doc: ChartDoc, input: {
+    drafts: readonly CategoryDraft[];
+    idFactory: ChartObjectIdFactory;
+}): {
+    categoryKeys: string[];
+    categories: Category[];
+};
+/** "Stalls", or "Stalls 2" when that name is taken (names are unique, ignoring case). */
+declare function uniqueCategoryLabel(categories: readonly Pick<Category, 'label'>[], wanted: string): string;
+/**
+ * Everything that uses `categoryKey` (rows, tables, booths, standing areas,
+ * seat overrides and a section's default for new seats) moves to
+ * `toCategoryKey`, then the category is removed. Returns how many objects
+ * changed. Reference-backed categories and the last category stay protected,
+ * exactly as `removeChartCategory` enforces.
+ */
+declare function removeCategoryMovingInventory(doc: ChartDoc, input: {
+    categoryKey: string;
+    toCategoryKey?: string;
+}): {
+    movedObjectIds: string[];
+    categories: Category[];
+};
+
 type SharedThemePatch = {
     background?: string | null;
     seatLabelColor?: string | null;
@@ -916,7 +976,12 @@ interface ReferenceScanApplyResult extends ReferenceScanPreview {
 }
 declare function applyReferenceScanRows(doc: ChartDoc, proposal: ReferenceScanProposal, opts: ReferenceScanRowsOptions): ReferenceScanApplyResult;
 
-type SharedRowPatch = Partial<Omit<RowObject, 'type' | 'id' | 'arcFanGeneration' | 'segmentedRow' | 'rowBlockGeneration'>> & {
+type SharedRowPatch = Partial<Omit<RowObject, 'type' | 'id' | 'arcFanGeneration' | 'segmentedRow' | 'rowBlockGeneration' | 'aisleSeats'>> & {
+    /**
+     * Which ends of the row are aisle seats for buyers. null restores the
+     * automatic ends (see core/layout/aisleSeats). Pure presentation.
+     */
+    aisleSeats?: RowAisleSeats | null;
     /**
      * Coordinate-free label size/color/visibility merge directive. Applied on top
      * of any `labelPresentation` in the same patch and, unlike a geometry edit,
@@ -941,15 +1006,31 @@ type SharedRowPatch = Partial<Omit<RowObject, 'type' | 'id' | 'arcFanGeneration'
      */
     labelStyleShape?: 'plain' | 'pill';
 };
-type SharedTablePatch = Partial<Pick<TableObject, 'label' | 'displayLabel' | 'displayType' | 'shape' | 'seatCount' | 'sides' | 'seatCountsBySide' | 'rotation' | 'radius' | 'automaticRadius' | 'seatArc' | 'width' | 'height' | 'categoryKey' | 'bookAsWhole' | 'variableOccupancy' | 'minOccupancy' | 'maxOccupancy'>> & {
+/** Buyer-facing presentation shared by tables, booths and standing areas. */
+interface BookablePresentationPatch {
+    /** Name on the map: `visible` and `size` (see LabelStylePatch). Colour is not offered here. */
+    labelStyle?: LabelStylePatch;
+    /** Entrance/door hint, ≤40 chars after NFKC + trim. null or '' clears it. */
+    entrance?: string | null;
+}
+type SharedTablePatch = Partial<Pick<TableObject, 'label' | 'displayLabel' | 'displayType' | 'shape' | 'seatCount' | 'sides' | 'seatCountsBySide' | 'rotation' | 'radius' | 'automaticRadius' | 'seatArc' | 'width' | 'height' | 'categoryKey' | 'bookAsWhole' | 'variableOccupancy' | 'minOccupancy' | 'maxOccupancy'>> & BookablePresentationPatch & {
     fill?: string | null;
+    /** Buyer-facing chair numbering (display only). Merged into the stored
+     * numbering; null restores today's "T1-1, T1-2 …". Booking labels never change. */
+    chairNumbering?: TableChairNumbering | null;
 };
-type SharedBoothPatch = Partial<Pick<BoothObject, 'label' | 'displayLabel' | 'displayType' | 'width' | 'height' | 'rotation' | 'categoryKey'>> & {
+type SharedBoothPatch = Partial<Pick<BoothObject, 'label' | 'displayLabel' | 'displayType' | 'width' | 'height' | 'rotation' | 'categoryKey'>> & BookablePresentationPatch & {
     /** Custom booth outline (closed polygon, local coordinates relative to the
      * booth centre). `null` clears it, restoring the rectangle. */
     points?: Point[] | null;
+    /** Open sides of the stand. null clears it. */
+    boothType?: BoothType | null;
+    /** Buyer note (≤160 chars). null/'' note clears it. */
+    commercial?: {
+        note?: string | null;
+    } | null;
 };
-type SharedGAAreaPatch = Partial<Pick<GAAreaObject, 'label' | 'displayLabel' | 'displayType' | 'capacity' | 'categoryKey' | 'cornerRadius'>>;
+type SharedGAAreaPatch = Partial<Pick<GAAreaObject, 'label' | 'displayLabel' | 'displayType' | 'capacity' | 'categoryKey' | 'cornerRadius' | 'bookAsWhole' | 'variableOccupancy' | 'minOccupancy' | 'maxOccupancy' | 'wheelchairPlaces'>> & BookablePresentationPatch;
 interface StageLabelStylePatch {
     size?: number | null;
     color?: string | null;
@@ -976,6 +1057,14 @@ type SharedShapePatch = Partial<Pick<ShapeObject, 'kind'>> & {
     opacity?: number | null;
     /** Physical 3D extrusion in metres. null restores the semantic-role default. */
     heightM?: number | null;
+    /** Degrees clockwise about the shape's own centre, as the canvas rotate handle
+     * stores it (normalised to 0–360). null or 0 clears it. */
+    rotation?: number | null;
+    /** Custom outline (polygon) only, one shape at a time: one curve per side,
+     * -100..100, side `i` from point `i` to point `i+1`, positive bows left of
+     * that side's direction. Same meaning as a section's edgeCurvature. null or
+     * an all-zero list makes every side straight again. */
+    edgeCurvature?: number[] | null;
     /** Event layouts that include this structure. null makes it common to all. */
     eventConfigurationIds?: string[] | null;
     /** Open line/polyline only. null restores the legacy round cap. */
@@ -1263,6 +1352,19 @@ declare function joinGAAreas(doc: ChartDoc, input: {
     changed: true;
 };
 
+/**
+ * A rectangle becomes a custom outline with the same four corners, fill,
+ * outline and turn, so it looks identical and can then be reshaped, curved
+ * and cut. Stages keep their own generated outline and are refused.
+ */
+declare function convertShapeToOutline(doc: ChartDoc, input: {
+    floorId?: string;
+    shapeId: string;
+}): {
+    floorId: string;
+    changed: boolean;
+    shapeId: string;
+};
 declare function updateShapes(doc: ChartDoc, input: {
     floorId?: string;
     shapeIds: string[];
@@ -1395,6 +1497,8 @@ declare function insertSeatingBlock(doc: ChartDoc, input: {
     idFactory: ChartObjectIdFactory;
     /** Section workspaces already provide the owning boundary. */
     wrapInSection?: boolean;
+    /** Degrees clockwise about `center` (the Designer's aimed ghost, R). */
+    rotation?: number;
 }): {
     floorId: string;
     blockKey: string;
@@ -1467,4 +1571,373 @@ declare function approveConfidenceEvidence(doc: ChartDoc, input: ConfidenceEvide
 }): ConfidenceEvidenceMutation;
 declare function retractConfidenceEvidence(doc: ChartDoc, target: ConfidenceEvidenceTarget): ConfidenceEvidenceMutation;
 
-export { type AddBoothArrayInput, type AddGAAreaInput, type AddRowBlockInput, type AddTableArrayInput, type ArcFanRowsInput, type ArcFanRowsPreview, type AutomaticPlacement, type BookableGridArrayInput, type BookableGridArrayOptions, type BookableGridArrayPreview, COLORBLIND_SAFE_PALETTE, type ChartObjectIdFactory, ChartOperationError, type ConfidenceEvidenceChange, type ConfidenceEvidenceIndex, type ConfidenceEvidenceIndexEntry, type ConfidenceEvidenceMutation, ConfidenceEvidenceScope, type ConfidenceEvidenceTarget, type CreationCategoryPlan, DEFAULT_FLOOR_HEIGHT_STEP_M, type GeneratedSectionPolygonConversionPreview, type JoinGAAreasOptions, type JoinGAAreasPreview, type LabelStylePatch, MAX_BUYER_IMAGE_URL_LENGTH, MAX_FLOOR_BASE_HEIGHT_M, type MergeRowsResult, type PolygonHolePreview, type ReassignColorblindSafeResult, type ReferenceScanApplyResult, type ReferenceScanPreview, type ReferenceScanRowsOptions, type ReferenceScanSectionOutcome, type ReferenceScanSkippedSection, type ReplaceRowBlockInput, type ReplaceRowBlockResult, type ResolveCreationCategoryOptions, type RowBlockSpacingResult, type RowCubicPathPreview, type SeatRef, type SectionBoundaryTransform, type SectionBoundaryTransformResult, type SectionEstimate, type SectionInventorySelectionSummary, type SectionRowFitInput, type SectionRowFitPreview, type SegmentedRowGroupResult, type SharedBoothPatch, type SharedCategoryPatch, type SharedGAAreaPatch, type SharedRowPatch, type SharedSeatOverridePatch, type SharedSectionMetadataPatch, type SharedShapePatch, type SharedTablePatch, type SharedTextPatch, type SharedThemePatch, type SharedZonePatch, type SplitRowResult, type StageLabelStylePatch, type StraightenAndSpaceResult, type VenueEstimateAim, addArcFanRows, addBookableGridArray, addBoothArray, addChartCategory, addChartFloor, addChartZone, addGAArea, addRowBlock, addTableArray, applyPolygonHole, applyReferenceScanRows, applySectionCornerSmoothing, applySectionEstimates, applySectionOutlineShaping, applySectionRowFit, approveConfidenceEvidence, arcFanInputForGroup, assignSectionInventoryCategory, automaticPlacementCenter, clearConfidenceEvidence, compactChartDoc, compactRowOverrides, compactTableOverrides, confidenceEvidenceChangeRequiresPublish, confidenceEvidenceChanges, confidenceEvidenceIndex, confirmReferenceCategoryOutputColor, convertGeneratedSectionToPolygon, countCoveredInventory, detectSeatLabelRun, dropRedundantSeatOverrideFields, familyCategoryLabel, gaAreaFootprint, groupRowsAsSegmented, insertSeatingBlock, isSafeBuyerImageUrl, joinGAAreas, mergeRows, mirrorFirstFloor, normalizeBuyerImageUrl, normalizeDraftEvidence, parseSeatRefId, pickColorblindSafeCategoryColor, planCreationCategory, previewArcFanRows, previewBookableGridArray, previewGeneratedSectionPolygonConversion, previewJoinGAAreas, previewPolygonHole, previewRemovePolygonHole, previewRowCubicPath, previewSectionRowFit, reassignColorblindSafeCategoryColors, relabelChartRows, removeChartCategory, removeChartFloor, removeChartObjects, removeChartZone, removePolygonHole, renameChartFloor, renameDirectSeatImportCategory, reorderChartCategories, replaceArcFanRows, replaceRowBlock, resetSeatOverrides, resizeShapes, resolveCreationCategory, retractConfidenceEvidence, roundBuyerCoordinates, seatRefId, seatSemanticsSignature, sectionInventorySelectionSummary, setConfidenceEvidence, setRowBlockSpacing, splitRow, straightenAndSpaceRows, transformSectionBoundary, transformSectionBoundaryObject, ungroupSegmentedRow, updateBooths, updateCategoryDefinitions, updateChartFloorBaseHeight, updateChartTheme, updateChartZones, updateGAAreas, updateRowCubicPath, updateRows, updateSeatOverrides, updateSectionExactPath, updateSectionMetadata, updateSegmentedRow, updateShapes, updateStageKinds, updateTables, updateTextObjects, updateViewFromSeatFallback };
+/** The step-free route's stroke: the accessibility blue buyers know. */
+declare const ROUTE_STROKE: {
+    readonly color: string;
+    readonly width: 4;
+};
+declare const DEFAULT_ROUTE_NAME = "Step-free route";
+interface GateSettings {
+    name?: string;
+    use?: GateUse;
+    stepFree?: boolean;
+    /** null clears. */
+    opens?: string | null;
+    hideFromBuyers?: boolean;
+}
+/** A new gate pill centred on `center`. Pure: nothing is added to a chart. */
+declare function gateShape(id: string, center: Point, settings: GateSettings & {
+    name: string;
+}, rotation?: number): GateShape;
+/** Add a named gate on a floor (the first when none is given). */
+declare function addGate(doc: ChartDoc, input: GateSettings & {
+    floorId?: string;
+    center: Point;
+    rotation?: number;
+    idFactory: ChartObjectIdFactory;
+}): {
+    changed: true;
+    floorId: string;
+    gate: GateShape;
+};
+/** Rename a gate or change what it is for; the places it serves follow. */
+declare function updateGate(doc: ChartDoc, input: {
+    gateId: string;
+    patch: GateSettings;
+}): {
+    changed: boolean;
+    gate: GateShape;
+    servedObjectIds: string[];
+};
+/** "Make this a gate": an old décor Entrance/Exit becomes a named gate in place. */
+declare function makeGate(doc: ChartDoc, input: GateSettings & {
+    shapeId: string;
+}): {
+    changed: true;
+    gate: GateShape;
+};
+/**
+ * Point places at a gate (or at none, with `gateId: null`). A section is set
+ * with every part of its logical section, so its parts never disagree.
+ */
+declare function setObjectEntrance(doc: ChartDoc, input: {
+    objectIds: string[];
+    gateId: string | null;
+}): {
+    changed: boolean;
+    objectIds: string[];
+};
+/**
+ * Removing gates: the places they served lose the reference, and the gate's
+ * name too where it came from the gate. Hand-typed entrances stay.
+ */
+declare function releaseGateReferences(doc: ChartDoc, removed: readonly ChartObject[]): string[];
+/** Copies that include their gate point at the copied gate; the rest keep the original. */
+declare function remapGateReferences(objects: readonly ChartObject[], ids: ReadonlyMap<string, string>): void;
+/** A named step-free route along `points`. Pure: nothing is added to a chart. */
+declare function routeShape(id: string, points: readonly Point[], name?: string, stepFree?: boolean): RouteShape;
+/** Add a named route (two or more points) on a floor. */
+declare function addRoute(doc: ChartDoc, input: {
+    floorId?: string;
+    points: Point[];
+    name?: string;
+    stepFree?: boolean;
+    idFactory: ChartObjectIdFactory;
+}): {
+    changed: true;
+    floorId: string;
+    route: RouteShape;
+};
+/** Make an open path a named route, change it, or (`route: null`) make it a plain line again. */
+declare function setRoute(doc: ChartDoc, input: {
+    shapeId: string;
+    route: {
+        stepFree?: boolean;
+        name?: string;
+    } | null;
+}): {
+    changed: boolean;
+    shape: ShapeObject;
+};
+
+/**
+ * Décor landmark palette — styled, ready-to-drop non-bookable objects that make
+ * a buyer map legible (bar, entrances, restrooms, screen, sound booth…). Today
+ * these are just `ShapeObject`s with an emoji-prefixed label, so they render
+ * with the current engine; the Batch-C designer palette drops them by preset
+ * and the renderer can later special-case icons/styling by the `role` field.
+ *
+ * A good seats.io-grade map is not only seats — it's the surroundings that let a
+ * buyer orient ("I want to sit near the bar / away from the speakers"). This
+ * palette is that vocabulary.
+ */
+
+type DecorRole = 'bar' | 'entrance' | 'exit' | 'restroom' | 'screen' | 'sound' | 'concession' | 'coat' | 'wall' | 'rail' | 'suite' | 'obstruction';
+
+/** Chart units per metre, as everywhere in the reference and 3D pipelines. */
+declare const DECOR_UNITS_PER_METRE = 40;
+type DecorSide = 'front' | 'rear' | 'left' | 'right';
+type DecorPlacement = AutomaticPlacement | 'center';
+interface DecorPlacementInput {
+    floorId?: string;
+    /** Beside the whole layout, or 'center' for the middle of it. Ignored when nearObjectId is set. */
+    placement?: DecorPlacement;
+    /** Place beside this object instead of beside the whole layout. */
+    nearObjectId?: string;
+    /** Which side of nearObjectId. Default rear. */
+    side?: DecorSide;
+    /** For front: move seats already in front of the stage back to make room (building a whole venue). */
+    makeRoom?: boolean;
+}
+/** Where a width x height addition goes, and a note when it could not go exactly there. */
+declare function decorPlacement(doc: ChartDoc, input: DecorPlacementInput & {
+    width: number;
+    height: number;
+}): {
+    center: Point;
+    note?: string;
+};
+/** Centre for a width x height addition, placed as the caller described in words. */
+declare function decorPlacementCenter(doc: ChartDoc, input: DecorPlacementInput & {
+    width: number;
+    height: number;
+}): Point;
+interface AddStageInput extends DecorPlacementInput {
+    kind: StageKind;
+    label?: string;
+    widthM?: number;
+    depthM?: number;
+    idFactory: ChartObjectIdFactory;
+}
+/**
+ * Add a stage (or playing surface). When the floor had no stage, the floor's
+ * focal point moves to its front edge, as the Designer does, so seat views
+ * and sightlines look at it.
+ */
+declare function addStage(doc: ChartDoc, input: AddStageInput): {
+    floorId: string;
+    stageId: string;
+    label: string;
+    focalPointMoved: boolean;
+    createdIds: string[];
+};
+interface AddLandmarkInput extends DecorPlacementInput {
+    role: DecorRole;
+    label?: string;
+    idFactory: ChartObjectIdFactory;
+}
+/** Add a landmark from the Designer's décor palette: bar, entrance, exit, restrooms, screen… */
+declare function addLandmark(doc: ChartDoc, input: AddLandmarkInput): {
+    floorId: string;
+    landmarkId: string;
+    label: string | null;
+    createdIds: string[];
+    note?: string;
+};
+type DecorTextSize = 'small' | 'medium' | 'large';
+type DecorShowAt = 'always' | 'when-it-fits' | 'close-up';
+interface AddTextInput extends DecorPlacementInput {
+    text: string;
+    size?: DecorTextSize;
+    color?: string;
+    bold?: boolean;
+    showAt?: DecorShowAt;
+    idFactory: ChartObjectIdFactory;
+}
+/** Add a free text label, e.g. "Gate C", "Level 2 bar", "Step-free route". */
+declare function addText(doc: ChartDoc, input: AddTextInput): {
+    floorId: string;
+    textId: string;
+    createdIds: string[];
+    note?: string;
+};
+interface AddIconInput extends DecorPlacementInput {
+    iconKey: string;
+    showAt?: DecorShowAt;
+    idFactory: ChartObjectIdFactory;
+}
+/** Add a wayfinding icon from the venue icon set (restrooms, first aid, stairs, lift…). */
+declare function addIcon(doc: ChartDoc, input: AddIconInput): {
+    floorId: string;
+    iconId: string;
+    createdIds: string[];
+    note?: string;
+};
+/**
+ * A named area's default floor. Every renderer writes a plain shape's name in
+ * light ink (#cbd5e1), so the floor must be dark enough for that name to read:
+ * a pale floor made "Dance floor" invisible in the Designer.
+ */
+declare const NAMED_AREA_FILL = "#4b5568";
+interface AddAreaInput extends DecorPlacementInput {
+    label: string;
+    shape?: 'rect' | 'ellipse';
+    widthM: number;
+    depthM: number;
+    fill?: string;
+    idFactory: ChartObjectIdFactory;
+}
+/** Add a plain named area that is not sold: a dance floor, a registration desk, a lobby. */
+declare function addArea(doc: ChartDoc, input: AddAreaInput): {
+    floorId: string;
+    areaId: string;
+    createdIds: string[];
+    note?: string;
+};
+/** Every landmark role an agent may ask for, with its Designer name. */
+declare function landmarkRoles(): Array<{
+    role: DecorRole;
+    label: string;
+}>;
+
+/** Row curve in words, as degrees of bend. */
+declare const ROW_CURVE_DEGREES: {
+    readonly straight: 0;
+    readonly gentle: 15;
+    readonly medium: 30;
+    readonly strong: 45;
+};
+type RowCurveStyle = keyof typeof ROW_CURVE_DEGREES;
+interface AddPlacedRowBlocksInput {
+    floorId?: string;
+    rowCount: number;
+    seatsPerRow: number;
+    categoryKey: string;
+    placement?: AutomaticPlacement;
+    curveStyle?: RowCurveStyle;
+    blockStyle?: 'multiple' | 'intertwined';
+    /** focal-tangent turns a single block to face the stage. */
+    orientation?: 'focal-tangent' | 'horizontal';
+    /** Side-by-side blocks with an aisle between each. Default 1. */
+    blocks?: number;
+    aisleWidth?: number;
+    /** One section name per block, or none. */
+    sectionLabels?: string[];
+    /** Seats per row in each block, when blocks differ (e.g. 13 and 12); default seatsPerRow in every block. */
+    blockSeats?: number[];
+    /** For front: move seats already in front of the stage back to make room (building a whole venue). */
+    makeRoom?: boolean;
+    idFactory: ChartObjectIdFactory;
+}
+/**
+ * One block of rows beside the layout (two passes: place the flat footprint,
+ * derive the bearing there, then reserve the ROTATED footprint so an angled
+ * block cannot land on geometry its flat box would have cleared), or several
+ * blocks side by side with aisles between them.
+ */
+declare function addPlacedRowBlocks(doc: ChartDoc, input: AddPlacedRowBlocksInput): {
+    floorId: string;
+    rowIds: string[];
+    sectionIds: string[];
+    createdIds: string[];
+    note?: string;
+};
+/** Names for side-by-side blocks of one named section: Stalls Left, Stalls Right. */
+declare function blockSectionLabels(name: string, blocks: number): string[];
+declare function addPlacedTableArray(doc: ChartDoc, input: {
+    floorId?: string;
+    tableRows: number;
+    tableColumns: number;
+    seatsPerTable?: number;
+    shape?: 'round' | 'rect';
+    categoryKey: string;
+    placement?: AutomaticPlacement;
+    makeRoom?: boolean;
+    idFactory: ChartObjectIdFactory;
+}): {
+    floorId: string;
+    tableIds: string[];
+    createdIds: string[];
+} | {
+    note: string;
+    floorId: string;
+    tableIds: string[];
+    createdIds: string[];
+};
+declare function addPlacedGAArea(doc: ChartDoc, input: {
+    floorId?: string;
+    capacity: number;
+    categoryKey: string;
+    label?: string;
+    displayLabel?: string;
+    placement?: AutomaticPlacement;
+    makeRoom?: boolean;
+    idFactory: ChartObjectIdFactory;
+}): {
+    floorId: string;
+    gaAreaId: string;
+    label: string;
+    createdIds: string[];
+} | {
+    note: string;
+    floorId: string;
+    gaAreaId: string;
+    label: string;
+    createdIds: string[];
+};
+declare function addPlacedBoothArray(doc: ChartDoc, input: {
+    floorId?: string;
+    boothRows: number;
+    boothColumns: number;
+    categoryKey: string;
+    placement?: AutomaticPlacement;
+    makeRoom?: boolean;
+    idFactory: ChartObjectIdFactory;
+}): {
+    floorId: string;
+    boothIds: string[];
+    createdIds: string[];
+} | {
+    note: string;
+    floorId: string;
+    boothIds: string[];
+    createdIds: string[];
+};
+/**
+ * Where a fan of curved rows goes: centred on the floor's focal point, aimed
+ * at where the audience already is (bearing in degrees, 0 = straight down the
+ * page, the arc-fan convention), and starting beyond the seats already in
+ * that direction.
+ */
+declare function curvedRowsPlacement(doc: ChartDoc, floorId: string | undefined, spreadDegrees: number): {
+    center: Point;
+    bearing: number;
+    occupiedRadius: number;
+    floorId: string;
+    clearRadius: (spread: number) => number;
+};
+interface AddCurvedRowsInput {
+    floorId?: string;
+    rowCount: number;
+    /** How wide the fan is; 180 = semicircle. Default: fits seatsPerRow, else 100. */
+    spreadDegrees?: number;
+    /** Seats in every row; default fits seats at the standard pitch. */
+    seatsPerRow?: number;
+    /** Metres from the stage to the first row. Default 4. */
+    firstRowDistanceM?: number;
+    aisles?: 'none' | 'center' | 'two';
+    categoryKey: string;
+    sectionLabel?: string;
+    idFactory: ChartObjectIdFactory;
+}
+/** Curved rows around the stage, beyond any seats already in that direction. */
+declare function addCurvedRows(doc: ChartDoc, input: AddCurvedRowsInput): {
+    spreadDegrees: number;
+    movedBackIds: string[];
+    floorId: string;
+    logicalRowCount: number;
+    rowSegmentCount: number;
+    totalSeats: number;
+    innerRadius: number;
+    outerRadius: number;
+    minSeatSpacing: number;
+    maxSeatSpacing: number;
+    maxPitchDeviation: number;
+    aisleCount: number;
+    warnings: string[];
+    rowIds: string[];
+    sectionId: string | null;
+    groupId: string;
+};
+
+export { type AddAreaInput, type AddBoothArrayInput, type AddCurvedRowsInput, type AddGAAreaInput, type AddIconInput, type AddLandmarkInput, type AddPlacedRowBlocksInput, type AddRowBlockInput, type AddStageInput, type AddTableArrayInput, type AddTextInput, type ArcFanRowsInput, type ArcFanRowsPreview, type AutomaticPlacement, type BookableGridArrayInput, type BookableGridArrayOptions, type BookableGridArrayPreview, type BookablePresentationPatch, COLORBLIND_SAFE_PALETTE, type CategoryDraft, type ChartObjectIdFactory, ChartOperationError, type ConfidenceEvidenceChange, type ConfidenceEvidenceIndex, type ConfidenceEvidenceIndexEntry, type ConfidenceEvidenceMutation, ConfidenceEvidenceScope, type ConfidenceEvidenceTarget, type CreationCategoryPlan, DECOR_UNITS_PER_METRE, DEFAULT_FLOOR_HEIGHT_STEP_M, DEFAULT_ROUTE_NAME, type DecorPlacement, type DecorPlacementInput, type DecorShowAt, type DecorSide, type DecorTextSize, FIRST_CATEGORY_COLOURS, type GateSettings, type GeneratedSectionPolygonConversionPreview, type JoinGAAreasOptions, type JoinGAAreasPreview, type LabelStylePatch, MAX_BUYER_IMAGE_URL_LENGTH, MAX_FLOOR_BASE_HEIGHT_M, type MergeRowsResult, NAMED_AREA_FILL, type PolygonHolePreview, ROUTE_STROKE, ROW_CURVE_DEGREES, type ReassignColorblindSafeResult, type ReferenceScanApplyResult, type ReferenceScanPreview, type ReferenceScanRowsOptions, type ReferenceScanSectionOutcome, type ReferenceScanSkippedSection, type ReplaceRowBlockInput, type ReplaceRowBlockResult, type ResolveCreationCategoryOptions, type RowBlockSpacingResult, type RowCubicPathPreview, type RowCurveStyle, type SeatRef, type SectionBoundaryTransform, type SectionBoundaryTransformResult, type SectionEstimate, type SectionInventorySelectionSummary, type SectionRowFitInput, type SectionRowFitPreview, type SegmentedRowGroupResult, type SharedBoothPatch, type SharedCategoryPatch, type SharedGAAreaPatch, type SharedRowPatch, type SharedSeatOverridePatch, type SharedSectionMetadataPatch, type SharedShapePatch, type SharedTablePatch, type SharedTextPatch, type SharedThemePatch, type SharedZonePatch, type SplitRowResult, type StageLabelStylePatch, type StraightenAndSpaceResult, type VenueEstimateAim, addArcFanRows, addArea, addBookableGridArray, addBoothArray, addChartCategories, addChartCategory, addChartFloor, addChartZone, addCurvedRows, addGAArea, addGate, addIcon, addLandmark, addPlacedBoothArray, addPlacedGAArea, addPlacedRowBlocks, addPlacedTableArray, addRoute, addRowBlock, addStage, addTableArray, addText, applyPolygonHole, applyReferenceScanRows, applySectionCornerSmoothing, applySectionEstimates, applySectionOutlineShaping, applySectionRowFit, approveConfidenceEvidence, arcFanInputForGroup, assignSectionInventoryCategory, automaticPlacementCenter, blockSectionLabels, clearConfidenceEvidence, compactChartDoc, compactRowOverrides, compactTableOverrides, confidenceEvidenceChangeRequiresPublish, confidenceEvidenceChanges, confidenceEvidenceIndex, confirmReferenceCategoryOutputColor, convertGeneratedSectionToPolygon, convertShapeToOutline, countCoveredInventory, curvedRowsPlacement, decorPlacement, decorPlacementCenter, detectSeatLabelRun, dropRedundantSeatOverrideFields, familyCategoryLabel, gaAreaFootprint, gateShape, groupRowsAsSegmented, insertSeatingBlock, isSafeBuyerImageUrl, joinGAAreas, landmarkRoles, makeGate, mergeRows, mirrorFirstFloor, normalizeBuyerImageUrl, normalizeDraftEvidence, parseSeatRefId, pickColorblindSafeCategoryColor, planCreationCategory, previewArcFanRows, previewBookableGridArray, previewGeneratedSectionPolygonConversion, previewJoinGAAreas, previewPolygonHole, previewRemovePolygonHole, previewRowCubicPath, previewSectionRowFit, reassignColorblindSafeCategoryColors, relabelChartRows, releaseGateReferences, remapGateReferences, removeCategoryMovingInventory, removeChartCategory, removeChartFloor, removeChartObjects, removeChartZone, removePolygonHole, renameChartFloor, renameDirectSeatImportCategory, reorderChartCategories, replaceArcFanRows, replaceRowBlock, resetSeatOverrides, resizeShapes, resolveCreationCategory, retractConfidenceEvidence, roundBuyerCoordinates, routeShape, seatRefId, seatSemanticsSignature, sectionInventorySelectionSummary, setConfidenceEvidence, setObjectEntrance, setRoute, setRowBlockSpacing, splitRow, straightenAndSpaceRows, transformSectionBoundary, transformSectionBoundaryObject, ungroupSegmentedRow, uniqueCategoryLabel, updateBooths, updateCategoryDefinitions, updateChartFloorBaseHeight, updateChartTheme, updateChartZones, updateGAAreas, updateGate, updateRowCubicPath, updateRows, updateSeatOverrides, updateSectionExactPath, updateSectionMetadata, updateSegmentedRow, updateShapes, updateStageKinds, updateTables, updateTextObjects, updateViewFromSeatFallback };