import type kintone from "./kintone.d";
import type { record } from "./app/record.d";

export namespace app {}

/**
 * @see https://cybozu.dev/ja/kintone/docs/js-api/app/
 */
export type app = {
  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/
   */
  record: record;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-app-id/
   */
  getId: () => number | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-app-icon-urls/
   */
  getIcons: (apps: number[]) => Promise<{ app: number; url: string }[]>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-field-elements/
   */
  getFieldElements: (fieldCode: string) => Element[] | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-header-menu-element/
   */
  getHeaderMenuSpaceElement: () => Element | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-header-element/
   */
  getHeaderSpaceElement: () => Element | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-query/
   */
  getQueryCondition: () => string | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-query-with-order-by-limit-offset/
   */
  getQuery: () => string | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-lookup-target/
   */
  getLookupTargetAppId: (fieldCode: string) => number | null;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-related-records-target/
   */
  getRelatedRecordsTargetAppId: (fieldCode: string) => number | null;

  // 2025/07 updated start

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-app/
   */
  get: () => Promise<kintone.Response>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-form-fields/
   */
  getFormFields: () => Promise<kintone.Response>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-form-layout/
   */
  getFormLayout: () => Promise<kintone.Response>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-categories/
   */
  getCategories: () => Promise<kintone.Response>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/is-maintenance-mode/
   */
  isMaintenanceMode: () => Promise<boolean>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-app-permissions/
   */
  getPermissions: () => Promise<{ addRecord: boolean; editApp: boolean }>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/is-test-environment/
   */
  isTestEnvironment: () => Promise<boolean>;

  // 2025/07 updated end

  // 2025/08 updated start

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/show-or-hide-app-description/
   */
  showDescription: (state: "OPEN" | "CLOSED") => Promise<void>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-add-record-button/
   */
  showAddRecordButton: (state: "VISIBLE" | "HIDDEN") => Promise<void>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-app-settings-button/
   */
  showAppSettingsButton: (state: "VISIBLE" | "HIDDEN") => Promise<void>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-option-button/
   */
  showOptionsButton: (state: "VISIBLE" | "HIDDEN") => Promise<void>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-filter-button/
   */
  showFilterButton: (state: "VISIBLE" | "HIDDEN") => Promise<void>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-report-button/
   */
  showReportButton: (state: "VISIBLE" | "HIDDEN") => Promise<void>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-view-and-report-selector/
   */
  showViewAndReportSelector: (state: "VISIBLE" | "HIDDEN") => Promise<void>;

  // 2025/08 updated end

  // 2025/09 updated start

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-view/
   */
  getView: () => Promise<kintone.Response>;

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-views/
   */
  getViews: () => Promise<kintone.Response>;

  // 2025/09 updated end

  // 2025/10 updated start

  /**
   * @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-status/
   */
  getStatus: () => Promise<kintone.Response>;

  // 2025/10 updated end

  // 2025/11 updated start

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-display-state-app-description/ */
  getDescriptionDisplayState: () => Promise<"OPEN" | "CLOSED" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-add-record-button/ */
  getAddRecordButtonDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-app-settings-button/ */
  getAppSettingsButtonDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-option-button/ */
  getOptionsButtonDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-record-nav-button/ */
  getPagerDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-filter-button/ */
  getFilterButtonDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-report-button/ */
  getReportButtonDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-view-and-report-selector/ */
  getViewAndReportSelectorDisplayState: () => Promise<"VISIBLE" | "HIDDEN">;

  // 2025/11 updated end

  // 2026/01 updated start

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-view-selector-items/ */
  showViewSelectorItems: (config: {
    [id: string]: "VISIBLE" | "HIDDEN";
  }) => Promise<void>;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-view-selector-items/ */
  getViewSelectorItemsDisplayState: () => Promise<kintone.Response>;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/show-or-hide-report-selctor-items/ */
  showReportSelectorItems: (config: {
    [id: string]: "VISIBLE" | "HIDDEN";
  }) => Promise<void>;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/record/get-display-state-report-selector-items/ */
  getReportSelectorItemsDisplayState: () => Promise<kintone.Response>;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-reports/ */
  getReports: () => Promise<kintone.Response>;

  // 2026/01 updated end

  // 2026/04 updated start

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/app/set-record-list-style/ */
  setRecordListStyle: (config: any) => Promise<void>;

  /** @see https://cybozu.dev/ja/kintone/docs/js-api/app/get-record-list-style/ */
  getRecordListStyle: () => Promise<kintone.Response>;

  // 2026/04 updated end
};