@seshuk/payload-plugin-openapi 0.1.0

package/dist/spec/paths/jobs.js

@@ -0,0 +1,130 @@
+import { makeT } from "../../translations/index.js";
+import { errorResponses, jsonResponse } from "../components.js";
+const boolParam = (name, description)=>({
+        name,
+        in: 'query',
+        description,
+        schema: {
+            type: 'boolean'
+        }
+    });
+const collectQueues = (jobs)=>{
+    const queues = new Set([
+        'default'
+    ]);
+    const add = (q)=>{
+        if ('string' == typeof q && q) queues.add(q);
+    };
+    const fromSchedules = (items)=>{
+        if (!Array.isArray(items)) return;
+        for (const item of items)for (const s of item.schedule ?? [])add(s.queue);
+    };
+    fromSchedules(jobs?.tasks);
+    fromSchedules(jobs?.workflows);
+    const autoRun = jobs?.autoRun;
+    if (Array.isArray(autoRun)) for (const cron of autoRun)add(cron.queue);
+    const processingOrder = jobs?.processingOrder;
+    if (processingOrder?.queues) for (const name of Object.keys(processingOrder.queues))add(name);
+    return [
+        ...queues
+    ].toSorted();
+};
+const queueParam = (queues, ctx)=>({
+        name: 'queue',
+        in: 'query',
+        description: makeT(ctx.i18n)('jobsQueue', {
+            queues: queues.map((q)=>`\`${q}\``).join(', ')
+        }),
+        schema: {
+            type: 'string',
+            enum: queues
+        }
+    });
+const buildJobsPaths = ({ config, ctx })=>{
+    const jobs = config.jobs;
+    const hasJobs = Boolean(jobs?.tasks?.length || jobs?.workflows?.length);
+    if (!hasJobs) return {};
+    const t = makeT(ctx.i18n);
+    const queue = queueParam(collectQueues(jobs), ctx);
+    const errors = errorResponses([
+        '401',
+        '403',
+        '500'
+    ], t);
+    return {
+        [`${ctx.apiRoute}/payload-jobs/run`]: {
+            get: {
+                tags: [
+                    'Jobs'
+                ],
+                operationId: 'runJobs',
+                summary: t('jobsRunSummary'),
+                parameters: [
+                    queue,
+                    boolParam('allQueues', t('jobsRunAllQueues')),
+                    {
+                        name: 'limit',
+                        in: 'query',
+                        description: t('jobsLimit'),
+                        schema: {
+                            type: 'integer'
+                        }
+                    },
+                    boolParam('disableScheduling', t('jobsDisableScheduling')),
+                    boolParam('silent', t('jobsSilent'))
+                ],
+                responses: {
+                    200: jsonResponse(t('jobsRunResult'), {
+                        type: 'object',
+                        properties: {
+                            message: {
+                                type: 'string'
+                            },
+                            noJobsRemaining: {
+                                type: 'boolean'
+                            },
+                            remainingJobsFromQueried: {
+                                type: 'integer'
+                            }
+                        }
+                    }),
+                    ...errors
+                }
+            }
+        },
+        [`${ctx.apiRoute}/payload-jobs/handle-schedules`]: {
+            get: {
+                tags: [
+                    'Jobs'
+                ],
+                operationId: 'handleJobSchedules',
+                summary: t('jobsSchedulesSummary'),
+                parameters: [
+                    queue,
+                    boolParam('allQueues', t('jobsSchedulesAllQueues'))
+                ],
+                responses: {
+                    200: jsonResponse(t('jobsSchedulesResult'), {
+                        type: 'object',
+                        properties: {
+                            message: {
+                                type: 'string'
+                            },
+                            queued: {
+                                type: 'integer'
+                            },
+                            errored: {
+                                type: 'integer'
+                            },
+                            skipped: {
+                                type: 'integer'
+                            }
+                        }
+                    }),
+                    ...errors
+                }
+            }
+        }
+    };
+};
+export { buildJobsPaths };

package/dist/spec/paths/versions.d.ts

