@mytechtoday/augment-extensions 1.5.2 → 1.6.1

package/cli/dist/commands/generate-shot-list/formatter/txt-formatter.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * TXT Formatter
+ *
+ * Generates plain text output with simple, readable format
+ * No special formatting, just clean text
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TXTFormatter = void 0;
+const base_formatter_1 = require("./base-formatter");
+/**
+ * TXT formatter implementation
+ *
+ * Features:
+ * - Simple, readable plain text format
+ * - No special formatting or markup
+ * - Text wrapping at 80 characters
+ * - Clear section separators
+ */
+class TXTFormatter extends base_formatter_1.BaseFormatter {
+    /**
+     * Format shot list to plain text
+     */
+    format(shotList, options) {
+        let output = `AI SHOT LIST: ${shotList.title || 'Untitled'}\n`;
+        output += '='.repeat(80) + '\n\n';
+        // Summary section
+        output += `Total Shots: ${shotList.totalShots}\n`;
+        output += `Total Duration: ${this.formatDuration(shotList.totalDuration)}\n`;
+        output += `Average Shot Length: ${this.getAverageShotLength(shotList)} seconds\n`;
+        output += `Character Count: ${this.getAverageCharCount(shotList)} avg, ${this.getMaxCharCount(shotList)} max\n\n`;
+        // Warnings section
+        if (shotList.warnings.length > 0) {
+            output += `WARNINGS: ${shotList.warnings.length}\n`;
+            shotList.warnings.forEach(w => {
+                output += `- ${w.message}\n`;
+            });
+            output += '\n';
+        }
+        output += '='.repeat(80) + '\n\n';
+        // Format each shot
+        for (const shot of shotList.shots) {
+            output += this.formatShot(shot, options);
+            output += '\n' + '='.repeat(80) + '\n\n';
+        }
+        return output;
+    }
+    /**
+     * Format individual shot for plain text
+     */
+    formatShot(shot, options) {
+        const maxChars = options?.maxCharacters || 4000;
+        let output = `SHOT ${shot.number}\n`;
+        output += '-'.repeat(6) + '\n';
+        // Metadata
+        output += `Duration: ${this.formatTime(shot.duration)} (${shot.duration} seconds)\n`;
+        output += `Scene: ${shot.sceneNumber}\n`;
+        output += `Heading: ${shot.heading.raw}\n`;
+        output += `Shot Type: ${shot.metadata.shotType}\n`;
+        output += `Camera Movement: ${shot.metadata.cameraMovement}\n`;
+        output += `Framing: ${shot.metadata.framing}\n\n`;
+        // Context
+        output += `SET:\n${this.wrapText(shot.context.set, 80)}\n\n`;
+        output += `LIGHTING: ${shot.context.lighting}\n`;
+        output += `TIME OF DAY: ${shot.context.timeOfDay}\n`;
+        if (shot.context.atmosphere) {
+            output += `ATMOSPHERE: ${shot.context.atmosphere}\n`;
+        }
+        if (shot.context.weather) {
+            output += `WEATHER: ${shot.context.weather}\n`;
+        }
+        output += '\n';
+        // Characters
+        if (shot.characters.length > 0) {
+            output += `CHARACTERS:\n`;
+            shot.characters.forEach(char => {
+                output += `- ${char.name}:\n`;
+                output += `  Position: ${char.position}\n`;
+                output += `  Appearance: ${char.appearance}\n`;
+                if (char.emotion) {
+                    output += `  Emotion: ${char.emotion}\n`;
+                }
+                if (char.action) {
+                    output += `  Action: ${char.action}\n`;
+                }
+            });
+            output += '\n';
+        }
+        // Description
+        output += `DESCRIPTION:\n${this.wrapText(shot.description, 80)}\n\n`;
+        // Technical notes
+        if (shot.metadata.technicalNotes && shot.metadata.technicalNotes.length > 0) {
+            output += `TECHNICAL NOTES:\n`;
+            shot.metadata.technicalNotes.forEach(note => {
+                output += `- ${note}\n`;
+            });
+            output += '\n';
+        }
+        // Character count
+        const percentage = Math.round((shot.characterCount / maxChars) * 100);
+        output += `CHARACTER COUNT: ${shot.characterCount} / ${maxChars} (${percentage}%)\n`;
+        // Warnings
+        if (shot.warnings.length > 0) {
+            output += `\nWARNINGS:\n`;
+            shot.warnings.forEach(warning => {
+                output += `- [${warning.severity.toUpperCase()}] ${warning.message}\n`;
+            });
+        }
+        return output;
+    }
+    /**
+     * Get file extension
+     */
+    getExtension() {
+        return 'txt';
+    }
+    /**
+     * Get MIME type
+     */
+    getMimeType() {
+        return 'text/plain';
+    }
+}
+exports.TXTFormatter = TXTFormatter;
+//# sourceMappingURL=txt-formatter.js.map

