import type { components } from "./schema.js";
import type { SitesApiClientOptions } from "./types.js";
/**
 * Languages resource group — environment-level language management.
 *
 * Languages are **environment-scoped** (not per-site): a language added
 * here becomes available to every site in the environment, and surfaces to
 * higher-level consumers that read the environment's languages (e.g. the
 * Sitecore AI brand-kit Glossary's org locales). `createSite` requires a
 * `language` ISO code that's already been added; the recipe-push pipeline
 * calls `addLanguage` first, then proceeds to site creation.
 *
 * Full CRUD on `/api/v1/languages` (verified against the Sites API OpenAPI
 * schema): list / list-supported / add / update / remove.
 */
export type Language = components["schemas"]["Language"];
export type AddLanguageModel = components["schemas"]["AddLanguageModel"];
export type SupportedLanguage = components["schemas"]["SupportedLanguage"];
export type EditLanguageInput = components["schemas"]["EditLanguageInput"];
/** List languages currently added to the environment. */
export declare const listLanguages: (options: SitesApiClientOptions) => Promise<Language[]>;
/**
 * List the languages SitecoreAI *supports* — the catalog you can add from,
 * with canonical ISO codes + display names. Use it to resolve or validate a
 * code before `addLanguage` (`GET /api/v1/languages/supported`).
 */
export declare const listSupportedLanguages: (options: SitesApiClientOptions) => Promise<SupportedLanguage[]>;
/**
 * Split a regional ISO code into the Sites API's `AddLanguageModel` shape.
 *
 * The add endpoint takes a SEPARATE `languageCode` + `regionCode`, not a
 * combined tag: a regional code like `fr-FR` must be sent as
 * `{ languageCode: "fr", regionCode: "FR" }` — posting `languageCode: "fr-FR"`
 * is rejected ("language 'fr-FR' with region code '' is not supported").
 * A bare language (`en`) carries no region. Splits on the first `-`; the
 * remainder (region or script subtag) becomes `regionCode`.
 */
export declare const parseLanguageCode: (isoCode: string) => AddLanguageModel;
/**
 * The fallback language an environment language should carry so
 * Sitecore's language-fallback chain matches the authored base-locale
 * model (regional content falls back to its base translation, and
 * everything bottoms out at `en`):
 *
 *   - a REGIONAL code falls back to its base language when the
 *     environment carries it (`ar-AE` → `ar`), else straight to `en`;
 *   - a BASE language (`ar`, `de`) falls back to `en`;
 *   - `en` itself gets none (`null` — leave the field untouched).
 *
 * `presentCodes` is the environment's language codes, lowercased (both
 * `iso` and `regionalIsoCode` forms), including any codes the caller is
 * about to add — wire bases before regionals so the target exists.
 */
export declare const fallbackLanguageIsoFor: (code: string, presentCodes: ReadonlySet<string>) => string | null;
/**
 * Add a language to the environment so sites can be created with it (and
 * so it surfaces to the environment's language consumers, e.g. the
 * brand-kit Glossary). Pass a raw `AddLanguageModel`; callers holding a
 * regional ISO code should split it first with {@link parseLanguageCode}.
 * If the language is already present, the API surfaces a 409-style error —
 * callers should treat "already added" as success.
 */
export declare const addLanguage: (options: SitesApiClientOptions, input: AddLanguageModel) => Promise<Language>;
/**
 * Update an existing environment language's metadata (display name,
 * fallback language, etc.) by its regional ISO code. Returns void — the
 * API answers 204 No Content. `PATCH /api/v1/languages/{isoCode}`.
 */
export declare const updateLanguage: (options: SitesApiClientOptions, isoCode: string, input: EditLanguageInput) => Promise<void>;
/**
 * Remove a language from the environment by its regional ISO code.
 * Returns the API's boolean result. `DELETE /api/v1/languages/{isoCode}`.
 */
export declare const removeLanguage: (options: SitesApiClientOptions, isoCode: string) => Promise<boolean>;