@@ -0,0 +1,18 @@
+import type { PathsObject, SchemaObject } from '@scalar/openapi-types/3.2';
+import type { BuildContext, Entity, IDType } from '../../types.js';
+export interface VersionSchemas {
+    version: SchemaObject;
+    versionList: SchemaObject;
+}
+export declare const versionComponentSchemas: ({ docBase, base, idType, }: {
+    docBase: string;
+    base: string;
+    idType: IDType;
+}) => VersionSchemas;
+export declare const buildVersionPaths: ({ entity, pathBase, ctx, schemaBase, nestedTags, }: {
+    entity: Entity;
+    pathBase: string;
+    ctx: BuildContext;
+    schemaBase?: string;
+    nestedTags: boolean;
+}) => PathsObject;

package/dist/spec/paths/versions.js

@@ -0,0 +1,243 @@
+import { makeT } from "../../translations/index.js";
+import { ERRORS, errorResponses, jsonResponse, nullableType } from "../components.js";
+import { refTo, schemaName } from "../names.js";
+import { buildParamSchemas, commonReadParams } from "../params.js";
+import { versionsTagName } from "../tags.js";
+const buildVersionSchema = (base, idType)=>{
+    const id = {
+        type: 'number' === idType ? 'integer' : 'string'
+    };
+    return {
+        type: 'object',
+        properties: {
+            id,
+            parent: id,
+            version: {
+                $ref: refTo(base)
+            },
+            createdAt: {
+                type: 'string',
+                format: 'date-time'
+            },
+            updatedAt: {
+                type: 'string',
+                format: 'date-time'
+            },
+            latest: {
+                type: 'boolean'
+            },
+            autosave: {
+                type: 'boolean'
+            },
+            snapshot: {
+                type: 'boolean'
+            },
+            publishedLocale: {
+                type: 'string'
+            }
+        },
+        required: [
+            'id',
+            'parent',
+            'version',
+            'createdAt',
+            'updatedAt'
+        ]
+    };
+};
+const buildVersionListSchema = (base)=>({
+        type: 'object',
+        properties: {
+            docs: {
+                type: 'array',
+                items: {
+                    $ref: refTo(`${base}Version`)
+                }
+            },
+            totalDocs: {
+                type: 'integer'
+            },
+            limit: {
+                type: 'integer'
+            },
+            totalPages: {
+                type: 'integer'
+            },
+            page: {
+                type: 'integer'
+            },
+            pagingCounter: {
+                type: 'integer'
+            },
+            hasPrevPage: {
+                type: 'boolean'
+            },
+            hasNextPage: {
+                type: 'boolean'
+            },
+            prevPage: nullableType('integer'),
+            nextPage: nullableType('integer')
+        }
+    });
+const versionComponentSchemas = ({ docBase, base, idType })=>({
+        version: buildVersionSchema(docBase, idType),
+        versionList: buildVersionListSchema(base)
+    });
+const versionRef = (base)=>({
+        $ref: refTo(`${base}Version`)
+    });
+const versionListRef = (base)=>({
+        $ref: refTo(`${base}VersionList`)
+    });
+const listVersionParams = ({ base, ctx, refs })=>{
+    const t = makeT(ctx.i18n);
+    return [
+        {
+            name: 'page',
+            in: 'query',
+            schema: {
+                type: 'integer'
+            }
+        },
+        {
+            name: 'limit',
+            in: 'query',
+            schema: {
+                type: 'integer'
+            }
+        },
+        {
+            name: 'pagination',
+            in: 'query',
+            schema: {
+                type: 'boolean'
+            }
+        },
+        {
+            name: 'sort',
+            in: 'query',
+            description: t('paramSortShort'),
+            schema: {
+                type: 'string'
+            }
+        },
+        ...commonReadParams({
+            base,
+            ctx,
+            refs
+        }),
+        {
+            name: 'where',
+            in: 'query',
+            description: t('versionWhere'),
+            content: {
+                'application/json': {
+                    schema: {
+                        type: 'object',
+                        additionalProperties: true
+                    }
+                }
+            }
+        }
+    ];
+};
+const buildVersionPaths = ({ entity, pathBase, ctx, schemaBase, nestedTags })=>{
+    if (!entity.versions) return {};
+    const t = makeT(ctx.i18n);
+    const name = schemaBase ?? schemaName(entity.slug);
+    const versionsTag = [
+        nestedTags ? versionsTagName(name) : name
+    ];
+    const paramSchemas = buildParamSchemas({
+        fields: entity.fields,
+        ctx
+    });
+    const refs = {
+        select: true,
+        populate: Boolean(paramSchemas.populate),
+        joins: Boolean(paramSchemas.joins)
+    };
+    const idParam = {
+        name: 'id',
+        in: 'path',
+        required: true,
+        schema: {
+            type: 'number' === ctx.defaultIDType ? 'integer' : 'string'
+        }
+    };
+    const restoreResponse = {
+        allOf: [
+            {
+                $ref: refTo(name)
+            },
+            {
+                type: 'object',
+                properties: {
+                    message: {
+                        type: 'string'
+                    }
+                }
+            }
+        ]
+    };
+    return {
+        [`${pathBase}/versions`]: {
+            get: {
+                tags: versionsTag,
+                operationId: `find${name}Versions`,
+                parameters: listVersionParams({
+                    base: name,
+                    ctx,
+                    refs
+                }),
+                responses: {
+                    200: jsonResponse(t('versionList'), versionListRef(name)),
+                    ...errorResponses(ERRORS.versionList, t)
+                }
+            }
+        },
+        [`${pathBase}/versions/{id}`]: {
+            parameters: [
+                idParam
+            ],
+            get: {
+                tags: versionsTag,
+                operationId: `find${name}VersionById`,
+                parameters: commonReadParams({
+                    base: name,
+                    ctx,
+                    refs
+                }),
+                responses: {
+                    200: jsonResponse(t('versionSingle'), versionRef(name)),
+                    ...errorResponses(ERRORS.versionRead, t)
+                }
+            },
+            post: {
+                tags: versionsTag,
+                operationId: `restore${name}Version`,
+                parameters: [
+                    {
+                        name: 'depth',
+                        in: 'query',
+                        schema: {
+                            type: 'integer'
+                        }
+                    },
+                    {
+                        name: 'draft',
+                        in: 'query',
+                        schema: {
+                            type: 'boolean'
+                        }
+                    }
+                ],
+                responses: {
+                    200: jsonResponse(t('versionRestored'), restoreResponse),
+                    ...errorResponses(ERRORS.versionRestore, t)
+                }
+            }
+        }
+    };
+};
+export { buildVersionPaths, versionComponentSchemas };

