//! Typed document operations, queries and facades over in-process or IPC transports.

pub mod error;
pub mod id;
pub mod revision;

#[cfg(feature = "host")]
pub mod backend;
#[cfg(feature = "host")]
pub mod convert;
#[cfg(feature = "host")]
pub mod executor;
#[cfg(feature = "host")]
pub mod geom;
#[cfg(feature = "host")]
mod validation;

pub mod envelope;
pub mod facade;
pub mod ops;
pub mod query;
pub mod transport;

// Append-only wire enums, maintained alongside the DTOs and spec.
pub mod gen {
    pub mod ops {
        include!("gen/ops_gen.rs");
    }
    pub mod query {
        include!("gen/query_gen.rs");
    }
    pub use ops::Operation;
    pub use query::Query;
}

pub use error::{ApiError, ApiResult, GeometryErrorKind};
pub use id::ObjectId;
pub use revision::GeometryRevision;

pub use envelope::{DocApiEnvelope, EnvelopeBody, OpOutcome, Receipt};
pub use facade::{
    ArcCurve, Circle, CurveCollection, Dimension, DocApi, Document, Ellipse, Entity,
    EntityCollection, HasId, Line, MText, OpGroup, Point, Polyline, QueryBatch, QueryResults, Ray,
    Solid, SolidCollection, Spline, Text, XLine,
};
pub use ops::{BoolOp, Curve2Spec, EntitySpec, Operation, PlacementSpec, SolidPrimitive};
pub use query::{Aabb, EntityView, Query, QueryResult};

#[cfg(feature = "host")]
pub use convert::{
    bulge_arc_segment, curve_spec_to_entity, entity_bounds, entity_kind_name,
    entity_to_profile_curves, transform_entity_geometry,
};
pub use transport::Transport;

/// The crate's own wire-envelope protocol version (`DocApiEnvelope::version`).
/// Bump when the envelope layout or `Operation`/`Query` discriminants change.
/// Bridges must check this before speaking (see `bindings/README.md`).
pub const ENVELOPE_VERSION: u16 = 1;

/// The generated binding handover schema: object model + method
/// signatures + op/query mapping with curated wire vocabulary. Single,
/// self-contained, versioned with [`ENVELOPE_VERSION`].
pub fn binding_schema_json() -> &'static str {
    include_str!("gen/binding_schema.json")
}