/*
 * Copyright 2025 Commonwealth Scientific and Industrial Research
 * Organisation (CSIRO) ABN 41 687 119 230.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import type { QrRepeatGroup } from './repeatGroup.interface';
import type { QuestionnaireItem, QuestionnaireResponseItem } from 'fhir/r4';
import type { RenderingExtensions } from '../hooks/useRenderingExtensions';

/**
 * Props interface for components that emit a `QuestionnaireResponseItem` update.
 *
 * @property onQrItemChange - Callback function to handle an updated QR item.
 * - The `qrItem` represents the new or modified item.
 */
export interface PropsWithQrItemChangeHandler {
  onQrItemChange: (qrItem: QuestionnaireResponseItem) => unknown;
}

/**
 * Props interface for components that emit a `QrRepeatGroup` update.
 *
 * @property onQrRepeatGroupChange - Callback function to handle an updated repeating group item.
 * - The `qrRepeatGroup` represents the entire repeating group structure.
 */
export interface PropsWithQrRepeatGroupChangeHandler {
  onQrRepeatGroupChange: (qrRepeatGroup: QrRepeatGroup) => unknown;
}

export interface PropsWithRenderingExtensionsAttribute {
  renderingExtensions: RenderingExtensions;
}

export interface PropsWithIsRepeatedAttribute {
  isRepeated: boolean;
}

export interface PropsWithIsTabledAttribute {
  isTabled: boolean;
}

export interface PropsWithParentIsReadOnlyAttribute {
  parentIsReadOnly?: boolean;
}

export interface PropsWithFeedbackFromParentAttribute {
  feedbackFromParent?: string;
}

export interface PropsWithParentIsRepeatGroupAttribute {
  parentIsRepeatGroup?: boolean;
  parentRepeatGroupIndex?: number;
}

export interface PropsWithCalculatedExpressionUpdatedAttribute {
  calcExpUpdated: boolean;
}

export interface PropsWithParentStylesAttribute {
  parentStyles?: Record<string, string>;
}

export interface BaseItemProps
  extends PropsWithQrItemChangeHandler,
    PropsWithIsRepeatedAttribute,
    PropsWithIsTabledAttribute,
    PropsWithRenderingExtensionsAttribute,
    PropsWithParentIsReadOnlyAttribute,
    PropsWithFeedbackFromParentAttribute,
    PropsWithCalculatedExpressionUpdatedAttribute,
    PropsWithParentStylesAttribute {
  qItem: QuestionnaireItem;
  qrItem: QuestionnaireResponseItem | null;
}