package/dist/spec/tags.d.ts

@@ -0,0 +1,27 @@
+import type { TagObject } from '@scalar/openapi-types/3.2';
+import type { Translate } from '../translations/types.js';
+export declare const NAV_COLLECTIONS = "Collections";
+export declare const NAV_GLOBALS = "Globals";
+export declare const NAV_SYSTEM = "System";
+export declare const entityTagName: (base: string) => string;
+export declare const authTagName: (base: string) => string;
+export declare const versionsTagName: (base: string) => string;
+export interface CollectionTagInfo {
+    base: string;
+    hasAuth: boolean;
+    hasVersions: boolean;
+    description?: string;
+}
+export interface GlobalTagInfo {
+    base: string;
+    hasVersions: boolean;
+    description?: string;
+}
+export interface TagHierarchyInput {
+    collections: CollectionTagInfo[];
+    globals: GlobalTagInfo[];
+    hasJobs: boolean;
+    t: Translate;
+    nested: boolean;
+}
+export declare const buildTagHierarchy: ({ collections, globals, hasJobs, t, nested }: TagHierarchyInput) => TagObject[];

package/dist/spec/tags.js

@@ -0,0 +1,79 @@
+const NAV_COLLECTIONS = 'Collections';
+const NAV_GLOBALS = 'Globals';
+const NAV_SYSTEM = 'System';
+const entityTagName = (base)=>base;
+const authTagName = (base)=>`${base} Auth`;
+const versionsTagName = (base)=>`${base} Versions`;
+const buildTagHierarchy = ({ collections, globals, hasJobs, t, nested })=>{
+    if (!nested) return [
+        ...collections.map((c)=>({
+                name: entityTagName(c.base),
+                description: c.description
+            })),
+        ...globals.map((g)=>({
+                name: entityTagName(g.base),
+                description: g.description
+            }))
+    ];
+    const tags = [];
+    if (collections.length > 0) {
+        tags.push({
+            name: NAV_COLLECTIONS,
+            summary: t('tagCollections'),
+            description: t('tagCollectionsDesc'),
+            kind: 'nav'
+        });
+        for (const c of collections){
+            tags.push({
+                name: entityTagName(c.base),
+                parent: NAV_COLLECTIONS,
+                description: c.description
+            });
+            if (c.hasAuth) tags.push({
+                name: authTagName(c.base),
+                parent: c.base,
+                summary: t('tagAuth')
+            });
+            if (c.hasVersions) tags.push({
+                name: versionsTagName(c.base),
+                parent: c.base,
+                summary: t('tagVersions')
+            });
+        }
+    }
+    if (globals.length > 0) {
+        tags.push({
+            name: NAV_GLOBALS,
+            summary: t('tagGlobals'),
+            description: t('tagGlobalsDesc'),
+            kind: 'nav'
+        });
+        for (const g of globals){
+            tags.push({
+                name: entityTagName(g.base),
+                parent: NAV_GLOBALS,
+                description: g.description
+            });
+            if (g.hasVersions) tags.push({
+                name: versionsTagName(g.base),
+                parent: g.base,
+                summary: t('tagVersions')
+            });
+        }
+    }
+    if (hasJobs) {
+        tags.push({
+            name: NAV_SYSTEM,
+            summary: t('tagSystem'),
+            description: t('tagSystemDesc'),
+            kind: 'nav'
+        });
+        tags.push({
+            name: 'Jobs',
+            parent: NAV_SYSTEM,
+            summary: t('tagJobs')
+        });
+    }
+    return tags;
+};
+export { NAV_COLLECTIONS, NAV_GLOBALS, NAV_SYSTEM, authTagName, buildTagHierarchy, entityTagName, versionsTagName };

