import { expect } from "@playwright/test";

import { attachToolcraftBrowserRuntimeEvidence } from "./browser-runtime-evidence";
import {
  assertToolcraftBrowserProofSession,
  getToolcraftBrowserActionTarget,
  readToolcraftBrowserObservation,
  runToolcraftBrowserValueAction,
  type ToolcraftBrowserAction,
  type ToolcraftBrowserObservation,
} from "./browser-proof-session";
import {
  assertToolcraftProducedArtifact,
  validateToolcraftExportArtifactInspection,
  type ToolcraftExportArtifactInspection,
} from "./export-artifact-helpers";
import {
  createToolcraftSemanticTransitionOptions,
  expectToolcraftExpectedOutcomeAfterAction,
  type ToolcraftSemanticEvidenceOptions,
} from "./browser-acceptance-transition-helpers";

export type ToolcraftBackgroundPreviewObservation = {
  backgroundVisible: boolean;
  outputSignature: string;
};

export type ToolcraftBackgroundImageInspection =
  ToolcraftExportArtifactInspection & {
    backgroundAlpha: number;
    height: number;
    mediaType: string;
    width: number;
  };

export type ToolcraftBackgroundVideoInspection =
  ToolcraftExportArtifactInspection & {
    backgroundIncluded: boolean;
    mediaType: string;
  };

type ToolcraftBackgroundVideoProof<TArtifact> = {
  exportArtifact: ToolcraftBrowserAction<"interaction", TArtifact>;
  inspectArtifact: (
    artifact: TArtifact,
  ) => Promise<ToolcraftBackgroundVideoInspection> | ToolcraftBackgroundVideoInspection;
};

function requireTargetScopedAction(
  action: ToolcraftBrowserAction,
  message: string,
): string {
  const target = getToolcraftBrowserActionTarget(action);
  expect(target, message).toBeTruthy();
  return target!;
}

function validateBackgroundPreviewObservation(
  observation: ToolcraftBackgroundPreviewObservation,
  requirementId: string,
): void {
  expect(
    typeof observation.backgroundVisible,
    `Background requirement "${requirementId}" must report boolean preview visibility.`,
  ).toBe("boolean");
  expect(
    observation.outputSignature.trim(),
    `Background requirement "${requirementId}" must report a preview output signature.`,
  ).not.toBe("");
}

export async function expectToolcraftBackgroundOutputSemantics<
  TImageArtifact,
  TVideoArtifact = never,
>(
  observePreview: ToolcraftBrowserObservation<ToolcraftBackgroundPreviewObservation>,
  excludeBackground: ToolcraftBrowserAction,
  expectedPreview: ToolcraftBackgroundPreviewObservation,
  exportImageArtifact: ToolcraftBrowserAction<"interaction", TImageArtifact>,
  inspectImageArtifact: (
    artifact: TImageArtifact,
  ) => Promise<ToolcraftBackgroundImageInspection> | ToolcraftBackgroundImageInspection,
  options: ToolcraftSemanticEvidenceOptions & {
    video?: ToolcraftBackgroundVideoProof<TVideoArtifact>;
  },
): Promise<ToolcraftBackgroundPreviewObservation> {
  const actions: ToolcraftBrowserAction[] = [
    excludeBackground,
    exportImageArtifact,
    ...(options.video ? [options.video.exportArtifact] : []),
  ];
  assertToolcraftBrowserProofSession(observePreview, ...actions);
  const target = requireTargetScopedAction(
    excludeBackground,
    "Background-output evidence requires a target-scoped Include control action.",
  );
  const before = await readToolcraftBrowserObservation(observePreview);
  validateBackgroundPreviewObservation(before, options.requirementId);
  validateBackgroundPreviewObservation(expectedPreview, options.requirementId);
  expect(
    before.backgroundVisible,
    `Background requirement "${options.requirementId}" must begin with the preview background included.`,
  ).toBe(true);
  expect(
    expectedPreview.backgroundVisible,
    `Background requirement "${options.requirementId}" must expect the preview background to be excluded.`,
  ).toBe(false);

  const { after } = await expectToolcraftExpectedOutcomeAfterAction(
    observePreview,
    excludeBackground,
    expectedPreview,
    createToolcraftSemanticTransitionOptions(
      `Background requirement "${options.requirementId}" should hide the product preview background.`,
      options,
    ),
  );
  expect(after.outputSignature).not.toBe(before.outputSignature);
  await attachToolcraftBrowserRuntimeEvidence({
    evidenceType: "product-observable-change",
    requirementId: options.requirementId,
    target,
  });
  await attachToolcraftBrowserRuntimeEvidence({
    evidenceType: "background-preview-exclusion",
    requirementId: options.requirementId,
    target,
  });

  const imageArtifact = await runToolcraftBrowserValueAction(exportImageArtifact);
  assertToolcraftProducedArtifact(imageArtifact, options.requirementId);
  const imageInspection = await inspectImageArtifact(imageArtifact);
  validateToolcraftExportArtifactInspection(imageInspection, options.requirementId);
  expect(imageInspection.mediaType).toMatch(/^image\//);
  expect(imageInspection.width).toBeGreaterThan(0);
  expect(imageInspection.height).toBeGreaterThan(0);
  expect(Number.isSafeInteger(imageInspection.backgroundAlpha)).toBe(true);
  expect(imageInspection.backgroundAlpha).toBe(0);
  await attachToolcraftBrowserRuntimeEvidence({
    evidenceType: "exported-artifact",
    requirementId: options.requirementId,
    target,
  });
  await attachToolcraftBrowserRuntimeEvidence({
    evidenceType: "background-image-transparency",
    requirementId: options.requirementId,
    target,
  });

  if (options.video) {
    const videoArtifact = await runToolcraftBrowserValueAction(
      options.video.exportArtifact,
    );
    assertToolcraftProducedArtifact(videoArtifact, options.requirementId);
    const videoInspection = await options.video.inspectArtifact(videoArtifact);
    validateToolcraftExportArtifactInspection(videoInspection, options.requirementId);
    expect(videoInspection.mediaType).toMatch(/^video\//);
    expect(videoInspection.backgroundIncluded).toBe(true);
    await attachToolcraftBrowserRuntimeEvidence({
      evidenceType: "background-video-preserved",
      requirementId: options.requirementId,
      target,
    });
  }

  return after;
}