@guideshot/core 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -73,6 +73,7 @@ interface ScenarioResult {
 interface ScenarioDefinition<TInput extends JsonObject = JsonObject> extends ExtensionInfo {
     schema: object;
     datasetRevision?: string;
+    concurrencyKey?: string;
     prepare(context: ScenarioContext, input: TInput): ScenarioResult | Promise<ScenarioResult>;
 }
 interface TranslationContext {
@@ -91,11 +92,15 @@ interface ServerConfig {
 interface SafetyConfig {
     allowedOrigins?: readonly string[];
 }
+interface CaptureConfig {
+    concurrency?: number;
+}
 interface GuideShotConfig {
     recipes: readonly string[];
     outputDir: string;
     cacheDir: string;
     server: ServerConfig;
+    capture?: CaptureConfig;
     safety?: SafetyConfig;
     targetAttribute?: `data-${string}`;
     profiles: Readonly<Record<string, CaptureProfile>>;
@@ -405,4 +410,4 @@ declare function validateConfig(config: GuideShotConfig): void;
 declare function validateRecipeSemantics(source: RecipeSource, config: GuideShotConfig): void;
 declare function defaultProfileName(config: GuideShotConfig): string;
 
-export { type AnnotationRenderer, type BrowserCookie, type BrowserDriver, type BrowserEnvironment, type BrowserRun, type BrowserStatePatch, type CaptureIntent, type CaptureProfile, type CaptureRequest, type CaptureResult, type CapturedScene, type CompositionIntent, type CompositionOutput, type CompositionRequest, DIAGNOSTIC_CODES, type Diagnostic, type DiagnosticCode, type DiagnosticLocation, type DiagnosticSeverity, type DimensionDefinition, type DimensionResolveContext, type DriverRunOptions, type ExtensionInfo, type GuideShotConfig, GuideShotError, type GuideShotErrorOptions, type InterpolationContext, type LocalStorageState, type ManifestAssetInput, type MatrixDefinition, type ParseRecipeOptions, type Plan, type PlanOptions, type PlannedJob, type RecipeSource, type Rect, type RenderedAsset, type RendererRun, type ResolveJobOptions, type ResolveTextContext, type ResolvedAnnotation, type ResolvedCaptureJob, type ResolvedJob, type SafeProjectPaths, type SafetyConfig, type ScenarioContext, type ScenarioDefinition, type ScenarioResult, type SceneBackground, type SceneTarget, type SceneViewport, type ServerConfig, type TranslationContext, type TranslationProvider, type VariantRow, type Viewport, assertAllowedOrigin, assertUniqueRecipeIds, buildPublicManifest, canonicalSerialize, createAssetPath, createCaptureHash, createCompositionHash, createJobCompositionHash, createVariantKey, defaultProfileName, defineConfig, defineDimension, defineScenario, diagnosticFromUnknown, discoverRecipes, expandMatrix, hashCanonical, interpolate, interpolateString, isGuideShotError, matchesVariantFilter, mergeBrowserState, parseRecipe, planProject, planRecipes, resolveArtifactPath, resolveJob, resolveLocalizedText, resolvePageUrl, resolveRecipeText, resolveSafeProjectPaths, resolvedAlt, resolvedAnnotations, sanitizeFileSegment, sha256, validateConfig, validateManifest, validateRecipe, validateRecipeSemantics };
+export { type AnnotationRenderer, type BrowserCookie, type BrowserDriver, type BrowserEnvironment, type BrowserRun, type BrowserStatePatch, type CaptureConfig, type CaptureIntent, type CaptureProfile, type CaptureRequest, type CaptureResult, type CapturedScene, type CompositionIntent, type CompositionOutput, type CompositionRequest, DIAGNOSTIC_CODES, type Diagnostic, type DiagnosticCode, type DiagnosticLocation, type DiagnosticSeverity, type DimensionDefinition, type DimensionResolveContext, type DriverRunOptions, type ExtensionInfo, type GuideShotConfig, GuideShotError, type GuideShotErrorOptions, type InterpolationContext, type LocalStorageState, type ManifestAssetInput, type MatrixDefinition, type ParseRecipeOptions, type Plan, type PlanOptions, type PlannedJob, type RecipeSource, type Rect, type RenderedAsset, type RendererRun, type ResolveJobOptions, type ResolveTextContext, type ResolvedAnnotation, type ResolvedCaptureJob, type ResolvedJob, type SafeProjectPaths, type SafetyConfig, type ScenarioContext, type ScenarioDefinition, type ScenarioResult, type SceneBackground, type SceneTarget, type SceneViewport, type ServerConfig, type TranslationContext, type TranslationProvider, type VariantRow, type Viewport, assertAllowedOrigin, assertUniqueRecipeIds, buildPublicManifest, canonicalSerialize, createAssetPath, createCaptureHash, createCompositionHash, createJobCompositionHash, createVariantKey, defaultProfileName, defineConfig, defineDimension, defineScenario, diagnosticFromUnknown, discoverRecipes, expandMatrix, hashCanonical, interpolate, interpolateString, isGuideShotError, matchesVariantFilter, mergeBrowserState, parseRecipe, planProject, planRecipes, resolveArtifactPath, resolveJob, resolveLocalizedText, resolvePageUrl, resolveRecipeText, resolveSafeProjectPaths, resolvedAlt, resolvedAnnotations, sanitizeFileSegment, sha256, validateConfig, validateManifest, validateRecipe, validateRecipeSemantics };

package/dist/index.js

@@ -246,6 +246,20 @@ function validateConfig(config) {
       "Configuration must register at least one capture profile."
     );
   }
+  if (config.capture?.concurrency !== void 0 && (!Number.isInteger(config.capture.concurrency) || config.capture.concurrency < 1)) {
+    throw new GuideShotError(
+      "RECIPE_SCHEMA_INVALID",
+      "Capture concurrency must be a positive integer."
+    );
+  }
+  for (const scenario of Object.values(config.scenarios ?? {})) {
+    if (scenario.concurrencyKey !== void 0 && scenario.concurrencyKey.trim() === "") {
+      throw new GuideShotError(
+        "RECIPE_SCHEMA_INVALID",
+        "Scenario concurrency keys cannot be empty."
+      );
+    }
+  }
   for (const [name, profile] of Object.entries(config.profiles)) {
     if (!Number.isInteger(profile.viewport.width) || profile.viewport.width <= 0 || !Number.isInteger(profile.viewport.height) || profile.viewport.height <= 0) {
       throw new GuideShotError(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guideshot/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Portable compiler and contracts for GuideShot.",
   "license": "MIT",
   "keywords": [
@@ -37,7 +37,7 @@
     "ajv-formats": "^3.0.1",
     "fast-glob": "^3.3.3",
     "jsonc-parser": "^3.3.1",
-    "@guideshot/schema": "0.1.0"
+    "@guideshot/schema": "0.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.19",