AutoMovie API
    Preparing search index...

    Interface IAutoMovieRecoverySlabObservation

    Acquisition-only source incidence for a finite observed slab. Input face ordinals and slab-local occurrence identities bind measured ports and source topology; this record is not engine generation input. Source positions, triangle arrays and normals are absent except for measured critical positions. Critical brackets identify source intervals rather than fitted curves at those brackets.

    interface IAutoMovieRecoverySlabObservation {
        axis: readonly [number, number, number];
        boundsMm: [number, number];
        components: {
            cycles: {
                nodes: string[];
                occurrenceCount: number;
                occurrences: { direction: -1 | 1; id: string }[];
                orientation: "coherent" | "unqualified";
                portIds: string[];
                side: "mixed" | "before" | "after" | "physical";
            }[];
            id: number;
            issueCodes: string[];
            sourceTriangleIds: number[];
            topology: IAutoMovieRecoverySourceTopology;
        }[];
        criticalPolicy: "boundary-regular-path-v1";
        events: {
            afterMm: number
            | null;
            beforeMm: number | null;
            components: number[];
            coordinateMm: number;
            diagnostics: string[];
            flat: boolean;
            id: string;
            lowerComponents: number;
            manifold: boolean;
            pointMm: readonly [number, number, number];
            qualified: boolean;
            upperComponents: number;
        }[];
        issues: {
            code: string;
            components: number[];
            portIds: string[];
            sourceTriangleIds: number[];
        }[];
        ports: {
            components: number[];
            contourIndex: number;
            coordinateMm: number;
            exactSourceTriangleIds: number[];
            id: string;
            occurrences: string[];
            parameterCorrespondence: "contour-identity-only";
            publication: | { curveName: string; kind: "closed"; loopIndex: number }
            | { curveName: string; kind: "open"; reportIndex: number }
            | { kind: "degenerate" }
            | { diagnostic: string; kind: "failed" };
            side: "before" | "after";
            status: "unique-component" | "contact-only" | "ambiguous" | "missing";
        }[];
        sourceIncidence: {
            aliases: { incidenceId: string; rawNode: string }[];
            incidence: "raw" | "canonical";
            nodes: {
                id: string;
                incidenceId: string;
                scalar: number;
                vertices: number[];
            }[];
            occurrences: IAutoMovieRecoverySourceHalfedge[];
            triangleOrdinalSpace: "input-triangles";
            vertexOrdinalSpace: "input-vertices";
        };
        unit: "mm";
    }
    Index
    axis: readonly [number, number, number]

    Actual normalized source projection direction, shared with the cutter and PL classifier.

    boundsMm: [number, number]

    Signed lower and upper bounds along the fixed observation's normalized axis, millimetres.

    components: {
        cycles: {
            nodes: string[];
            occurrenceCount: number;
            occurrences: { direction: -1 | 1; id: string }[];
            orientation: "coherent" | "unqualified";
            portIds: string[];
            side: "mixed" | "before" | "after" | "physical";
        }[];
        id: number;
        issueCodes: string[];
        sourceTriangleIds: number[];
        topology: IAutoMovieRecoverySourceTopology;
    }[]

    Every edge-connected two-dimensional source component, including unrepresented or unsupported components.

    Type Declaration

    • cycles: {
          nodes: string[];
          occurrenceCount: number;
          occurrences: { direction: -1 | 1; id: string }[];
          orientation: "coherent" | "unqualified";
          portIds: string[];
          side: "mixed" | "before" | "after" | "physical";
      }[]

      Ordered incidence-node addresses and occurrence traversal words from the same observed boundary walk. Nodes use sourceIncidence.nodes incidenceId, while occurrence endpoints use raw id.

    • id: number

      Zero-based ordinal in this record's owning cell, component or control registry; it is not a source coordinate.

    • issueCodes: string[]

      Topology/admission categories affecting the current observed sheet; an empty list is not a surface-fit certificate.

    • sourceTriangleIds: number[]

      Original input triangle ordinals retained as acquisition provenance; they are not generated mesh indices.

    • topology: IAutoMovieRecoverySourceTopology

      Observed relative-sheet incidence counts and independently qualified manifold/orientation invariants; no embedding claim follows.

    criticalPolicy: "boundary-regular-path-v1"

    Maintained conservative boundary-link classifier used for event qualification.

    events: {
        afterMm: number | null;
        beforeMm: number | null;
        components: number[];
        coordinateMm: number;
        diagnostics: string[];
        flat: boolean;
        id: string;
        lowerComponents: number;
        manifold: boolean;
        pointMm: readonly [number, number, number];
        qualified: boolean;
        upperComponents: number;
    }[]

    Every PL critical source vertex in the closed slab. Qualified means a nonflat regular link, representable brackets and one incident orientable manifold component without recorded issues; this does not certify embedding or physical jets.

    Type Declaration

    • afterMm: number | null

      Upper physical sweep coordinate in registered millimetres; paired with the strictly smaller beforeMm.

    • beforeMm: number | null

      Lower physical sweep coordinate in registered millimetres; paired with the strictly greater afterMm.

    • components: number[]

      Observed two-cell components or their query-local ordinals; lower-dimensional contacts do not merge them.

    • coordinateMm: number

      Signed section-plane coordinate along the registered unit sweep axis, in millimetres.

    • diagnostics: string[]

      Observed admission failures and qualification limits in production order; an empty array adds no extra certificate.

    • flat: boolean

      Whether exact scalar ties occur in the critical vertex neighbourhood.

    • id: string

      Stable identity within the owning chart, boundary or occurrence registry; equal coordinates do not create identity.

    • lowerComponents: number

      Connected-component count in the lower link of the critical source vertex.

    • manifold: boolean

      Whether the observed local incidence meets the owning operation's manifold checks; no embedding claim follows.

    • pointMm: readonly [number, number, number]

      Physical position in the registered millimetre frame; no coordinate matching or source repair is implied.

    • qualified: boolean

      Whether the owning operation's explicit numerical/topological admission predicates passed; no stronger surface or fidelity claim follows.

    • upperComponents: number

      Connected-component count in the upper link of the critical source vertex.

    issues: {
        code: string;
        components: number[];
        portIds: string[];
        sourceTriangleIds: number[];
    }[]

    All reported source-incidence issues; unsupported contacts and unrepresented boundaries remain visible.

    Type Declaration

    • code: string

      Diagnostic category produced by the topology observer; it carries no automatic repair instruction.

    • components: number[]

      Observed two-cell components or their query-local ordinals; lower-dimensional contacts do not merge them.

    • portIds: string[]

      Declared observation-port identities participating in this component or diagnostic.

    • sourceTriangleIds: number[]

      Original input triangle ordinals retained as acquisition provenance; they are not generated mesh indices.

    ports: {
        components: number[];
        contourIndex: number;
        coordinateMm: number;
        exactSourceTriangleIds: number[];
        id: string;
        occurrences: string[];
        parameterCorrespondence: "contour-identity-only";
        publication:
            | { curveName: string; kind: "closed"; loopIndex: number }
            | { curveName: string; kind: "open"; reportIndex: number }
            | { kind: "degenerate" }
            | { diagnostic: string; kind: "failed" };
        side: "before" | "after";
        status: "unique-component" | "contact-only" | "ambiguous" | "missing";
    }[]

    Exact cutter provenance and published closed/open curve or unsupported-contour identity for every boundary contour. Occurrence IDs address this slab's private incidence word.

    Type Declaration

    • components: number[]

      Observed two-cell components or their query-local ordinals; lower-dimensional contacts do not merge them.

    • contourIndex: number

      Raw contour ordinal within its physical plane, before fitting or rejection.

    • coordinateMm: number

      Signed section-plane coordinate along the registered unit sweep axis, in millimetres.

    • exactSourceTriangleIds: number[]

      Original faces that emitted the observed cut contribution, excluding unrelated endpoint-star neighbours.

    • id: string

      Stable identity within the owning chart, boundary or occurrence registry; equal coordinates do not create identity.

    • occurrences: string[]

      Directed halfedge occurrences retained in actual source-cell traversal order.

    • parameterCorrespondence: "contour-identity-only"

      Contour-identity-only explicitly withholds a pointwise or transverse material-parameter correspondence.

    • publication:
          | { curveName: string; kind: "closed"; loopIndex: number }
          | { curveName: string; kind: "open"; reportIndex: number }
          | { kind: "degenerate" }
          | { diagnostic: string; kind: "failed" }

      Original closed/open/failed/contact publication outcome, retained independently of this later observation.

    • side: "before" | "after"

      Source-boundary role: before or after scalar plane, or an actual physical source boundary.

    • status: "unique-component" | "contact-only" | "ambiguous" | "missing"

      Closed outcome discriminator; unavailable or ambiguous arms retain diagnostics instead of fabricated successful data.

    sourceIncidence: {
        aliases: { incidenceId: string; rawNode: string }[];
        incidence: "raw" | "canonical";
        nodes: {
            id: string;
            incidenceId: string;
            scalar: number;
            vertices: number[];
        }[];
        occurrences: IAutoMovieRecoverySourceHalfedge[];
        triangleOrdinalSpace: "input-triangles";
        vertexOrdinalSpace: "input-vertices";
    }

    Copied source-address registries from this slab's actual clipped-cell observation. IDs are opaque and local to this slab; they must not be parsed or reused across observations. This metadata supplies address joins, not curve phase, surface coefficients or generation geometry.

    Type Declaration

    • aliases: { incidenceId: string; rawNode: string }[]

      Existing raw-node to incidence-address aliases, copied without merging their memberships. Unlisted raw nodes have identical raw and incidence addresses.

    • incidence: "raw" | "canonical"

      Actual declared source-incidence policy used for this observation.

    • nodes: { id: string; incidenceId: string; scalar: number; vertices: number[] }[]

      Every observed raw node, including contacts and aliases. Scalar values are signed millimetres on axis; memberships retain original input vertex addresses without coordinates.

    • occurrences: IAutoMovieRecoverySourceHalfedge[]

      Every observed two-cell halfedge occurrence, including interior edges. Cycle and port occurrence IDs join here. Side names describe scalar strata; physicalBoundary separately records an actual source boundary edge.

    • triangleOrdinalSpace: "input-triangles"

      All face addresses in this record index the supplied triangles array. A selected mesh retains its selected local ordinals; the caller owns any map to an external original mesh.

    • vertexOrdinalSpace: "input-vertices"

      Node vertex memberships index the supplied verticesMm array, independently of any face selection or external vertex numbering.

    unit: "mm"

    Spatial and scalar coordinate unit for this acquisition record.