CinematicShotlistToolkit (cinematic_shotlist_toolkit v0.1.1)

Offline prompt composition, creative-brief expansion, and shot-list planning.

Inputs and returned records use maps with string keys. No function opens URLs, invokes a generation provider, writes files, or requires a runtime dependency. See the guide for the complete workflow and optional reference collection.

Summary

Functions

Compose a built-in template after replacing selected prompt fields.

Compose a validated structured prompt from a map with string keys.

Compare adjacent normalized text fields, without inspecting generated media.

Plan 1–50 sequential shots with validated durations of 1–60 seconds.

Validate a board and return CSV text with spreadsheet-formula guarding.

Validate timing and export a storyboard as readable text.

Return the six camera and six style preset descriptions.

Return the eight semantic editorial shot-role definitions.

Retrieve an immutable template by its exact identifier.

Return the eleven optional source URLs without accessing the network.

Return all 24 templates, or the templates in one exact category.

Expand one creative brief into a timed role-based shot list.

Return narrow structural warnings and a separate manual review checklist.

Functions

build_from_template(id, overrides \\ %{})

Compose a built-in template after replacing selected prompt fields.

build_prompt(input)

Compose a validated structured prompt from a map with string keys.

continuity_report(scenes, fields \\ nil)

Compare adjacent normalized text fields, without inspecting generated media.

create_storyboard(shots, options \\ %{})

Plan 1–50 sequential shots with validated durations of 1–60 seconds.

export_shot_list_csv(board)

Validate a board and return CSV text with spreadsheet-formula guarding.

format_storyboard(board)

Validate timing and export a storyboard as readable text.

get_presets()

Return the six camera and six style preset descriptions.

get_shot_roles()

Return the eight semantic editorial shot-role definitions.

get_template(id)

Retrieve an immutable template by its exact identifier.

list_references()

Return the eleven optional source URLs without accessing the network.

list_templates(category \\ nil)

Return all 24 templates, or the templates in one exact category.

plan_shot_list(brief)

Expand one creative brief into a timed role-based shot list.

review_shot_list(board)

Return narrow structural warnings and a separate manual review checklist.