package/cli/dist/commands/generate-shot-list/formatter/txt-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txt-formatter.js","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/formatter/txt-formatter.ts"],"names":[],"mappings":"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"}

package/cli/dist/commands/generate-shot-list/formatter/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Shot List Formatter Types
+ *
+ * Type definitions for output format generation
+ */
+import { ShotList } from '../generator/types';
+/**
+ * Supported output formats
+ */
+export type OutputFormat = 'md' | 'json' | 'jsonl' | 'csv' | 'txt' | 'html';
+/**
+ * Formatter options
+ */
+export interface FormatterOptions {
+    /**
+     * Pretty-print output (for JSON)
+     */
+    prettyPrint?: boolean;
+    /**
+     * Include warnings in output
+     */
+    includeWarnings?: boolean;
+    /**
+     * Maximum character limit for display
+     */
+    maxCharacters?: number;
+    /**
+     * Include metadata in output
+     */
+    includeMetadata?: boolean;
+}
+/**
+ * Formatter interface
+ */
+export interface Formatter {
+    /**
+     * Format shot list to string
+     */
+    format(shotList: ShotList, options?: FormatterOptions): string;
+    /**
+     * Get file extension for this format
+     */
+    getExtension(): string;
+    /**
+     * Get MIME type for this format
+     */
+    getMimeType(): string;
+}
+/**
+ * Formatter factory function type
+ */
+export type FormatterFactory = (format: OutputFormat) => Formatter;
+/**
+ * Time formatting utilities
+ */
+export interface TimeFormatter {
+    /**
+     * Format seconds to MM:SS
+     */
+    formatTime(seconds: number): string;
+    /**
+     * Format total duration to human-readable format (e.g., "1h 23m 15s")
+     */
+    formatDuration(totalSeconds: number): string;
+}
+/**
+ * Text wrapping utilities
+ */
+export interface TextWrapper {
+    /**
+     * Wrap text to specified width
+     */
+    wrapText(text: string, width: number, indent?: string): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/cli/dist/commands/generate-shot-list/formatter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/formatter/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAE/D;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpC;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChE"}

package/cli/dist/commands/generate-shot-list/formatter/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Shot List Formatter Types
+ *
+ * Type definitions for output format generation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/cli/dist/commands/generate-shot-list/formatter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/formatter/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/cli/dist/commands/generate-shot-list/generator/context-builder.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Context Builder
+ *
+ * Implements context repetition for each shot: maintain scene-level context
+ * (set, lighting, time), track character states (position, appearance, emotion),
+ * build complete set and character descriptions per shot.
+ *
+ * Task: bd-shot-list-3.3
+ */
+import { Scene, SceneElement } from '../parser/types';
+import { SceneContext, CharacterState } from './types';
+/**
+ * Context builder configuration
+ */
+export interface ContextBuilderConfig {
+    includeAtmosphere: boolean;
+    includeWeather: boolean;
+    trackCharacterEmotions: boolean;
+}
+/**
+ * Context Builder class
+ */
+export declare class ContextBuilder {
+    private config;
+    constructor(config: ContextBuilderConfig);
+    /**
+     * Build scene-level context from scene heading and elements
+     */
+    buildSceneContext(scene: Scene): SceneContext;
+    /**
+     * Build character states from scene elements
+     */
+    buildCharacterStates(elements: SceneElement[], sceneContext: SceneContext): CharacterState[];
+    /**
+     * Extract lighting from scene elements
+     */
+    private extractLighting;
+    /**
+     * Extract atmosphere from scene elements
+     */
+    private extractAtmosphere;
+    /**
+     * Extract weather from scene elements
+     */
+    private extractWeather;
+    /**
+     * Extract emotion from dialogue element
+     */
+    private extractEmotion;
+    /**
+     * Update character states from action line
+     */
+    private updateCharacterStatesFromAction;
+}
+//# sourceMappingURL=context-builder.d.ts.map

package/cli/dist/commands/generate-shot-list/generator/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/generator/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAkC,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,oBAAoB;IAIxC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY;IAkB7C;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,cAAc,EAAE;IAkC5F;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,+BAA+B;CAcxC"}

package/cli/dist/commands/generate-shot-list/generator/context-builder.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Context Builder
+ *
+ * Implements context repetition for each shot: maintain scene-level context
+ * (set, lighting, time), track character states (position, appearance, emotion),
+ * build complete set and character descriptions per shot.
+ *
+ * Task: bd-shot-list-3.3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextBuilder = void 0;
+/**
+ * Context Builder class
+ */
+class ContextBuilder {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Build scene-level context from scene heading and elements
+     */
+    buildSceneContext(scene) {
+        const context = {
+            set: scene.heading.location,
+            lighting: this.extractLighting(scene),
+            timeOfDay: scene.heading.timeOfDay
+        };
+        if (this.config.includeAtmosphere) {
+            context.atmosphere = this.extractAtmosphere(scene);
+        }
+        if (this.config.includeWeather) {
+            context.weather = this.extractWeather(scene);
+        }
+        return context;
+    }
+    /**
+     * Build character states from scene elements
+     */
+    buildCharacterStates(elements, sceneContext) {
+        const characterMap = new Map();
+        for (const element of elements) {
+            if (element.type === 'dialogue') {
+                const dialogueElement = element;
+                const characterName = dialogueElement.dialogue.character.name;
+                if (!characterMap.has(characterName)) {
+                    characterMap.set(characterName, {
+                        name: characterName,
+                        position: 'in scene',
+                        appearance: 'as described',
+                        emotion: this.config.trackCharacterEmotions ? this.extractEmotion(dialogueElement) : undefined,
+                        action: undefined
+                    });
+                }
+                else {
+                    // Update emotion if tracking
+                    if (this.config.trackCharacterEmotions) {
+                        const emotion = this.extractEmotion(dialogueElement);
+                        if (emotion) {
+                            characterMap.get(characterName).emotion = emotion;
+                        }
+                    }
+                }
+            }
+            else if (element.type === 'action') {
+                const actionElement = element;
+                this.updateCharacterStatesFromAction(actionElement, characterMap);
+            }
+        }
+        return Array.from(characterMap.values());
+    }
+    /**
+     * Extract lighting from scene elements
+     */
+    extractLighting(scene) {
+        const timeOfDay = scene.heading.timeOfDay.toLowerCase();
+        // Map time of day to lighting
+        if (timeOfDay.includes('night')) {
+            return 'low light';
+        }
+        else if (timeOfDay.includes('day')) {
+            return 'natural daylight';
+        }
+        else if (timeOfDay.includes('dawn') || timeOfDay.includes('dusk')) {
+            return 'golden hour';
+        }
+        else if (timeOfDay.includes('evening')) {
+            return 'dim light';
+        }
+        // Check action lines for lighting keywords
+        for (const element of scene.elements) {
+            if (element.type === 'action') {
+                const text = element.text.toLowerCase();
+                if (text.includes('dark') || text.includes('shadows')) {
+                    return 'low light';
+                }
+                else if (text.includes('bright') || text.includes('sunlight')) {
+                    return 'bright light';
+                }
+                else if (text.includes('fluorescent') || text.includes('artificial')) {
+                    return 'artificial light';
+                }
+            }
+        }
+        return 'natural';
+    }
+    /**
+     * Extract atmosphere from scene elements
+     */
+    extractAtmosphere(scene) {
+        const keywords = {
+            tense: ['tense', 'nervous', 'anxious', 'worried'],
+            calm: ['calm', 'peaceful', 'serene', 'quiet'],
+            chaotic: ['chaotic', 'frantic', 'hectic', 'busy'],
+            romantic: ['romantic', 'intimate', 'tender', 'loving'],
+            ominous: ['ominous', 'threatening', 'dark', 'foreboding']
+        };
+        for (const element of scene.elements) {
+            const text = element.text.toLowerCase();
+            for (const [atmosphere, words] of Object.entries(keywords)) {
+                if (words.some(word => text.includes(word))) {
+                    return atmosphere;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract weather from scene elements
+     */
+    extractWeather(scene) {
+        const weatherKeywords = ['rain', 'snow', 'fog', 'storm', 'sunny', 'cloudy', 'wind'];
+        for (const element of scene.elements) {
+            const text = element.text.toLowerCase();
+            for (const keyword of weatherKeywords) {
+                if (text.includes(keyword)) {
+                    return keyword;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract emotion from dialogue element
+     */
+    extractEmotion(dialogueElement) {
+        // Check parenthetical for emotion
+        if (dialogueElement.dialogue.parenthetical) {
+            return dialogueElement.dialogue.parenthetical.replace(/[()]/g, '').trim();
+        }
+        return undefined;
+    }
+    /**
+     * Update character states from action line
+     */
+    updateCharacterStatesFromAction(actionElement, characterMap) {
+        // Simple implementation: look for character names in action text
+        // and update their action field
+        const text = actionElement.text;
+        for (const [name, state] of characterMap.entries()) {
+            if (text.includes(name)) {
+                state.action = text;
+            }
+        }
+    }
+}
+exports.ContextBuilder = ContextBuilder;
+//# sourceMappingURL=context-builder.js.map

package/cli/dist/commands/generate-shot-list/generator/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/generator/context-builder.ts"],"names":[],"mappings":"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"}

package/cli/dist/commands/generate-shot-list/generator/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shot List Generator
+ *
+ * Main orchestration for generating AI-optimized shot lists from parsed screenplays
+ */
+import { Scene } from '../parser/types';
+import { ShotList, Warning, GeneratorConfig, Generator } from './types';
+/**
+ * Default generator implementation
+ */
+export declare class ShotListGenerator implements Generator {
+    private validator;
+    private segmenter;
+    private contextBuilder;
+    private metadataExtractor;
+    constructor();
+    /**
+     * Generate shot list from parsed screenplay
+     */
+    generate(scenes: Scene[], config: GeneratorConfig): ShotList;
+    /**
+     * Validate shot list against limits
+     * Delegates to validator module (bd-shot-list-3.5)
+     */
+    validate(shotList: ShotList, config: GeneratorConfig): Warning[];
+    /**
+     * Segment scene into shots
+     * Implemented: bd-shot-list-3.2
+     */
+    private segmentScene;
+    /**
+     * Build shot description from elements, context, and characters
+     */
+    private buildDescription;
+}
+/**
+ * Create generator instance
+ */
+export declare function createGenerator(): Generator;
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/commands/generate-shot-list/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/generator/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,QAAQ,EAER,OAAO,EACP,eAAe,EACf,SAAS,EAIV,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,iBAAiB,CAAoB;;IAsB7C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,QAAQ;IAoD5D;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,EAAE;IAIhE;;;OAGG;IACH,OAAO,CAAC,YAAY;IAwCpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqCzB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

package/cli/dist/commands/generate-shot-list/generator/index.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Shot List Generator
+ *
+ * Main orchestration for generating AI-optimized shot lists from parsed screenplays
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShotListGenerator = void 0;
+exports.createGenerator = createGenerator;
+const validator_1 = require("./validator");
+const scene_segmenter_1 = require("./scene-segmenter");
+const context_builder_1 = require("./context-builder");
+const metadata_extractor_1 = require("./metadata-extractor");
+/**
+ * Default generator implementation
+ */
+class ShotListGenerator {
+    constructor() {
+        this.validator = (0, validator_1.createValidator)();
+        // Initialize modules with default configurations
+        this.segmenter = new scene_segmenter_1.SceneSegmenter({
+            maxShotLength: 30, // 30 seconds max
+            targetShotLength: 15, // 15 seconds target
+            minShotLength: 5 // 5 seconds minimum
+        });
+        this.contextBuilder = new context_builder_1.ContextBuilder({
+            includeAtmosphere: true,
+            includeWeather: true,
+            trackCharacterEmotions: true
+        });
+        this.metadataExtractor = new metadata_extractor_1.MetadataExtractor({
+            extractTechnicalNotes: true,
+            inferFromContext: true
+        });
+    }
+    /**
+     * Generate shot list from parsed screenplay
+     */
+    generate(scenes, config) {
+        const shots = [];
+        let shotNumber = 1;
+        const warnings = [];
+        // Process each scene
+        for (const scene of scenes) {
+            // TODO: Implement scene segmentation (bd-shot-list-3.2)
+            // For now, create one shot per scene as placeholder
+            const sceneShots = this.segmentScene(scene, shotNumber, config);
+            shots.push(...sceneShots);
+            shotNumber += sceneShots.length;
+        }
+        // Calculate totals
+        const totalDuration = shots.reduce((sum, shot) => sum + shot.duration, 0);
+        const totalCharacters = shots.reduce((sum, shot) => sum + shot.characterCount, 0);
+        // Create shot list
+        const shotList = {
+            shots,
+            totalShots: shots.length,
+            totalDuration,
+            totalCharacters,
+            warnings: [],
+            metadata: {
+                generatedAt: new Date(),
+                maxCharacters: config.maxCharacters,
+                maxShotLength: config.maxShotLength,
+                sourceFormat: 'fountain' // TODO: Get from screenplay metadata
+            }
+        };
+        // Validate shot list using validator module
+        const validationWarnings = this.validator.validate(shotList, config);
+        warnings.push(...validationWarnings);
+        return {
+            shots,
+            totalShots: shots.length,
+            totalDuration,
+            totalCharacters,
+            warnings,
+            metadata: {
+                generatedAt: new Date(),
+                maxCharacters: config.maxCharacters,
+                maxShotLength: config.maxShotLength,
+                sourceFormat: 'fountain' // TODO: Get from screenplay metadata
+            }
+        };
+    }
+    /**
+     * Validate shot list against limits
+     * Delegates to validator module (bd-shot-list-3.5)
+     */
+    validate(shotList, config) {
+        return this.validator.validate(shotList, config);
+    }
+    /**
+     * Segment scene into shots
+     * Implemented: bd-shot-list-3.2
+     */
+    segmentScene(scene, startShotNumber, config) {
+        // Build scene-level context once
+        const sceneContext = this.contextBuilder.buildSceneContext(scene);
+        // Segment scene into shots
+        const segments = this.segmenter.segment(scene);
+        // Convert segments to shots
+        const shots = [];
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i];
+            const shotNumber = startShotNumber + i;
+            const isFirstShot = i === 0;
+            // Build character states for this segment
+            const characters = this.contextBuilder.buildCharacterStates(segment.elements, sceneContext);
+            // Extract metadata for this segment
+            const metadata = this.metadataExtractor.extract(segment.elements, isFirstShot);
+            // Build description
+            const description = this.buildDescription(segment.elements, sceneContext, characters);
+            shots.push({
+                number: shotNumber,
+                sceneNumber: scene.number,
+                heading: scene.heading,
+                context: sceneContext,
+                characters,
+                description,
+                metadata,
+                duration: segment.estimatedDuration,
+                characterCount: description.length,
+                warnings: []
+            });
+        }
+        return shots;
+    }
+    /**
+     * Build shot description from elements, context, and characters
+     */
+    buildDescription(elements, context, characters) {
+        const parts = [];
+        // Add context
+        parts.push(`${context.set} - ${context.timeOfDay} - ${context.lighting}`);
+        if (context.atmosphere) {
+            parts.push(`Atmosphere: ${context.atmosphere}`);
+        }
+        if (context.weather) {
+            parts.push(`Weather: ${context.weather}`);
+        }
+        // Add characters
+        if (characters.length > 0) {
+            const characterDesc = characters.map(c => {
+                let desc = c.name;
+                if (c.emotion) {
+                    desc += ` (${c.emotion})`;
+                }
+                if (c.action) {
+                    desc += ` - ${c.action}`;
+                }
+                return desc;
+            }).join(', ');
+            parts.push(`Characters: ${characterDesc}`);
+        }
+        // Add action and dialogue
+        const content = elements.map(el => el.text).join(' ');
+        parts.push(content);
+        return parts.join('. ');
+    }
+}
+exports.ShotListGenerator = ShotListGenerator;
+/**
+ * Create generator instance
+ */
+function createGenerator() {
+    return new ShotListGenerator();
+}
+//# sourceMappingURL=index.js.map