@codingfactory/mediables-vue 2.19.2 → 2.20.0

package/dist/filters/index.d.ts

@@ -8,6 +8,7 @@ export type { FilterDefinition, ControlDefinition, FilterMediaTarget } from './r
 export { createFilterInstance, createFilterInstances, updateFilterParams, } from './factory';
 export type { FilterInstanceConfig } from './factory';
 export { mapControlTypeToComponent, validateControlValue, generateDefaultParams, convertControlValue, } from './controlMapping';
+export { videoRecipeToCssFilter, filterToCssFunction, hasUsableFilterPayload, recipeHasFilters, recipeNoiseAmount, resolveFilterType, resolveFilterValue, resolvedRecipeFilters, } from './recipeToCssFilter';
 import './definitions/adjustment';
 import './definitions/adjustmentAdvanced';
 import './definitions/alpha';

package/dist/filters/recipeToCssFilter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Recipe → CSS filter translation
+ *
+ * Canonical helper for converting a `VideoRecipe`'s clip-level filters
+ * (and root-level fallback filters) into a CSS `filter:` string suitable
+ * for native HTML5 video / image preview rendering.
+ *
+ * This module is the single source of truth for the recipe → CSS-filter
+ * shape so app-side thumbnail previews (e.g. blowglass `VideoThumbnail.vue`)
+ * cannot drift from the canonical filter definitions in
+ * `video-engine/filters/CSSFilterSystem.ts` + `filters/video-css-filters.ts`.
+ *
+ * The translation intentionally mirrors the conventions consumers have been
+ * using in practice — including the heuristic param-range normalizers
+ * (e.g. accepting brightness as `[-1..1]`, `[0..1]`, or `[0..N]` percent) —
+ * so swapping to this helper is a no-op compared to the previous in-app
+ * translation layer.
+ */
+import type { VideoRecipe } from '../types/video';
+type UnknownRecord = Record<string, unknown>;
+/**
+ * Resolve the canonical `type` identifier of a filter entry.
+ *
+ * Recipes have used both `type` and `filterId` historically; this falls
+ * back through both before returning `null`.
+ */
+export declare const resolveFilterType: (filter: UnknownRecord) => string | null;
+/**
+ * Identify whether a candidate filter object carries enough payload to be
+ * worth attempting translation. Used by `hasFilters`-style guards.
+ */
+export declare const hasUsableFilterPayload: (candidate: unknown) => boolean;
+/**
+ * Read a finite numeric value from a filter under any of the candidate keys,
+ * checking both the top-level filter object and its nested `params` object.
+ */
+export declare const resolveFilterValue: (filter: UnknownRecord, keys: string[]) => number | null;
+/**
+ * Collapse a recipe's clip-level + root-level filter lists into a deduped
+ * sequence keyed by filter type. Clip-level filters take precedence (they
+ * are what the editor saves); root-level filters only fill in any
+ * remaining gaps.
+ */
+export declare const resolvedRecipeFilters: (recipe: VideoRecipe | undefined | null) => UnknownRecord[];
+/**
+ * Whether the recipe has any clip-level or root-level filter payload worth
+ * rendering. Useful for `has-filters` indicator state.
+ */
+export declare const recipeHasFilters: (recipe: VideoRecipe | undefined | null) => boolean;
+/**
+ * Resolve the noise-overlay intensity (0..1) from any `noise`-typed filter
+ * on the recipe. Returns 0 when no noise filter is present.
+ */
+export declare const recipeNoiseAmount: (recipe: VideoRecipe | undefined | null) => number;
+/**
+ * Convert a single resolved filter record to its CSS function string, or
+ * `null` if the filter is unrecognized / a no-op.
+ *
+ * Exported for tests + advanced consumers. Most callers should use
+ * `videoRecipeToCssFilter(recipe)` instead.
+ */
+export declare const filterToCssFunction: (filter: UnknownRecord) => string | null;
+/**
+ * Convert a `VideoRecipe` (or compatible recipe shape) into a CSS `filter:`
+ * value string. Returns `''` when the recipe has no translatable filters.
+ *
+ * Behaviour is byte-identical to the in-app translation layer this helper
+ * replaces; callers can safely substitute it.
+ */
+export declare const videoRecipeToCssFilter: (recipe: VideoRecipe | undefined | null) => string;
+export {};