package/dist/translations/index.d.ts

@@ -0,0 +1,6 @@
+import type { AcceptedLanguages, I18n } from '@payloadcms/translations';
+import type { PluginDefaultTranslationsObject, Translate } from './types.js';
+export declare const makeT: (i18n: Pick<I18n, "t">) => Translate;
+export declare const translations: {
+    [key in AcceptedLanguages]?: PluginDefaultTranslationsObject;
+};

package/dist/translations/index.js

@@ -0,0 +1,96 @@
+import { PLUGIN_NAME } from "../constants.js";
+import { ar } from "./locales/ar.js";
+import { az } from "./locales/az.js";
+import { bg } from "./locales/bg.js";
+import { bnBd } from "./locales/bnBd.js";
+import { bnIn } from "./locales/bnIn.js";
+import { ca } from "./locales/ca.js";
+import { cs } from "./locales/cs.js";
+import { da } from "./locales/da.js";
+import { de } from "./locales/de.js";
+import { en } from "./locales/en.js";
+import { es } from "./locales/es.js";
+import { et } from "./locales/et.js";
+import { fa } from "./locales/fa.js";
+import { fr } from "./locales/fr.js";
+import { he } from "./locales/he.js";
+import { hr } from "./locales/hr.js";
+import { hu } from "./locales/hu.js";
+import { hy } from "./locales/hy.js";
+import { id } from "./locales/id.js";
+import { is } from "./locales/is.js";
+import { it } from "./locales/it.js";
+import { ja } from "./locales/ja.js";
+import { ko } from "./locales/ko.js";
+import { lt } from "./locales/lt.js";
+import { lv } from "./locales/lv.js";
+import { my } from "./locales/my.js";
+import { nb } from "./locales/nb.js";
+import { nl } from "./locales/nl.js";
+import { pl } from "./locales/pl.js";
+import { pt } from "./locales/pt.js";
+import { ro } from "./locales/ro.js";
+import { rs } from "./locales/rs.js";
+import { rsLatin } from "./locales/rsLatin.js";
+import { ru } from "./locales/ru.js";
+import { sk } from "./locales/sk.js";
+import { sl } from "./locales/sl.js";
+import { sv } from "./locales/sv.js";
+import { ta } from "./locales/ta.js";
+import { th } from "./locales/th.js";
+import { tr } from "./locales/tr.js";
+import { uk } from "./locales/uk.js";
+import { vi } from "./locales/vi.js";
+import { zh } from "./locales/zh.js";
+import { zhTw } from "./locales/zhTw.js";
+const makeT = (i18n)=>{
+    const t = i18n.t;
+    return (key, vars)=>t ? t(`${PLUGIN_NAME}:${key}`, vars) : key;
+};
+const translations = {
+    ar: ar,
+    az: az,
+    bg: bg,
+    'bn-BD': bnBd,
+    'bn-IN': bnIn,
+    ca: ca,
+    cs: cs,
+    da: da,
+    de: de,
+    en: en,
+    es: es,
+    et: et,
+    fa: fa,
+    fr: fr,
+    he: he,
+    hr: hr,
+    hu: hu,
+    hy: hy,
+    id: id,
+    is: is,
+    it: it,
+    ja: ja,
+    ko: ko,
+    lt: lt,
+    lv: lv,
+    my: my,
+    nb: nb,
+    nl: nl,
+    pl: pl,
+    pt: pt,
+    ro: ro,
+    rs: rs,
+    'rs-latin': rsLatin,
+    ru: ru,
+    sk: sk,
+    sl: sl,
+    sv: sv,
+    ta: ta,
+    th: th,
+    tr: tr,
+    uk: uk,
+    vi: vi,
+    zh: zh,
+    'zh-TW': zhTw
+};
+export { makeT, translations };

