@seatlayer/core 0.71.4 → 0.72.0

package/dist/{types-0yruRsAj.d.cts → types-D6-wLa-m.d.cts}

@@ -1,3 +1,18 @@
+/** Typography owned by a Stage caption. Stage text is a real editable label,
+ * but remains centred on and rotated with its Stage rather than becoming a
+ * separately positioned Text object. `bold` is true when absent to preserve
+ * the long-standing Stage treatment; false is therefore meaningful. */
+interface StageLabelStyle {
+    color?: string;
+    size?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+}
+/** Stages are large focal objects and need the same useful size range as Text. */
+declare const STAGE_LABEL_STYLE_MAX_SIZE = 72;
+
 /** Durable publishing-review evidence for an editable physical 3D property. */
 interface Physical3dEvidence {
     status: 'inferred' | 'confirmed';
@@ -48,6 +63,18 @@ interface ReferenceScanRowProposal {
     start: Point;
     end: Point;
     seatCount: number;
+    /** Browser-only reviewed direct-seat identity. Server scans never set this;
+     * chartOps still validates and collision-allocates it before materializing. */
+    rowLabel?: string;
+    /** Browser-only visible row identity for a reviewed sectionless direct plan.
+     * It is presentation-only; `rowLabel` remains the collision-safe inventory
+     * identity. Server scans never set this field. */
+    rowDisplayLabel?: string;
+    /** Local-only correlation for an explicitly reviewed row identity. The
+     * server never supplies it; chartOps sanitizes before persisting it. */
+    directSourceRowId?: string;
+    /** The explicitly approved suffix only — never the generated fallback. */
+    directReviewedSuffix?: string;
 }
 /** Detected rows attributed to one compiled section (or unattributed when the
  *  lattice extends outside every compiled polygon). */
@@ -61,14 +88,20 @@ interface ReferenceScanSectionProposal {
     confidence: number;
     /** Index of the seed (multi-probe) whose pitch produced these rows. */
     seedIndex: number;
+    /** Local-only correlation for a reviewed sectionless direct-seat group.
+     * Server scans never need or return this field. */
+    sourceGroupId?: string;
 }
 /** Server response for an in-canvas reference scan. A PROPOSAL — nothing is
  *  committed until the author applies it in the designer (chartOps + undo). */
 interface ReferenceScanProposal {
     assetId: string;
-    /** Measured seat diameter / centre-to-centre pitch, in chart units. */
+    /** Measured seat diameter / centre-to-centre pitches, in chart units. */
     seatDiameter: number;
     seatPitch: number;
+    /** Perpendicular centre-to-centre spacing between inferred rows. Server
+     * scans include this; older/direct proposals may omit it. */
+    rowPitch?: number;
     totalSeats: number;
     totalRows: number;
     sections: ReferenceScanSectionProposal[];
@@ -238,10 +271,80 @@ interface ReferenceExtractRegionSeats {
     seatCount: number;
     /** 0..1 — how well the region's own lattice agreed with its pitch. */
     confidence: number;
-    seedOrigin: 'auto-fit';
+    /** Repeated primitives are measured directly; auto-fit rows are inferred from a
+     *  seeded lattice. The review uses this distinction before trusting a very
+     *  wide or very small region as real seating. */
+    seedOrigin: 'auto-fit' | 'repeated-primitives';
+    /** Safe bulk-selection default. Ambiguous repeated-symbol rows with nearby
+     *  annotations require explicit review instead of being silently included. */
+    reviewDisposition?: 'likely-seating' | 'needs-review';
+    reviewReason?: 'annotation-near-repeated-symbols';
     /** Present when no lattice was found in this region. */
     emptyReason?: ReferenceExtractEmptyReason;
 }
+/** One measured group in a sectionless seating plan. The group exists only so
+ * the author can review related rows together; it never becomes a Section. */
+interface ReferenceDirectSeatGroup {
+    /** Stable within one direct reread. Its derived `groupId:index` may be
+     * persisted only beside an explicitly reviewed row-identity suffix, so a
+     * fresh same-reference review can restore that author decision. */
+    id: string;
+    /** Exact measured row endpoints in chart coordinates. */
+    rows: ReferenceScanRowProposal[];
+    seatCount: number;
+    confidence: number;
+    /** Source evidence used to seed a category on an otherwise blank chart. The
+     * author still owns its final name, accessible display colour and pricing. */
+    sampledColor?: string;
+    /** Ambiguous repeated symbols are withheld from bulk selection. */
+    reviewDisposition: 'likely-seating' | 'needs-review';
+    reviewReason?: 'annotation-near-repeated-symbols';
+}
+/** The small, source-derived non-bookable areas found alongside a direct-seat
+ * read. They deliberately remain separate from seating groups: accepting one
+ * never creates a Section, category, row, or inventory. `bounds` are issued
+ * by the raster reader in chart coordinates; an AI reader may only enrich this
+ * id with text and a role, never supply replacement coordinates. */
+type ReferenceDirectLandmarkRole = 'stage' | 'platform' | 'aisle' | 'ramp' | 'entrance' | 'exit' | 'other-label';
+type ReferenceDirectLandmarkDisposition = 'recommended' | 'needs-review' | 'rejected';
+interface ReferenceDirectLandmarkCandidate {
+    /** Stable server-issued handle within this direct reread. */
+    id: string;
+    /** Chart-space bounding box measured from the source raster. */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Exact chart-space perimeter. It remains a rectangle on an unrotated
+     * reference but preserves the source registration under rotation/crop. */
+    outline: Point[];
+    /** `area` carries non-bookable geometry; `text` carries a printed caption
+     * only. A text candidate never paints a fabricated box behind the source. */
+    kind: 'area' | 'text';
+    /** Non-semantic sampled source colour, if the raster reader measured one. */
+    sampledColor?: string;
+    /** A deterministic reader may offer an unlabelled landmark; only an accepted
+     * reader result can add printed text or a more specific role. */
+    text?: string;
+    role: ReferenceDirectLandmarkRole;
+    reviewDisposition: ReferenceDirectLandmarkDisposition;
+}
+/** A sectionless alternative to the normal section-first extract proposal.
+ * It contains only directly measured seating rows, never inferred sections. */
+interface ReferenceDirectSeatPlan {
+    assetId: string;
+    groups: ReferenceDirectSeatGroup[];
+    seatDiameter: number;
+    seatPitch: number;
+    totalLikelySeats: number;
+    totalNeedsReviewSeats: number;
+    excludedBlankTiles: number;
+    /** Non-bookable source landmarks. This does not alter the deliberately
+     * sectionless direct-seat flow. */
+    landmarks?: ReferenceDirectLandmarkCandidate[];
+}
 interface ReferenceExtractProposal {
     assetId: string;
     floorId: string;
@@ -252,6 +355,9 @@ interface ReferenceExtractProposal {
     seatPitch: number;
     totalSeats: number;
     totalRows: number;
+    /** Present only when the reader found a credible sectionless repeated-seat
+     * population. `sections` and `seatsByRegionId` are then deliberately empty. */
+    directSeatPlan?: ReferenceDirectSeatPlan;
     diagnostics: ReferenceSectionTraceBatchProposal['diagnostics'] & {
         scannedRegionCount: number;
         emptyRegionCount: number;
@@ -274,6 +380,9 @@ interface ReferenceExtractProposal {
         namesOutcome?: string;
         /** Why the model-assisted fallback produced nothing, when it ran and did not ('ok' / 'not-needed' otherwise). */
         assistOutcome?: string;
+        /** Direct-seat non-bookable landmark text/role pass. This is separate from
+         * section assistance and degrades to source-only review on any failure. */
+        annotationsOutcome?: string;
         /**
          * How well the plan could be read, so the review can be honest: coverage
          * is the share of the plan's drawn extent covered by proposed regions;
@@ -352,6 +461,14 @@ interface ReferenceExtractEnrichment {
         seatsByRegionId: Record<string, ReferenceExtractRegionSeats>;
         outcome?: string;
     };
+    /** Optional direct-seat landmark text/role enrichment. It is discriminated
+     * from section assistance so ordinary section enrichment remains unchanged. */
+    annotations?: {
+        status: ReferenceEnrichmentStatus;
+        /** Server-issued candidate id → accepted text/role only; never geometry. */
+        values: Record<string, Pick<ReferenceDirectLandmarkCandidate, 'text' | 'role' | 'reviewDisposition'>>;
+        outcome?: string;
+    };
     updatedAt: number;
 }
 /** Coordinate-free physical scale derived by server code from a confirmed
@@ -371,6 +488,10 @@ interface ChartReferenceImage {
     assetId?: string;
     /** Legacy/self-contained source. Optional when assetId is present. */
     url?: string;
+    /** The author-picked filename, retained only with the private trace. */
+    sourceName?: string;
+    /** One-based source page when a PDF was rasterised before attachment. */
+    sourcePage?: number;
     center: Point;
     /** Rendered width in chart units (height follows the cropped image aspect). */
     width: number;
@@ -389,6 +510,26 @@ interface ChartReferenceImage {
     calibration?: ReferenceCalibration;
     /** Server-derived semantic calibration without source-image coordinates. */
     derivedScale?: ReferenceDerivedScale;
+    /**
+     * Authoring-only import intent retained with this private source. Large plans
+     * begin as a reviewable section map; seats are then authored per section.
+     * A newly attached reference starts without this intent by construction.
+     */
+    importWorkflow?: 'section-map-first';
+    /** Private reviewed choices for direct-plan non-bookable annotations. Kept on
+     * the source placement so a reread can restore an explicit exclusion without
+     * turning a hidden review decision into a fake chart object. */
+    directLandmarkReview?: {
+        kind: 'direct-landmark-review-v1';
+        referenceGeometrySignature: string;
+        values: Array<{
+            candidateId: string;
+            candidateGeometrySignature: string;
+            include: boolean;
+            text?: string;
+            role?: ReferenceDirectLandmarkRole;
+        }>;
+    };
 }
 /** Private, authoring-only evidence that one bounded planar CAD source was
  * registered against independently checked chart control points. Raw source
@@ -436,16 +577,6 @@ interface RadialClearanceLayoutConstraint {
 }
 type ChartLayoutConstraint = RadialClearanceLayoutConstraint;
 
-/**
- * SeatMap chart document — the single source of truth shared by the
- * Designer (authoring) and the Renderer (buyer picker).
- *
- * Coordinates are abstract units (roughly "pixels at scale 1"); the renderer
- * fits the chart to its container.
- * Rows are PARAMETRIC (origin + count + spacing + curve + rotation) — never
- * store per-seat coordinates in the document; expansion happens in layout.ts.
- */
-
 interface Point {
     x: number;
     y: number;
@@ -500,6 +631,13 @@ interface Category {
     /** Durable evidence for semantic/display facts proposed while converting a
      * private reference into sellable inventory. */
     referenceCategorySource?: ReferenceCategorySource;
+    /**
+     * Narrow ownership marker for a category minted by the sectionless
+     * direct-seat reader. It deliberately records no pricing or label evidence:
+     * it only lets a later read of the same private asset replace its own
+     * provisional category without ever borrowing a commercial category.
+     */
+    referenceDirectSeatImport?: ReferenceDirectSeatImportSource;
     /**
      * Ticket tiers (Adult / Child / Senior…). When present, a buyer picks a tier
      * per seat in this category and the tier's price applies; the first tier is the
@@ -541,6 +679,14 @@ interface ReferenceCategorySource {
     outputColorEvidence?: 'user-confirmed' | 'authoritative-source';
     outputColorSourceDescription?: string;
 }
+/** Stable identity for a provisional category created by direct-seat import.
+ * This is intentionally separate from `ReferenceCategorySource`, whose
+ * evidence contract requires user-confirmed commercial facts. */
+interface ReferenceDirectSeatImportSource {
+    assetId: string;
+    /** Deterministic direct-seat source-colour cluster identity. */
+    familyId: string;
+}
 /** One ticket tier within a category: a named price (Adult, Child, Senior…). */
 interface CategoryTier {
     id: string;
@@ -774,11 +920,10 @@ declare function seatCommercialMeta(key: SeatCommercialMark): SeatCommercialMeta
  * Per-object label ink + size overrides layered on top of the chart-wide Theme
  * defaults (rowLabelColor / textColor for rows, the section-name ink for
  * sections). Both fields are optional: an absent field means "inherit the theme
- * default". `color` is a preferred hex — renderers still pass it through the
- * shared auto-contrast rule (`stateAwareBookableLabelInk`), so a choice that
- * would be illegible over the seat/section background is switched to black or
- * white at paint time. `size` is a font size in chart units, clamped to
- * LABEL_STYLE_MIN_SIZE..LABEL_STYLE_MAX_SIZE by the shared ops.
+ * default". For seats, rows, and sections, `color` is a preferred hex passed
+ * through the shared auto-contrast rule (`stateAwareBookableLabelInk`). A Stage
+ * uses its explicitly authored color exactly; clearing it returns to Automatic.
+ * `size` is a font size in chart units, clamped by the relevant object ops.
  */
 /**
  * How the stacked "All floors" view marks each level: the authored floor name,
@@ -793,6 +938,7 @@ interface LabelStyle {
 /** Clamp bounds for a per-object label `size`, shared by ops, MCP, and UI. */
 declare const LABEL_STYLE_MIN_SIZE = 8;
 declare const LABEL_STYLE_MAX_SIZE = 24;
+
 interface LabelPresentation {
     visible?: boolean;
     /** Exact Designer-owned label anchor; public semantic MCP schemas omit it. */
@@ -856,7 +1002,7 @@ interface ChartTheme {
     textColor?: string;
     /** Font family (CSS stack) for all rendered text — row labels, seat numbers, sections, décor text. */
     fontFamily?: string;
-    /** Seat size multiplier on the base radius (0.7–1.6, default 1) — bigger seats fit longer labels. */
+    /** Seat-mark size multiplier (0.15–1.6, default 1); interaction keeps separate screen-space assistance. */
     seatScale?: number;
     /** Brand accent color — recolors buttons, links, the hold pill, selection UI. */
     accent?: string;
@@ -877,9 +1023,16 @@ interface RowObject extends AuthoringObjectState {
     /** Present when this row was materialized by the in-canvas reference scan.
      *  A re-scan of the same asset replaces rows carrying this marker and NEVER
      *  touches hand-authored rows — the same replace-generated-only invariant as
-     *  applyReferenceInventory. */
+     *  applyReferenceInventory. A section-local scan additionally carries the
+     *  immutable section identity, so replacing one local scan cannot infer
+     *  ownership from a row's current centre after a boundary reshape. */
     referenceScan?: {
         assetId: string;
+        sectionId?: string;
+        /** Direct-seat reread correlation. Both fields are author-reviewed local
+         * provenance, never emitted by server-side scans. */
+        directSourceRowId?: string;
+        directReviewedSuffix?: string;
     };
     /** Row label, e.g. "A". Seat labels are `${label}-${n}`. */
     label: string;
@@ -1161,6 +1314,8 @@ interface ShapeObject extends AuthoringObjectState {
      */
     kind: 'rect' | 'ellipse' | 'polygon' | 'line' | 'polyline';
     label?: string;
+    /** Per-stage caption typography. Absent family/color fields inherit the theme. */
+    labelStyle?: StageLabelStyle;
     /** For rect/ellipse: bounding box. For a stage polygon: the base (pre-shape) box, so its kind can be regenerated. */
     x?: number;
     y?: number;
@@ -1204,6 +1359,11 @@ interface ShapeObject extends AuthoringObjectState {
     role?: string;
     /** For a stage: which `StageKind` its polygon was generated from. */
     stageKind?: string;
+    /** Public buyer-safe render priority for an approved orientation label. */
+    labelImportance?: 'orientation';
+    /** Private source marker for a reviewed direct-plan landmark. Generic edits
+     * relinquish it so a later reread cannot overwrite organizer-authored décor. */
+    referenceAnnotationSource?: ReferenceDirectAnnotationSource;
 }
 type RectTableSide = 'top' | 'bottom' | 'left' | 'right';
 /** Exact rectangular-table chair distribution. The four keys are deliberately
@@ -1530,6 +1690,26 @@ interface TextObject extends AuthoringObjectState {
     opacity?: number;
     /** Optional padded background painted behind the exact text box. */
     background?: TextBackground;
+    /** Public buyer-safe render priority for an approved orientation label. */
+    labelImportance?: 'orientation';
+    /** Private source marker paired with a reviewed direct-plan landmark shape. */
+    referenceAnnotationSource?: ReferenceDirectAnnotationSource;
+}
+/** Private ownership of a non-bookable annotation materialized from a direct
+ * reference review. It is stripped from copied/user-authored duplicates. */
+interface ReferenceDirectAnnotationSource {
+    kind: 'direct-landmark-v1';
+    assetId: string;
+    candidateId: string;
+    /** The candidate's exact server-issued perimeter signature. */
+    candidateGeometrySignature: string;
+    /** The floor-plan transform that made this source geometry meaningful. */
+    referenceGeometrySignature: string;
+    role: ReferenceDirectLandmarkRole;
+    /** Generic edits deliberately retain this narrow source correlation but turn
+     * ownership over to the organizer. Rereads then restore rather than replace
+     * the edited landmark, and copied objects still strip it entirely. */
+    ownership?: 'reference' | 'organizer';
 }
 /**
  * A raster/vector decor graphic drawn IN the chart, beneath the seats and
@@ -1700,4 +1880,4 @@ interface ChartDoc {
     confidenceEvidence?: SeatConfidenceEvidence;
 }
 
-export { type ReferenceExtractEnrichment as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type AuthoringObjectState as D, type ChartLayoutConstraint as E, type FloorLabelStyle as F, type GAAreaObject as G, type ChartTheme as H, type ConfidenceEvidenceScope as I, type DecorImageObject as J, LABEL_STYLE_MAX_SIZE as K, type LabelStyle as L, LABEL_STYLE_MIN_SIZE as M, type LabelPresentation as N, type ObjectEditorState as O, type Point as P, type Physical3dEvidence as Q, type RowObject as R, type SeatCommercialAttributes as S, type TableObject as T, type RadialClearanceLayoutConstraint as U, type ReferenceAccessibilitySource as V, type ReferenceCalibration as W, type ReferenceCategorySource as X, type ReferenceDerivedScale as Y, type ReferenceEnrichmentStatus as Z, type ReferenceExtractEmptyReason as _, type ChartObject as a, type ReferenceExtractInput as a0, type ReferenceExtractProposal as a1, type ReferenceExtractRegionSeats as a2, type ReferenceInventoryExclusionSource as a3, type ReferenceInventorySource as a4, type ReferenceMatchReport as a5, type ReferenceScanProposal as a6, type ReferenceScanRowProposal as a7, type ReferenceScanSectionProposal as a8, type ReferenceSeatSeed as a9, seatCommercialMeta as aA, type ReferenceSectionTraceBatchInput as aa, type ReferenceSectionTraceBatchProposal as ab, type ReferenceSectionTraceInput as ac, type ReferenceSectionTraceProposal as ad, SEAT_COMMERCIAL_MARKS as ae, SURROUNDINGS_SHAPE_ROLES as af, type SeatCommercialMark as ag, type SeatCommercialMeta as ah, type SeatConfidenceCoverage as ai, type SeatConfidenceEvidence as aj, type SeatConfidenceModelLevel as ak, type SeatConfidenceModeledTarget as al, type SeatConfidenceRealityLevel as am, type SeatViewVariant as an, type SelectionLayer as ao, type TextAlignment as ap, type TextBackground as aq, type TicketTierApplicability as ar, type TicketTierEvidence as as, type TicketTierRestriction as at, type Venue3DMaterialPalette as au, type VenueSurveyRegistrationEvidence as av, type ZoneDef as aw, accessibilityMeta as ax, accessibilityRingColor as ay, layerOf as az, type SeatViewMetadata as b, type ResolvedSeatConfidenceEvidence as c, type SeatGlyphKind as d, type SeatViewCoverage as e, type SectionOutlinePath as f, type SectionPathSegment as g, type GAInventorySegment as h, type CategoryTier as i, type SeatOverride as j, type RectTableSide as k, type Floor as l, type SectionObject as m, type RectTableSeatCounts as n, type ChartReferenceImage as o, type Category as p, type ShapeLineCap as q, type ShapeLineEnding as r, type ShapeLineJoin as s, type ShapeObject as t, type CubicPath as u, type TextObject as v, type ChartDeliveryPerformance as w, ACCESSIBILITY_RING_COLOR as x, ACCESSIBILITY_TYPES as y, type AccessibilityMeta as z };
+export { type ReferenceDirectLandmarkDisposition as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type AuthoringObjectState as D, type ChartLayoutConstraint as E, type FloorLabelStyle as F, type GAAreaObject as G, type ChartTheme as H, type ConfidenceEvidenceScope as I, type DecorImageObject as J, LABEL_STYLE_MAX_SIZE as K, type LabelStyle as L, LABEL_STYLE_MIN_SIZE as M, type LabelPresentation as N, type ObjectEditorState as O, type Point as P, type Physical3dEvidence as Q, type RowObject as R, type SeatCommercialAttributes as S, type TableObject as T, type RadialClearanceLayoutConstraint as U, type ReferenceAccessibilitySource as V, type ReferenceCalibration as W, type ReferenceCategorySource as X, type ReferenceDerivedScale as Y, type ReferenceDirectAnnotationSource as Z, type ReferenceDirectLandmarkCandidate as _, type ChartObject as a, type ReferenceDirectLandmarkRole as a0, type ReferenceDirectSeatGroup as a1, type ReferenceDirectSeatImportSource as a2, type ReferenceDirectSeatPlan as a3, type ReferenceEnrichmentStatus as a4, type ReferenceExtractEmptyReason as a5, type ReferenceExtractEnrichment as a6, type ReferenceExtractInput as a7, type ReferenceExtractProposal as a8, type ReferenceExtractRegionSeats as a9, type TicketTierApplicability as aA, type TicketTierEvidence as aB, type TicketTierRestriction as aC, type Venue3DMaterialPalette as aD, type VenueSurveyRegistrationEvidence as aE, type ZoneDef as aF, accessibilityMeta as aG, accessibilityRingColor as aH, layerOf as aI, seatCommercialMeta as aJ, type ReferenceInventoryExclusionSource as aa, type ReferenceInventorySource as ab, type ReferenceMatchReport as ac, type ReferenceScanProposal as ad, type ReferenceScanRowProposal as ae, type ReferenceScanSectionProposal as af, type ReferenceSeatSeed as ag, type ReferenceSectionTraceBatchInput as ah, type ReferenceSectionTraceBatchProposal as ai, type ReferenceSectionTraceInput as aj, type ReferenceSectionTraceProposal as ak, SEAT_COMMERCIAL_MARKS as al, STAGE_LABEL_STYLE_MAX_SIZE as am, SURROUNDINGS_SHAPE_ROLES as an, type SeatCommercialMark as ao, type SeatCommercialMeta as ap, type SeatConfidenceCoverage as aq, type SeatConfidenceEvidence as ar, type SeatConfidenceModelLevel as as, type SeatConfidenceModeledTarget as at, type SeatConfidenceRealityLevel as au, type SeatViewVariant as av, type SelectionLayer as aw, type StageLabelStyle as ax, type TextAlignment as ay, type TextBackground as az, type SeatViewMetadata as b, type ResolvedSeatConfidenceEvidence as c, type SeatGlyphKind as d, type SeatViewCoverage as e, type SectionOutlinePath as f, type SectionPathSegment as g, type GAInventorySegment as h, type CategoryTier as i, type SeatOverride as j, type RectTableSide as k, type Floor as l, type SectionObject as m, type RectTableSeatCounts as n, type ChartReferenceImage as o, type Category as p, type ShapeLineCap as q, type ShapeLineEnding as r, type ShapeLineJoin as s, type ShapeObject as t, type CubicPath as u, type TextObject as v, type ChartDeliveryPerformance as w, ACCESSIBILITY_RING_COLOR as x, ACCESSIBILITY_TYPES as y, type AccessibilityMeta as z };