@hyperframes/parsers 0.7.59 → 0.7.61

package/dist/{types-CaeOJXdW.d.ts → types-ewozML_N.d.ts}

@@ -42,6 +42,48 @@ declare const VALID_CANVAS_RESOLUTIONS: readonly CanvasResolution[];
  * can produce their own "invalid" UX (CLI exit, route validation, etc.).
  */
 declare function normalizeResolutionFlag(input: string | undefined): CanvasResolution | undefined;
+/**
+ * True when `input` names a resolution *tier* without nailing an orientation
+ * (`1080p`, `hd`, `4k`, `uhd`). Case-insensitive.
+ *
+ * The `--resolution` CLI flag treats these as "target this size; keep the
+ * composition's orientation" — a portrait 1080×1920 comp with `--resolution
+ * 1080p` should land at 1080×1920, not blow up on aspect mismatch. Explicit
+ * canonical presets (`landscape`, `portrait`, …) and orientation-suffixed
+ * aliases (`1080p-portrait`) stay strict — the user picked an orientation.
+ *
+ * Consumers pair this signal with the composition's dimensions (in a
+ * follow-up pass after HTML parse) to pick the right preset via
+ * `suggestMatchingPreset` — see `adaptAspectAgnosticResolution` in the
+ * compile stage (`@hyperframes/producer`) for the canonical remap.
+ */
+declare function isAspectAgnosticResolutionAlias(input: string | undefined): boolean;
+/**
+ * Public-boundary helper: given a raw `--resolution` / `--output-resolution`
+ * flag value, return the pair every distributed render entrypoint needs to
+ * forward end-to-end so the compile stage can adapt aspect-agnostic aliases
+ * to the composition's orientation:
+ *
+ *   - `outputResolution`: normalized {@link CanvasResolution} (or `undefined`
+ *     for unknown values — callers own their invalid-input UX).
+ *   - `outputResolutionAspectAgnostic`: `true` when the raw input was a
+ *     tier-only alias (`1080p` / `hd` / `4k` / `uhd`). Passes through to
+ *     `DistributedRenderConfig.outputResolutionAspectAgnostic` so the compile
+ *     stage remaps `landscape` → `portrait` / `square` when the composition
+ *     dimensions demand it.
+ *
+ * Exported to centralize the two-step pattern (`normalizeResolutionFlag` +
+ * `isAspectAgnosticResolutionAlias`) that would otherwise be duplicated at
+ * every entrypoint that emits a `DistributedRenderConfig` (`hyperframes
+ * cloudrun render`, `hyperframes lambda render` / `render-batch`, the local
+ * CLI). Divergence between those callers is what shipped the portrait-1080p
+ * regression this helper prevents from recurring.
+ */
+interface ResolvedResolutionFlag {
+    outputResolution: CanvasResolution | undefined;
+    outputResolutionAspectAgnostic: boolean;
+}
+declare function resolveResolutionFlagPair(input: string | undefined): ResolvedResolutionFlag;
 interface TimelineElementBase {
     id: string;
     type: TimelineElementType;
@@ -370,4 +412,4 @@ interface StageZoomKeyframe {
 }
 declare function getDefaultStageZoom(resolution: CanvasResolution): StageZoom;
 
-export { type AddElementData as A, type BooleanVariable as B, type CompositionVariable as C, DEFAULT_DURATIONS as D, type ElementKeyframes as E, type FontVariable as F, normalizeResolutionFlag as G, type ImageVariable as I, type Keyframe as K, type MediaElementType as M, type NumberVariable as N, type PlayerAPI as P, type StageZoomKeyframe as S, type TimelineElement as T, type ValidationResult as V, type WaveformData as W, type CanvasResolution as a, type Asset as b, CANVAS_DIMENSIONS as c, COMPOSITION_VARIABLE_TYPES as d, type ColorVariable as e, type CompositionAPI as f, type CompositionAsset as g, type CompositionSpec as h, type CompositionVariableBase as i, type CompositionVariableType as j, type EnumVariable as k, type KeyframeProperties as l, type MediaFile as m, type StageZoom as n, type StringVariable as o, TIMELINE_COLORS as p, type TimelineCompositionElement as q, type TimelineElementBase as r, type TimelineElementType as s, type TimelineMediaElement as t, type TimelineTextElement as u, VALID_CANVAS_RESOLUTIONS as v, getDefaultStageZoom as w, isCompositionElement as x, isMediaElement as y, isTextElement as z };
+export { type AddElementData as A, type BooleanVariable as B, type CompositionVariable as C, DEFAULT_DURATIONS as D, type ElementKeyframes as E, type FontVariable as F, isTextElement as G, normalizeResolutionFlag as H, type ImageVariable as I, resolveResolutionFlagPair as J, type Keyframe as K, type MediaElementType as M, type NumberVariable as N, type PlayerAPI as P, type ResolvedResolutionFlag as R, type StageZoomKeyframe as S, type TimelineElement as T, type ValidationResult as V, type WaveformData as W, type CanvasResolution as a, type Asset as b, CANVAS_DIMENSIONS as c, COMPOSITION_VARIABLE_TYPES as d, type ColorVariable as e, type CompositionAPI as f, type CompositionAsset as g, type CompositionSpec as h, type CompositionVariableBase as i, type CompositionVariableType as j, type EnumVariable as k, type KeyframeProperties as l, type MediaFile as m, type StageZoom as n, type StringVariable as o, TIMELINE_COLORS as p, type TimelineCompositionElement as q, type TimelineElementBase as r, type TimelineElementType as s, type TimelineMediaElement as t, type TimelineTextElement as u, VALID_CANVAS_RESOLUTIONS as v, getDefaultStageZoom as w, isAspectAgnosticResolutionAlias as x, isCompositionElement as y, isMediaElement as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.59",
+  "version": "0.7.61",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -60,9 +60,21 @@
       "import": "./dist/composition.js",
       "types": "./dist/composition.d.ts"
     },
+    "./composition-contract": {
+      "import": "./dist/compositionContract.js",
+      "types": "./dist/compositionContract.d.ts"
+    },
     "./sub-composition-validity": {
       "import": "./dist/subCompositionValidity.js",
       "types": "./dist/subCompositionValidity.d.ts"
+    },
+    "./ff-binaries": {
+      "import": "./dist/ffBinaries.js",
+      "types": "./dist/ffBinaries.d.ts"
+    },
+    "./asset-resolution": {
+      "import": "./dist/assetResolution.js",
+      "types": "./dist/assetResolution.d.ts"
     }
   },
   "publishConfig": {
@@ -82,7 +94,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^3.2.4",
-    "@hyperframes/core": "0.7.59"
+    "@hyperframes/core": "0.7.61"
   },
   "scripts": {
     "build": "tsup",