AutoMovie API
    Preparing search index...

    Interface IAutoMovieRecoveryContourResume<Format>

    Additive failed-contour patches and opaque references to original artifacts. Original source lineages retain their original publication addresses. A successful target references this result's fits array instead. Consumers commit the new patch bytes separately and resolve the two namespaces in an explicit ledger; this result never overwrites an original curve collection.

    interface IAutoMovieRecoveryContourResume<
        Format extends AutoMovieRecoveryCurveFormat = "bezier",
    > {
        axis: readonly [number, number, number];
        bindingAuthority: "raw-cut-addresses-and-closure-only";
        callerBindingRequired: true;
        fits: {
            curve: {
                closed: boolean;
                name: string;
                phaseIntervals: readonly number[];
                phaseUnit: "mm" | "turn" | "normalized";
                unit: "mm";
            } & (
                Format extends "hermite"
                    ? IAutoMovieRecoveryHermiteCurve
                    : IAutoMovieCubicBezierCurve64
            );
            handleFallbacks: number;
            observationsPerSpan: number;
            polylineUpperEstimateMm: number;
            sampleMaximumMm: number;
            toleranceMet: boolean;
        }[];
        frame: {
            n: readonly [number, number, number];
            originMm: readonly [number, number, number];
            u: readonly [number, number, number];
            v: readonly [number, number, number];
        };
        name: string;
        originalCurveCoefficientsRead: false;
        preservedOriginals: {
            coordinateMm: number;
            observationIdentity: string;
            originalRawContourIndex: number;
            publication: | { curveName: string; kind: "closed"; loopIndex: number }
            | { curveName: string; kind: "open"; reportIndex: number }
            | { kind: "degenerate" }
            | { diagnostic: string; kind: "failed" };
        }[];
        reference: readonly [number, number, number];
        sections: {
            coordinateMm: number;
            observationIdentity: string;
            rawContours: {
                closed: boolean;
                contourIndex: number;
                observationCount: number;
                savedClosureCompared: boolean;
            }[];
            sourceLineage: IAutoMovieRecoverySourceLineage[];
        }[];
        sourceIdentity: string;
        sourceSelectionIdentity: string;
        targets: {
            actualObservationCount: number;
            actualRawEdgeCount: number;
            closed: boolean;
            coordinateMm: number;
            exactSourceFaceCount: number;
            maxSpans: number;
            observationIdentity: string;
            originalPolicy: IAutoMovieRecoveryContourResumePolicy;
            originalRawContourIndex: number;
            outcome: | {
                diagnostics: string[];
                kind: "fitted";
                patchCurveIndex: number;
                winding?: 1
                | -1;
            }
            | { diagnostic: string; diagnostics: string[]; kind: "failed" };
            plannedSpanUpperBound: number;
            previousFailureDiagnostic: string;
        }[];
    }

    Type Parameters

    Index
    axis: readonly [number, number, number]

    Original caller axis before normalization.

    bindingAuthority: "raw-cut-addresses-and-closure-only"

    Independently verified binding scope; original curve geometry remains caller-attested.

    callerBindingRequired: true

    Source/artifact hashing, registration and actual original policy remain caller obligations.

    fits: {
        curve: {
            closed: boolean;
            name: string;
            phaseIntervals: readonly number[];
            phaseUnit: "mm" | "turn" | "normalized";
            unit: "mm";
        } & (
            Format extends "hermite"
                ? IAutoMovieRecoveryHermiteCurve
                : IAutoMovieCubicBezierCurve64
        );
        handleFallbacks: number;
        observationsPerSpan: number;
        polylineUpperEstimateMm: number;
        sampleMaximumMm: number;
        toleranceMet: boolean;
    }[]

    New patch-local fits only, in successful-target order. Actual physical h and derivative units are preserved by the official algebraic converter.

    Type Declaration

    • curve: {
          closed: boolean;
          name: string;
          phaseIntervals: readonly number[];
          phaseUnit: "mm" | "turn" | "normalized";
          unit: "mm";
      } & (
          Format extends "hermite"
              ? IAutoMovieRecoveryHermiteCurve
              : IAutoMovieCubicBezierCurve64
      )

      Fitted millimetre coefficients with their original physical phase widths.

    • handleFallbacks: number

      Number of solves using the declared conditioning or handle-sign fallback.

    • observationsPerSpan: number

      Observation count divided by emitted span count; dimensionless.

    • polylineUpperEstimateMm: number

      Bernstein convex-hull upper estimate over the input polyline, millimetres.

    • sampleMaximumMm: number

      Largest observed point-to-corresponding-parameter residual, millimetres.

    • toleranceMet: boolean

      False when an unsplittable two-observation tangent-constrained span still exceeds the requested tolerance.

    frame: {
        n: readonly [number, number, number];
        originMm: readonly [number, number, number];
        u: readonly [number, number, number];
        v: readonly [number, number, number];
    }

    Actual normalized zero-origin physical frame shared by all recuts.

    Type Declaration

    • n: readonly [number, number, number]

      Unit section-plane normal in the registered Cartesian frame; u cross v equals n.

    • originMm: readonly [number, number, number]

      Section-plane origin in the registered millimetre Cartesian frame.

    • u: readonly [number, number, number]

      Unit u-axis of the right-handed section plane, in the registered Cartesian frame.

    • v: readonly [number, number, number]

      Unit v-axis of the right-handed section plane, in the registered Cartesian frame.

    name: string

    New acquisition/patch identity, distinct from the original artifact.

    originalCurveCoefficientsRead: false

    Original coefficient payloads were neither supplied nor read.

    preservedOriginals: {
        coordinateMm: number;
        observationIdentity: string;
        originalRawContourIndex: number;
        publication:
            | { curveName: string; kind: "closed"; loopIndex: number }
            | { curveName: string; kind: "open"; reportIndex: number }
            | { kind: "degenerate" }
            | { diagnostic: string; kind: "failed" };
    }[]

    Untargeted original publications, retained as artifact references without coefficient traversal.

    Type Declaration

    • coordinateMm: number

      Original signed physical plane coordinate, millimetres.

    • observationIdentity: string

      Byte commitment of the untouched original coefficient artifact, verified by the caller.

    • originalRawContourIndex: number

      Original raw cutter ordinal, independent of loop/report and new patch indices.

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

      Original symbolic curve address or explicit failed/contact classification.

    reference: readonly [number, number, number]

    Original caller frame reference before projection.

    sections: {
        coordinateMm: number;
        observationIdentity: string;
        rawContours: {
            closed: boolean;
            contourIndex: number;
            observationCount: number;
            savedClosureCompared: boolean;
        }[];
        sourceLineage: IAutoMovieRecoverySourceLineage[];
    }[]

    Complete same-order recut ledger retaining original publication addresses, including targeted failures.

    Type Declaration

    • coordinateMm: number

      Original signed plane coordinate, millimetres.

    • observationIdentity: string

      Caller-verified saved artifact identity, retained without hashing.

    • rawContours: {
          closed: boolean;
          contourIndex: number;
          observationCount: number;
          savedClosureCompared: boolean;
      }[]

      Raw closure and sample count; failed saved fits have no closure claim to compare.

    • sourceLineage: IAutoMovieRecoverySourceLineage[]

      Fresh broad/exact source addresses with unchanged symbolic publication fields.

    sourceIdentity: string

    Caller-verified original source byte commitment; not hashed by this API.

    sourceSelectionIdentity: string

    Caller-verified registration, selection and original triangle-ordinal commitment.

    targets: {
        actualObservationCount: number;
        actualRawEdgeCount: number;
        closed: boolean;
        coordinateMm: number;
        exactSourceFaceCount: number;
        maxSpans: number;
        observationIdentity: string;
        originalPolicy: IAutoMovieRecoveryContourResumePolicy;
        originalRawContourIndex: number;
        outcome:
            | {
                diagnostics: string[];
                kind: "fitted";
                patchCurveIndex: number;
                winding?: 1
                | -1;
            }
            | { diagnostic: string; diagnostics: string[]; kind: "failed" };
        plannedSpanUpperBound: number;
        previousFailureDiagnostic: string;
    }[]

    Requested raw targets in input order. Complete means all requested patches met their original tolerance, independently of unresolved untargeted publications.

    Type Declaration

    • actualObservationCount: number

      Raw point count N; closed cuts omit a repeated endpoint.

    • actualRawEdgeCount: number

      Actual cutter edge count E, N for a closed cut and N minus one for a nonempty open cut. Contacts have zero edges.

    • closed: boolean

      Actual raw cut closure, not inferred from its earlier failed fit.

    • coordinateMm: number

      Original signed physical plane coordinate, millimetres.

    • exactSourceFaceCount: number

      Distinct original triangles F that emitted this raw contour's exact cutter edges or contacts.

    • maxSpans: number

      New adaptive budget E; zero means a degenerate target is not fitted.

    • observationIdentity: string

      Caller-verified original artifact byte identity.

    • originalPolicy: IAutoMovieRecoveryContourResumePolicy

      Caller-attested actual policy used by the committed original artifact.

    • originalRawContourIndex: number

      Original raw cutter ordinal; never a new coefficient index.

    • outcome:
          | {
              diagnostics: string[];
              kind: "fitted";
              patchCurveIndex: number;
              winding?: 1
              | -1;
          }
          | { diagnostic: string; diagnostics: string[]; kind: "failed" }

      New patch address and material-side winding when fitted; otherwise the explicit failure. Diagnostics retain unmet tolerance and open-domain limitations.

    • plannedSpanUpperBound: number

      Conservative preplan span bound 3F; broad endpoint-star incidence is not used.

    • previousFailureDiagnostic: string

      Unchanged original failed-publication diagnostic.