AutoMovie API
    Preparing search index...
    IProps: {
        cues: readonly IAutoMovieShotEffectCue[];
        fixedStepSeconds: number;
        world: Pick<IAutoMovieWorldDesign, "effectRecipes" | "effectZones">;
    } & (
        | { contract: IAutoMovieShotContract; seedOwner?: never }
        | { contract?: never; seedOwner: { film: string; production: string } }
    )

    Materialize effect cues into builder-owned deterministic streams.

    A shot contract owns shot-local cues and a production and film pair owns film-global cues; each owner derives a domain-separated stream seed from its identity, the cue, and the recipe and zone it activates. The shot protocol automovie.effect-stream.v1 hashes the shot id with the recipe and zone seeds, and the film protocol automovie.film-effect-seed.v1 hashes the owner pair with the whole recipe and zone records. The seed is the first 13 hex digits of that SHA-256, a 52-bit safe integer. Domain tags distinguish the serialized inputs; truncation still permits different inputs to share a seed.

    A cue whose zone or recipe is absent materializes nothing, because the owner's validator reports that refusal. Streams are ordered by code-unit cue id, every stream steps at the caller's fixedStepSeconds, and each carries the SHA-256 of its canonical JSON, computed without a Node built-in and equal to the Node builder digest of the same stream. Bounds, recipe and intensity are deep copies, so editing a stream never edits the world or the cue.

    Type Declaration

    • cues: readonly IAutoMovieShotEffectCue[]

      Borrowed cues with start-inclusive, end-exclusive seconds. A copied array is sorted by code-unit cue id; empty input produces no streams and unresolved zone/recipe cues are omitted.

    • fixedStepSeconds: number

      Simulation step in seconds on the cue clock, copied into every stream without numeric validation here. The caller supplies a finite positive step; film materialization uses denominator/numerator seconds.

    • world: Pick<IAutoMovieWorldDesign, "effectRecipes" | "effectZones">

      Borrowed recipe and zone tables. IDs are resolved by maps, with the last duplicate winning here; owner validation must reject ambiguous declarations. Output bounds and recipes are deep copies.

    • { contract: IAutoMovieShotContract; seedOwner?: never }
      • contract: IAutoMovieShotContract

        Shot owner whose id seeds shot-local streams; absent only in the film-owner branch.

      • OptionalseedOwner?: never

        Film seed identity; forbidden in the shot-contract branch. Both strings enter the film seed hash unchanged.

    • { contract?: never; seedOwner: { film: string; production: string } }
      • Optionalcontract?: never

        Shot owner whose id seeds shot-local streams; absent only in the film-owner branch.

      • seedOwner: { film: string; production: string }

        Film seed identity; forbidden in the shot-contract branch. Both strings enter the film seed hash unchanged.

        • film: string

          Film identity within the production, included in the seed independently of the cue id.

        • production: string

          Production identity in the film seed domain; identity admission belongs to materializeProductionFilmEffects.