Skip to content

Write HTML. Render video. Built for agents.

fix(cli): list valid families when media-treatment gets an unknown capability (#5409)

Miguel Ángel856967b25a41
diff --git a/packages/cli/src/commands/media-treatment.test.ts b/packages/cli/src/commands/media-treatment.test.ts
index d050a67679..f22dd009e8 100644
--- a/packages/cli/src/commands/media-treatment.test.ts
+++ b/packages/cli/src/commands/media-treatment.test.ts
@@ -136,6 +136,20 @@ describe("applyMediaTreatmentToHtml", () => {
);
});
+ it("lists the area ids the lookup accepts when a capability is unknown", () => {
+ let message = "";
+ try {
+ getMediaTreatmentCapabilityDetail("adjust");
+ } catch (error) {
+ message = error instanceof Error ? error.message : String(error);
+ }
+ const listed = /Available areas: ([^.]+)\./.exec(message)?.[1]?.split(", ") ?? [];
+ const entryPoints = getMediaTreatmentCapabilityOverview().families.map(({ id }) => id);
+
+ expect(listed).toEqual(expect.arrayContaining(entryPoints));
+ for (const id of listed) expect(() => getMediaTreatmentCapabilityDetail(id)).not.toThrow();
+ });
+
it("exposes enough canonical metadata to assemble a custom treatment", () => {
const capabilities = getHfColorGradingCapabilities();
diff --git a/packages/cli/src/commands/media-treatment.ts b/packages/cli/src/commands/media-treatment.ts
index ea286ea6c1..cb694a31ce 100644
--- a/packages/cli/src/commands/media-treatment.ts
+++ b/packages/cli/src/commands/media-treatment.ts
@@ -297,7 +297,10 @@ export function getMediaTreatmentCapabilityDetail(id: string): unknown {
const detail = Object.hasOwn(details, id) ? Reflect.get(details, id) : undefined;
if (detail) return detail;
- throw new Error(`Unknown media-treatment capability: ${id}`);
+ const families = [...Object.keys(details), ...capabilities.effectFamilies.map((f) => f.id)];
+ throw new Error(
+ `Unknown media-treatment capability: ${id}. Available areas: ${families.join(", ")}.`,
+ );
}
export const examples: Example[] = [