package/dist/translations/locales/ar.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const ar: PluginDefaultTranslationsObject;

package/dist/translations/locales/ar.js

@@ -0,0 +1,76 @@
+const ar = {
+    '@seshuk/payload-plugin-openapi': {
+        paramDepth: 'عدد مستويات المستندات المرتبطة المراد جلبها.',
+        paramSort: 'الحقل المراد الترتيب حسبه؛ ضع البادئة `-` للترتيب التنازلي، مثل `-createdAt`.',
+        paramSortShort: 'الحقل المراد الترتيب حسبه؛ ضع البادئة `-` للترتيب التنازلي.',
+        paramDraft: 'إرجاع نسخ المسودة.',
+        paramTrash: 'تضمين المستندات المحذوفة.',
+        paramFlattenLocales: 'مع `locale=all`، اضبط على false للإبقاء على الحقول المترجمة ككائنات لكل لغة. القيمة الافتراضية true.',
+        paramLocale: 'اللغة المراد إرجاعها، أو `all` لكل اللغات. راجع قسم الترجمة في وصف الـ API.',
+        paramFallbackLocale: 'اللغة الاحتياطية للقيم المترجمة المفقودة، أو `none` للتعطيل.',
+        schemaSelect: 'اختر الحقول المراد إرجاعها، مثل `select[title]=true`. اتركه فارغًا لإرجاع الكل.',
+        schemaPopulate: 'جلب المستندات المرتبطة لكل مجموعة، مثل `populate[posts][title]=true`.',
+        schemaJoins: 'عناصر تحكم لكل ربط (limit/page/sort/where/count)، مثل `joins[posts][limit]=10`.',
+        schemaWhere: 'مرشح `where` الخاص بـ Payload. ضمّن حقلاً ثم عاملاً: `where[field][equals]=value`. ادمج الجمل باستخدام المصفوفتين `and` / `or`، مثل `where[or][0][field][equals]=value`. يسرد كل حقل فقط العوامل الصالحة لنوعه.',
+        schemaSupportedTimezones: 'المناطق الزمنية المدعومة بتنسيق IANA.',
+        schemaPerLocale: 'القيم لكل لغة، تُرجَع عند استخدام `locale=all`.',
+        collectionList: 'قائمة مستندات مقسّمة إلى صفحات',
+        collectionDoc: 'مستند واحد',
+        collectionCreated: 'المستند المُنشأ',
+        collectionUpdated: 'المستند المُحدَّث',
+        collectionDeleted: 'المستند المحذوف',
+        collectionBulkUpdate: 'نتيجة التحديث المجمّع',
+        collectionBulkDelete: 'نتيجة الحذف المجمّع',
+        collectionCount: 'عدد المستندات',
+        collectionDuplicated: 'المستند المُكرَّر',
+        globalDoc: 'المستند العام',
+        authLogin: 'نتيجة تسجيل الدخول',
+        authLogout: 'نتيجة تسجيل الخروج',
+        authMe: 'المستخدم المُصادَق عليه حاليًا',
+        authRefreshToken: 'رمز مُحدَّث',
+        authForgotPassword: 'تم إرسال بريد إعادة تعيين كلمة المرور',
+        authResetPassword: 'نتيجة إعادة تعيين كلمة المرور',
+        authFirstRegister: 'المستخدم الأول، تم إنشاؤه برمز مصادقة',
+        authInit: 'ما إذا كان لدى مجموعة المصادقة هذه أي مستخدمين بعد',
+        authAccess: 'صلاحيات (أذونات) المستخدم الحالي لهذه المجموعة',
+        authUnlock: 'نتيجة إلغاء القفل',
+        authVerify: 'نتيجة التحقق',
+        versionList: 'قائمة إصدارات مقسّمة إلى صفحات',
+        versionSingle: 'إصدار واحد',
+        versionRestored: 'المستند المُستعاد',
+        versionWhere: 'تصفية حقول الإصدار، مثل `where[parent][equals]=<docId>`.',
+        jobsRunSummary: 'تشغيل المهام المُدرَجة في قائمة الانتظار (ومعالجة الجداول الزمنية افتراضيًا)',
+        jobsSchedulesSummary: 'إدراج المهام المستحقة وفقًا لجدولها الزمني في قائمة الانتظار',
+        jobsRunResult: 'نتيجة التشغيل',
+        jobsSchedulesResult: 'نتيجة الجدولة',
+        jobsRunAllQueues: 'تشغيل المهام عبر جميع قوائم الانتظار.',
+        jobsLimit: 'الحد الأقصى للمهام المراد تشغيلها.',
+        jobsDisableScheduling: 'تخطّي معالجة الجداول الزمنية التي يقوم بها `run` افتراضيًا.',
+        jobsSilent: 'إخفاء سجلات التشغيل.',
+        jobsSchedulesAllQueues: 'معالجة الجداول الزمنية عبر جميع قوائم الانتظار.',
+        jobsQueue: 'تقييد العملية بقائمة انتظار واحدة. قوائم الانتظار المعروفة: {{queues}}.',
+        uploadFile: 'الملف الثنائي المراد رفعه.',
+        uploadBody: 'أرسِل `multipart/form-data` لرفع ملف (جزء ثنائي `file` بالإضافة إلى جزء `_payload` يحتوي على الحقول بصيغة JSON)، أو `application/json` بالحقول فقط في حال عدم وجود ملف.',
+        uploadPayloadField: 'حقول {{schema}} بصيغة JSON. مثال: `{"alt":"A caption"}`.',
+        error400: 'خطأ في التحقق أو الاستعلام (ValidationError، QueryError)',
+        error401: 'غير مُصادَق عليه (AuthenticationError)',
+        error403: 'محظور بواسطة التحكم في الوصول (Forbidden، UnverifiedEmail)',
+        error404: 'المستند غير موجود (NotFound)',
+        error500: 'خطأ داخلي في الخادم (APIError)',
+        securityBearer: 'الصق الرمز `token` الذي يُرجعه نقطة نهاية تسجيل الدخول. يُرسَل بصيغة `Authorization: Bearer <token>`. يقبل Payload أيضًا مخطط `JWT <token>` وملف تعريف ارتباط `{{cookiePrefix}}-token`.',
+        securityInteractive: 'تسجيل دخول تفاعلي: أدخِل اسم المستخدم (أو البريد الإلكتروني) وكلمة المرور؛ اترك Client ID/Secret فارغين.',
+        tagCollections: 'المجموعات',
+        tagCollectionsDesc: 'نقاط نهاية مجموعات المستندات (CRUD، العدّ، التكرار).',
+        tagGlobals: 'العناصر العامة',
+        tagGlobalsDesc: 'نقاط نهاية المستندات العامة.',
+        tagSystem: 'النظام',
+        tagSystemDesc: 'نقاط نهاية نظام Payload.',
+        tagAuth: 'المصادقة',
+        tagVersions: 'الإصدارات',
+        tagJobs: 'المهام',
+        localizationHeading: 'الترجمة',
+        localizationNote: 'اللغات المتاحة: {{locales}}. مرّر `?locale=<code>` إلى نقطة نهاية قراءة لاختيار لغة واحدة. مرّر `?locale=all` لتلقّي كل اللغات دفعة واحدة — عندئذٍ يُرجَع كل حقل مترجم ككائن مفهرس بحسب رمز اللغة (مثل `{ "en": "Hello", "de": "Hallo" }`) بدلاً من قيمة واحدة. اضبط `?flattenLocales=false` مع `locale=all` للإبقاء على شكل الكائن لكل لغة. تعرض مخططات الحقول شكل اللغة الواحدة.',
+        docLanguagesNote: 'يتوفر هذا التوثيق باللغات التالية: {{languages}}. أضِف `?lang=<code>` إلى عنوان URL لهذه المواصفة للتبديل.'
+    }
+};
+export { ar };

package/dist/translations/locales/az.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefaultTranslationsObject } from '../types.js';
+export declare const az: PluginDefaultTranslationsObject;