@t3lnet/sceneforge 1.0.8 → 1.0.10

package/dist/index.d.cts

@@ -840,4 +840,185 @@ declare class ScriptGenerator {
  */
 declare function createScriptGenerator(demoName: string, title: string, startTimeMs?: number): ScriptGenerator;
 
-export { type ActionType, type AudioTimingManifest, DEMO_SCHEMA_VERSION, type DemoAction, type DemoContext, type DemoDefinition, type DemoResult, type DemoStep, type DragConfig, type ElementInfo, type GeneratedScript, type PickerResult, type PrivacyConfig, type RecordedInteraction, type RecordingState, type RunDemoOptions, ScriptGenerator, type ScriptOutput, type ScriptSegment, type SelectorCandidate, type SelectorConfig, type SelectorStrategy, type StepBoundary, type StepTarget, type StepTiming, type SynthesizedSegment, type TestSelectorResponse, type ScriptSegment$1 as VoiceScriptSegment, type VoiceSynthesisConfig, type VoiceSynthesisResult, VoiceSynthesizer, type WaitCondition, createClickAction, createDragAction, createEmptyDemo, createEmptyStep, createHoverAction, createNavigateAction, createScriptGenerator, createScrollAction, createScrollToAction, createTypeAction, createUploadAction, createVoiceSynthesizer, createWaitAction, createWaitForAction, demoClick, demoDefinitionSchema, demoHover, demoType, discoverDemos, formatValidationError, generateTimingManifest, highlightElement, injectCursorOverlay, loadDemoDefinition, moveCursorTo, parseDemoDefinition, parseFromYAML, removeCursorOverlay, resolvePath, resolveTarget, runDemo, runDemoFromFile, safeParseDemoDefinition, serializeToYAML, triggerClickRipple, validateDemoDefinition };
+/**
+ * Template loading and composition for LLM context files.
+ * Loads markdown templates and supports variable interpolation.
+ */
+interface TemplateVariables {
+    [key: string]: string | number | boolean | undefined;
+}
+interface LoadedTemplate {
+    name: string;
+    content: string;
+    category: "base" | "stages" | "skills";
+}
+/**
+ * Load a single template file by category and name.
+ */
+declare function loadTemplate(category: "base" | "stages" | "skills", name: string): Promise<LoadedTemplate>;
+/**
+ * Load all templates from a specific category.
+ */
+declare function loadTemplatesByCategory(category: "base" | "stages" | "skills"): Promise<LoadedTemplate[]>;
+/**
+ * Interpolate variables in template content.
+ * Variables use the format: {{variableName}}
+ */
+declare function interpolateVariables(content: string, variables: TemplateVariables): string;
+/**
+ * Compose multiple templates into a single document.
+ */
+declare function composeTemplates(templates: LoadedTemplate[], options?: {
+    separator?: string;
+    includeHeaders?: boolean;
+}): string;
+/**
+ * List available templates by category.
+ */
+declare function listTemplates(): Promise<{
+    base: string[];
+    stages: string[];
+    skills: string[];
+}>;
+/**
+ * Check if a template exists.
+ */
+declare function templateExists(category: "base" | "stages" | "skills", name: string): Promise<boolean>;
+
+/**
+ * Tool-specific formatting for LLM context files.
+ * Formats content and determines file locations for each target tool.
+ */
+type TargetTool = "cursor" | "copilot" | "claude" | "codex";
+type DeployFormat = "combined" | "split";
+interface ToolConfig {
+    name: string;
+    description: string;
+    combinedFile: string;
+    splitDir: string;
+    splitFilePrefix: string;
+    fileExtension: string;
+    supportsSkills: boolean;
+}
+interface FormattedOutput {
+    tool: TargetTool;
+    filePath: string;
+    content: string;
+}
+/**
+ * Configuration for each supported LLM tool.
+ */
+declare const TOOL_CONFIGS: Record<TargetTool, ToolConfig>;
+/**
+ * Get the list of all supported tools.
+ */
+declare function getSupportedTools(): TargetTool[];
+/**
+ * Get configuration for a specific tool.
+ */
+declare function getToolConfig(tool: TargetTool): ToolConfig;
+/**
+ * Format content for a specific tool with appropriate headers and structure.
+ */
+declare function formatForTool(tool: TargetTool, content: string, options?: {
+    stage?: string;
+    includeToolHeader?: boolean;
+}): string;
+/**
+ * Get the output file path for a tool.
+ */
+declare function getOutputPath(tool: TargetTool, format: DeployFormat, outputDir: string, stageName?: string): string;
+/**
+ * Get all output paths for a tool in split format.
+ */
+declare function getSplitOutputPaths(tool: TargetTool, outputDir: string, stageNames: string[]): string[];
+/**
+ * Format stage name for display.
+ */
+declare function formatStageName(stage: string): string;
+/**
+ * Get stage file name from stage identifier.
+ */
+declare function getStageFileName(stage: string): string;
+/**
+ * Validate a tool name.
+ */
+declare function isValidTool(tool: string): tool is TargetTool;
+/**
+ * Validate a deploy format.
+ */
+declare function isValidFormat(format: string): format is DeployFormat;
+
+/**
+ * Main context builder for generating LLM instruction files.
+ * Orchestrates template loading, composition, and formatting.
+ */
+
+type Stage = "actions" | "scripts" | "balance" | "rebalance" | "all";
+interface ContextBuilderOptions {
+    target: TargetTool | "all";
+    stage: Stage;
+    format: DeployFormat;
+    outputDir: string;
+    variables?: TemplateVariables;
+}
+interface DeployResult {
+    tool: TargetTool;
+    filePath: string;
+    stage?: string;
+    created: boolean;
+    skipped?: boolean;
+    error?: string;
+}
+interface PreviewResult {
+    tool: TargetTool;
+    stage?: string;
+    content: string;
+}
+/**
+ * Build context content for a specific tool and stage.
+ */
+declare function buildContext(tool: TargetTool, stage: Stage, variables?: TemplateVariables): Promise<string>;
+/**
+ * Deploy context files to the target directory.
+ */
+declare function deployContext(options: ContextBuilderOptions): Promise<DeployResult[]>;
+/**
+ * Preview context content without writing files.
+ */
+declare function previewContext(tool: TargetTool, stage: Stage, variables?: TemplateVariables): Promise<PreviewResult>;
+/**
+ * List deployed context files in a directory.
+ */
+declare function listDeployedContext(outputDir: string): Promise<{
+    files: Array<{
+        tool: TargetTool;
+        path: string;
+        exists: boolean;
+    }>;
+}>;
+/**
+ * Remove deployed context files.
+ */
+declare function removeContext(outputDir: string, target: TargetTool | "all"): Promise<Array<{
+    path: string;
+    removed: boolean;
+    error?: string;
+}>>;
+/**
+ * Get a skill template by name.
+ */
+declare function getSkill(name: string): Promise<{
+    name: string;
+    content: string;
+} | null>;
+/**
+ * List all available skills.
+ */
+declare function listSkills(): Promise<string[]>;
+/**
+ * Check if templates are available.
+ */
+declare function hasTemplates(): Promise<boolean>;
+
+export { type ActionType, type AudioTimingManifest, type ContextBuilderOptions, DEMO_SCHEMA_VERSION, type DemoAction, type DemoContext, type DemoDefinition, type DemoResult, type DemoStep, type DeployFormat, type DeployResult, type DragConfig, type ElementInfo, type FormattedOutput, type GeneratedScript, type LoadedTemplate, type PickerResult, type PreviewResult, type PrivacyConfig, type RecordedInteraction, type RecordingState, type RunDemoOptions, ScriptGenerator, type ScriptOutput, type ScriptSegment, type SelectorCandidate, type SelectorConfig, type SelectorStrategy, type Stage, type StepBoundary, type StepTarget, type StepTiming, type SynthesizedSegment, TOOL_CONFIGS, type TargetTool, type TemplateVariables, type TestSelectorResponse, type ToolConfig, type ScriptSegment$1 as VoiceScriptSegment, type VoiceSynthesisConfig, type VoiceSynthesisResult, VoiceSynthesizer, type WaitCondition, buildContext, composeTemplates, createClickAction, createDragAction, createEmptyDemo, createEmptyStep, createHoverAction, createNavigateAction, createScriptGenerator, createScrollAction, createScrollToAction, createTypeAction, createUploadAction, createVoiceSynthesizer, createWaitAction, createWaitForAction, demoClick, demoDefinitionSchema, demoHover, demoType, deployContext, discoverDemos, formatForTool, formatStageName, formatValidationError, generateTimingManifest, getOutputPath, getSkill, getSplitOutputPaths, getStageFileName, getSupportedTools, getToolConfig, hasTemplates, highlightElement, injectCursorOverlay, interpolateVariables, isValidFormat, isValidTool, listDeployedContext, listSkills, listTemplates, loadDemoDefinition, loadTemplate, loadTemplatesByCategory, moveCursorTo, parseDemoDefinition, parseFromYAML, previewContext, removeContext, removeCursorOverlay, resolvePath, resolveTarget, runDemo, runDemoFromFile, safeParseDemoDefinition, serializeToYAML, templateExists, triggerClickRipple, validateDemoDefinition };

package/dist/index.d.ts

@@ -840,4 +840,185 @@ declare class ScriptGenerator {
  */
 declare function createScriptGenerator(demoName: string, title: string, startTimeMs?: number): ScriptGenerator;
 
-export { type ActionType, type AudioTimingManifest, DEMO_SCHEMA_VERSION, type DemoAction, type DemoContext, type DemoDefinition, type DemoResult, type DemoStep, type DragConfig, type ElementInfo, type GeneratedScript, type PickerResult, type PrivacyConfig, type RecordedInteraction, type RecordingState, type RunDemoOptions, ScriptGenerator, type ScriptOutput, type ScriptSegment, type SelectorCandidate, type SelectorConfig, type SelectorStrategy, type StepBoundary, type StepTarget, type StepTiming, type SynthesizedSegment, type TestSelectorResponse, type ScriptSegment$1 as VoiceScriptSegment, type VoiceSynthesisConfig, type VoiceSynthesisResult, VoiceSynthesizer, type WaitCondition, createClickAction, createDragAction, createEmptyDemo, createEmptyStep, createHoverAction, createNavigateAction, createScriptGenerator, createScrollAction, createScrollToAction, createTypeAction, createUploadAction, createVoiceSynthesizer, createWaitAction, createWaitForAction, demoClick, demoDefinitionSchema, demoHover, demoType, discoverDemos, formatValidationError, generateTimingManifest, highlightElement, injectCursorOverlay, loadDemoDefinition, moveCursorTo, parseDemoDefinition, parseFromYAML, removeCursorOverlay, resolvePath, resolveTarget, runDemo, runDemoFromFile, safeParseDemoDefinition, serializeToYAML, triggerClickRipple, validateDemoDefinition };
+/**
+ * Template loading and composition for LLM context files.
+ * Loads markdown templates and supports variable interpolation.
+ */
+interface TemplateVariables {
+    [key: string]: string | number | boolean | undefined;
+}
+interface LoadedTemplate {
+    name: string;
+    content: string;
+    category: "base" | "stages" | "skills";
+}
+/**
+ * Load a single template file by category and name.
+ */
+declare function loadTemplate(category: "base" | "stages" | "skills", name: string): Promise<LoadedTemplate>;
+/**
+ * Load all templates from a specific category.
+ */
+declare function loadTemplatesByCategory(category: "base" | "stages" | "skills"): Promise<LoadedTemplate[]>;
+/**
+ * Interpolate variables in template content.
+ * Variables use the format: {{variableName}}
+ */
+declare function interpolateVariables(content: string, variables: TemplateVariables): string;
+/**
+ * Compose multiple templates into a single document.
+ */
+declare function composeTemplates(templates: LoadedTemplate[], options?: {
+    separator?: string;
+    includeHeaders?: boolean;
+}): string;
+/**
+ * List available templates by category.
+ */
+declare function listTemplates(): Promise<{
+    base: string[];
+    stages: string[];
+    skills: string[];
+}>;
+/**
+ * Check if a template exists.
+ */
+declare function templateExists(category: "base" | "stages" | "skills", name: string): Promise<boolean>;
+
+/**
+ * Tool-specific formatting for LLM context files.
+ * Formats content and determines file locations for each target tool.
+ */
+type TargetTool = "cursor" | "copilot" | "claude" | "codex";
+type DeployFormat = "combined" | "split";
+interface ToolConfig {
+    name: string;
+    description: string;
+    combinedFile: string;
+    splitDir: string;
+    splitFilePrefix: string;
+    fileExtension: string;
+    supportsSkills: boolean;
+}
+interface FormattedOutput {
+    tool: TargetTool;
+    filePath: string;
+    content: string;
+}
+/**
+ * Configuration for each supported LLM tool.
+ */
+declare const TOOL_CONFIGS: Record<TargetTool, ToolConfig>;
+/**
+ * Get the list of all supported tools.
+ */
+declare function getSupportedTools(): TargetTool[];
+/**
+ * Get configuration for a specific tool.
+ */
+declare function getToolConfig(tool: TargetTool): ToolConfig;
+/**
+ * Format content for a specific tool with appropriate headers and structure.
+ */
+declare function formatForTool(tool: TargetTool, content: string, options?: {
+    stage?: string;
+    includeToolHeader?: boolean;
+}): string;
+/**
+ * Get the output file path for a tool.
+ */
+declare function getOutputPath(tool: TargetTool, format: DeployFormat, outputDir: string, stageName?: string): string;
+/**
+ * Get all output paths for a tool in split format.
+ */
+declare function getSplitOutputPaths(tool: TargetTool, outputDir: string, stageNames: string[]): string[];
+/**
+ * Format stage name for display.
+ */
+declare function formatStageName(stage: string): string;
+/**
+ * Get stage file name from stage identifier.
+ */
+declare function getStageFileName(stage: string): string;
+/**
+ * Validate a tool name.
+ */
+declare function isValidTool(tool: string): tool is TargetTool;
+/**
+ * Validate a deploy format.
+ */
+declare function isValidFormat(format: string): format is DeployFormat;
+
+/**
+ * Main context builder for generating LLM instruction files.
+ * Orchestrates template loading, composition, and formatting.
+ */
+
+type Stage = "actions" | "scripts" | "balance" | "rebalance" | "all";
+interface ContextBuilderOptions {
+    target: TargetTool | "all";
+    stage: Stage;
+    format: DeployFormat;
+    outputDir: string;
+    variables?: TemplateVariables;
+}
+interface DeployResult {
+    tool: TargetTool;
+    filePath: string;
+    stage?: string;
+    created: boolean;
+    skipped?: boolean;
+    error?: string;
+}
+interface PreviewResult {
+    tool: TargetTool;
+    stage?: string;
+    content: string;
+}
+/**
+ * Build context content for a specific tool and stage.
+ */
+declare function buildContext(tool: TargetTool, stage: Stage, variables?: TemplateVariables): Promise<string>;
+/**
+ * Deploy context files to the target directory.
+ */
+declare function deployContext(options: ContextBuilderOptions): Promise<DeployResult[]>;
+/**
+ * Preview context content without writing files.
+ */
+declare function previewContext(tool: TargetTool, stage: Stage, variables?: TemplateVariables): Promise<PreviewResult>;
+/**
+ * List deployed context files in a directory.
+ */
+declare function listDeployedContext(outputDir: string): Promise<{
+    files: Array<{
+        tool: TargetTool;
+        path: string;
+        exists: boolean;
+    }>;
+}>;
+/**
+ * Remove deployed context files.
+ */
+declare function removeContext(outputDir: string, target: TargetTool | "all"): Promise<Array<{
+    path: string;
+    removed: boolean;
+    error?: string;
+}>>;
+/**
+ * Get a skill template by name.
+ */
+declare function getSkill(name: string): Promise<{
+    name: string;
+    content: string;
+} | null>;
+/**
+ * List all available skills.
+ */
+declare function listSkills(): Promise<string[]>;
+/**
+ * Check if templates are available.
+ */
+declare function hasTemplates(): Promise<boolean>;
+
+export { type ActionType, type AudioTimingManifest, type ContextBuilderOptions, DEMO_SCHEMA_VERSION, type DemoAction, type DemoContext, type DemoDefinition, type DemoResult, type DemoStep, type DeployFormat, type DeployResult, type DragConfig, type ElementInfo, type FormattedOutput, type GeneratedScript, type LoadedTemplate, type PickerResult, type PreviewResult, type PrivacyConfig, type RecordedInteraction, type RecordingState, type RunDemoOptions, ScriptGenerator, type ScriptOutput, type ScriptSegment, type SelectorCandidate, type SelectorConfig, type SelectorStrategy, type Stage, type StepBoundary, type StepTarget, type StepTiming, type SynthesizedSegment, TOOL_CONFIGS, type TargetTool, type TemplateVariables, type TestSelectorResponse, type ToolConfig, type ScriptSegment$1 as VoiceScriptSegment, type VoiceSynthesisConfig, type VoiceSynthesisResult, VoiceSynthesizer, type WaitCondition, buildContext, composeTemplates, createClickAction, createDragAction, createEmptyDemo, createEmptyStep, createHoverAction, createNavigateAction, createScriptGenerator, createScrollAction, createScrollToAction, createTypeAction, createUploadAction, createVoiceSynthesizer, createWaitAction, createWaitForAction, demoClick, demoDefinitionSchema, demoHover, demoType, deployContext, discoverDemos, formatForTool, formatStageName, formatValidationError, generateTimingManifest, getOutputPath, getSkill, getSplitOutputPaths, getStageFileName, getSupportedTools, getToolConfig, hasTemplates, highlightElement, injectCursorOverlay, interpolateVariables, isValidFormat, isValidTool, listDeployedContext, listSkills, listTemplates, loadDemoDefinition, loadTemplate, loadTemplatesByCategory, moveCursorTo, parseDemoDefinition, parseFromYAML, previewContext, removeContext, removeCursorOverlay, resolvePath, resolveTarget, runDemo, runDemoFromFile, safeParseDemoDefinition, serializeToYAML, templateExists, triggerClickRipple, validateDemoDefinition };