@mapomodule/uikit 2.0.0-beta.4 → 2.0.0-beta.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/README.md +33 -1
  2. package/dist/index.d.mts +1 -0
  3. package/dist/index.d.ts +1 -0
  4. package/dist/index.d.ts.map +1 -1
  5. package/dist/module.d.mts +30 -1
  6. package/dist/module.d.ts +28 -0
  7. package/dist/module.d.ts.map +1 -1
  8. package/dist/module.json +1 -1
  9. package/dist/module.mjs +51 -2
  10. package/dist/runtime/adapters/defaultMediaAdapter.d.ts +14 -0
  11. package/dist/runtime/adapters/defaultMediaAdapter.d.ts.map +1 -0
  12. package/dist/runtime/adapters/defaultMediaAdapter.js +30 -0
  13. package/dist/runtime/components/MapoDetail.vue +1 -1
  14. package/dist/runtime/components/MapoDropArea.vue +95 -0
  15. package/dist/runtime/components/MapoDropArea.vue.d.ts +33 -0
  16. package/dist/runtime/components/MapoDropArea.vue.d.ts.map +1 -0
  17. package/dist/runtime/components/MapoList.vue +1 -1
  18. package/dist/runtime/components/MapoListQuickEdit.vue +1 -1
  19. package/dist/runtime/components/MapoListTable.vue +1 -1
  20. package/dist/runtime/components/MapoMediaBreadcrumbs.vue +45 -0
  21. package/dist/runtime/components/MapoMediaBreadcrumbs.vue.d.ts +4 -0
  22. package/dist/runtime/components/MapoMediaBreadcrumbs.vue.d.ts.map +1 -0
  23. package/dist/runtime/components/MapoMediaEditor.vue +310 -0
  24. package/dist/runtime/components/MapoMediaEditor.vue.d.ts +8 -0
  25. package/dist/runtime/components/MapoMediaEditor.vue.d.ts.map +1 -0
  26. package/dist/runtime/components/MapoMediaFileChanger.vue +108 -0
  27. package/dist/runtime/components/MapoMediaFileChanger.vue.d.ts +15 -0
  28. package/dist/runtime/components/MapoMediaFileChanger.vue.d.ts.map +1 -0
  29. package/dist/runtime/components/MapoMediaFolders.vue +198 -0
  30. package/dist/runtime/components/MapoMediaFolders.vue.d.ts +4 -0
  31. package/dist/runtime/components/MapoMediaFolders.vue.d.ts.map +1 -0
  32. package/dist/runtime/components/MapoMediaGallery.vue +209 -0
  33. package/dist/runtime/components/MapoMediaGallery.vue.d.ts +4 -0
  34. package/dist/runtime/components/MapoMediaGallery.vue.d.ts.map +1 -0
  35. package/dist/runtime/components/MapoMediaManager.vue +130 -0
  36. package/dist/runtime/components/MapoMediaManager.vue.d.ts +35 -0
  37. package/dist/runtime/components/MapoMediaManager.vue.d.ts.map +1 -0
  38. package/dist/runtime/components/MapoMediaManagerDialog.vue +112 -0
  39. package/dist/runtime/components/MapoMediaManagerDialog.vue.d.ts +41 -0
  40. package/dist/runtime/components/MapoMediaManagerDialog.vue.d.ts.map +1 -0
  41. package/dist/runtime/components/MapoMediaPreview.vue +92 -0
  42. package/dist/runtime/components/MapoMediaPreview.vue.d.ts +19 -0
  43. package/dist/runtime/components/MapoMediaPreview.vue.d.ts.map +1 -0
  44. package/dist/runtime/components/MapoMediaUploader.vue +266 -0
  45. package/dist/runtime/components/MapoMediaUploader.vue.d.ts +8 -0
  46. package/dist/runtime/components/MapoMediaUploader.vue.d.ts.map +1 -0
  47. package/dist/runtime/plugins/media-adapter.d.ts +18 -0
  48. package/dist/runtime/plugins/media-adapter.d.ts.map +1 -0
  49. package/dist/runtime/plugins/media-adapter.js +7 -0
  50. package/dist/runtime/stores/media.d.ts +462 -0
  51. package/dist/runtime/stores/media.d.ts.map +1 -0
  52. package/dist/runtime/stores/media.js +322 -0
  53. package/dist/runtime/types/media.d.ts +116 -0
  54. package/dist/runtime/types/media.d.ts.map +1 -0
  55. package/dist/runtime/types/media.js +0 -0
  56. package/dist/types.d.mts +1 -1
  57. package/package.json +7 -5
  58. package/src/index.ts +8 -0
  59. package/src/module.ts +103 -0
  60. package/src/runtime/adapters/defaultMediaAdapter.ts +57 -0
  61. package/src/runtime/components/MapoDropArea.vue +122 -0
  62. package/src/runtime/components/MapoMediaBreadcrumbs.vue +51 -0
  63. package/src/runtime/components/MapoMediaEditor.vue +340 -0
  64. package/src/runtime/components/MapoMediaFileChanger.vue +131 -0
  65. package/src/runtime/components/MapoMediaFolders.vue +217 -0
  66. package/src/runtime/components/MapoMediaGallery.vue +227 -0
  67. package/src/runtime/components/MapoMediaManager.vue +170 -0
  68. package/src/runtime/components/MapoMediaManagerDialog.vue +142 -0
  69. package/src/runtime/components/MapoMediaPreview.vue +111 -0
  70. package/src/runtime/components/MapoMediaUploader.vue +324 -0
  71. package/src/runtime/plugins/media-adapter.ts +29 -0
  72. package/src/runtime/stores/media.ts +438 -0
  73. package/src/runtime/types/media.ts +126 -0
@@ -0,0 +1,438 @@
1
+ import { defineStore } from "pinia";
2
+ import { ref, computed, shallowRef } from "vue";
3
+ import { useConfirmStore } from "@mapomodule/store/runtime/stores/confirm";
4
+ import { useSnackStore } from "@mapomodule/store/runtime/stores/snack";
5
+ import { useCrud } from "@mapomodule/core/runtime/api/crud";
6
+ import { applyMultipartPolicy } from "@mapomodule/core/runtime/api/multipart";
7
+ import { useNuxtApp, useRuntimeConfig } from "#app";
8
+ import { defaultMediaAdapter } from "../adapters/defaultMediaAdapter.js";
9
+ import type {
10
+ MediaItem,
11
+ MediaFolder,
12
+ MediaApiResponse,
13
+ MediaGetRootParams,
14
+ MediaUploadPayload,
15
+ MediaAdapter,
16
+ MediaEndpoints,
17
+ SelectMode,
18
+ } from "../types/media.js";
19
+
20
+ export const useMediaStore = defineStore("mapo-media", () => {
21
+ // ─── Config (endpoints) ─────────────────────────────────────────────────
22
+ const runtimeConfig = useRuntimeConfig();
23
+ const mediaConfig = (runtimeConfig.public.mapoMedia ?? {}) as {
24
+ endpoints?: Partial<MediaEndpoints>;
25
+ };
26
+ const endpoints: MediaEndpoints = {
27
+ media: mediaConfig.endpoints?.media ?? "/api/media",
28
+ folders: mediaConfig.endpoints?.folders ?? "/api/media-folders",
29
+ };
30
+
31
+ // Adapter: backend-specific request/response transforms. Provided by a plugin
32
+ // ($mapoMediaAdapter); falls back to plain REST when none is registered.
33
+ function adapter(): MediaAdapter {
34
+ const nuxt = useNuxtApp() as unknown as {
35
+ $mapoMediaAdapter?: MediaAdapter;
36
+ };
37
+ return nuxt.$mapoMediaAdapter ?? defaultMediaAdapter;
38
+ }
39
+
40
+ // ─── State ────────────────────────────────────────────────────────────────
41
+ const medias = ref<MediaItem[]>([]);
42
+ const folders = ref<MediaFolder[]>([]);
43
+ const parentFolders = ref<MediaFolder[]>([]);
44
+ const page = ref(1);
45
+ const pages = ref(1);
46
+ const mimeType = ref<string | null>(null);
47
+ /**
48
+ * Mime constraint imposed by the host (e.g. an `image/*` picker field).
49
+ * When set, the folders panel only offers matching filters and `mimeType`
50
+ * cannot be cleared below the lock — a picker must never leak other types.
51
+ */
52
+ const lockedMime = ref<string | null>(null);
53
+ const loading = ref(false);
54
+ const editMedia = ref<MediaItem | null>(null);
55
+ const selection = shallowRef<MediaItem | MediaItem[] | null>(null);
56
+ const editList = ref<number[]>([]);
57
+ const selectMode = ref<SelectMode>("none");
58
+
59
+ // ─── Internal navigation context ────────────────────────────────────────
60
+ const _currentFolderId = ref<number | null>(null);
61
+ const _currentSearch = ref<string>("");
62
+ // Whether the current view spans the whole library (global search / mime
63
+ // filter) instead of the current folder. Persisted so pagination keeps the
64
+ // same scope as the request that produced page 1.
65
+ const _currentAll = ref(false);
66
+ const _currentLang = ref<string | undefined>(undefined);
67
+
68
+ // ─── Getters ──────────────────────────────────────────────────────────────
69
+ const parentFolder = computed(
70
+ () => parentFolders.value[parentFolders.value.length - 1] ?? null,
71
+ );
72
+
73
+ const editListSet = computed(() => new Set(editList.value));
74
+
75
+ const editListState = computed<{
76
+ value: boolean;
77
+ indeterminate: boolean;
78
+ outside: boolean;
79
+ }>(() => {
80
+ const total = medias.value.length;
81
+ const selected = editList.value.filter((id) =>
82
+ medias.value.some((m) => m.id === id),
83
+ ).length;
84
+ if (total === 0 || selected === 0)
85
+ return {
86
+ value: false,
87
+ indeterminate: false,
88
+ outside: editList.value.length > 0,
89
+ };
90
+ if (selected === total)
91
+ return { value: true, indeterminate: false, outside: false };
92
+ return { value: false, indeterminate: true, outside: false };
93
+ });
94
+
95
+ // ─── CRUD helpers ─────────────────────────────────────────────────────────
96
+ function mediaCrud() {
97
+ return useCrud<MediaItem>(endpoints.media);
98
+ }
99
+ function folderCrud() {
100
+ return useCrud<MediaFolder>(endpoints.folders);
101
+ }
102
+
103
+ // ─── Breadcrumb maintenance ─────────────────────────────────────────────
104
+ // Driven by the response's `parent_folder` (matches the legacy contract):
105
+ // push when entering a new folder, slice when navigating back up.
106
+ function applyParentFolder(pf: MediaFolder | null): void {
107
+ if (!pf) {
108
+ parentFolders.value = [];
109
+ return;
110
+ }
111
+ const key = pf.path ?? pf.id;
112
+ const idx = parentFolders.value.findIndex((f) => (f.path ?? f.id) === key);
113
+ if (idx === -1) {
114
+ parentFolders.value = [...parentFolders.value, pf];
115
+ } else {
116
+ parentFolders.value = parentFolders.value.slice(0, idx + 1);
117
+ }
118
+ }
119
+
120
+ // ─── Actions ──────────────────────────────────────────────────────────────
121
+
122
+ /**
123
+ * Fetch the current folder contents. Root (`folderId === null`) → `list()`,
124
+ * inside a folder → `detail(folderId)` on the folders endpoint. Both return
125
+ * the canonical `{ media, folders, parent_folder }` shape (after the adapter
126
+ * normalizes it).
127
+ */
128
+ async function getRoot(params: MediaGetRootParams = {}): Promise<void> {
129
+ loading.value = true;
130
+ if (params.search !== undefined) _currentSearch.value = params.search;
131
+ if (params.all !== undefined) _currentAll.value = params.all;
132
+
133
+ const all = _currentAll.value;
134
+ const folderId = all ? null : _currentFolderId.value;
135
+
136
+ try {
137
+ const a = adapter();
138
+ const listParams = (
139
+ a.buildListParams ?? defaultMediaAdapter.buildListParams
140
+ )({
141
+ page: params.page ?? page.value,
142
+ search: _currentSearch.value || undefined,
143
+ mime: mimeType.value,
144
+ all: all || undefined,
145
+ });
146
+
147
+ const crud = folderCrud();
148
+ const raw =
149
+ folderId != null
150
+ ? await crud.detail(folderId, { params: listParams })
151
+ : await crud.list(listParams as never);
152
+
153
+ const data = (
154
+ a.parseRootResponse ?? defaultMediaAdapter.parseRootResponse
155
+ )(raw) as MediaApiResponse;
156
+
157
+ medias.value = data.media.items;
158
+ page.value = data.media.paginator.page;
159
+ pages.value = data.media.paginator.pages;
160
+ folders.value = data.folders;
161
+ applyParentFolder(data.parent_folder);
162
+ } finally {
163
+ loading.value = false;
164
+ }
165
+ }
166
+
167
+ async function navigateToFolder(folder: MediaFolder | null): Promise<void> {
168
+ _currentFolderId.value = folder?.id ?? null;
169
+ _currentSearch.value = "";
170
+ _currentAll.value = false;
171
+ await getRoot({ page: 1 });
172
+ }
173
+
174
+ async function openEditor(media: MediaItem): Promise<void> {
175
+ try {
176
+ const a = adapter();
177
+ const params = (
178
+ a.buildDetailParams ?? defaultMediaAdapter.buildDetailParams
179
+ )({ lang: _currentLang.value });
180
+ const detail = await mediaCrud().detail(media.id, { params });
181
+ editMedia.value = detail;
182
+ } catch {
183
+ editMedia.value = media;
184
+ }
185
+ }
186
+
187
+ function closeEditor(): void {
188
+ editMedia.value = null;
189
+ }
190
+
191
+ function setLang(lang: string | undefined): void {
192
+ _currentLang.value = lang;
193
+ }
194
+
195
+ async function updateMedia(media: MediaItem): Promise<MediaItem> {
196
+ const a = adapter();
197
+ const payload = (
198
+ a.buildMediaPatchPayload ?? defaultMediaAdapter.buildMediaPatchPayload
199
+ )(media);
200
+ const updated = await mediaCrud().partialUpdate(media.id, payload as never);
201
+ // Keep the open editor in sync with the server response (legacy behavior).
202
+ if (editMedia.value?.id === media.id) editMedia.value = updated;
203
+ useSnackStore().show("Media updated", "success");
204
+ await getRoot();
205
+ return updated;
206
+ }
207
+
208
+ async function replaceFile(
209
+ mediaId: number,
210
+ file: File,
211
+ maintainUrl = false,
212
+ ): Promise<MediaItem> {
213
+ const a = adapter();
214
+ const payload = (
215
+ a.buildReplaceFilePayload ?? defaultMediaAdapter.buildReplaceFilePayload
216
+ )(file, maintainUrl);
217
+ const updated = await mediaCrud().partialUpdate(
218
+ mediaId,
219
+ payload as never,
220
+ undefined,
221
+ { multipart: "force" },
222
+ );
223
+ if (editMedia.value?.id === mediaId) editMedia.value = updated;
224
+ return updated;
225
+ }
226
+
227
+ async function updateOrCreateFolder(
228
+ folder: Partial<MediaFolder>,
229
+ ): Promise<void> {
230
+ const a = adapter();
231
+ const payload = (
232
+ a.buildFolderPayload ?? defaultMediaAdapter.buildFolderPayload
233
+ )({
234
+ parent: _currentFolderId.value,
235
+ ...folder,
236
+ });
237
+ await folderCrud().updateOrCreate(payload as never);
238
+ await getRoot();
239
+ }
240
+
241
+ async function deleteFolder(folder: MediaFolder): Promise<void> {
242
+ const confirmed = await useConfirmStore().ask({
243
+ title: "Delete folder",
244
+ message: `Delete folder "${folder.name}"? Media inside it will not be deleted.`,
245
+ confirmText: "Delete",
246
+ dangerous: true,
247
+ });
248
+ if (!confirmed) return;
249
+ await folderCrud().delete(folder.id);
250
+ await getRoot();
251
+ }
252
+
253
+ async function deleteMedia(media: MediaItem): Promise<void> {
254
+ const confirmed = await useConfirmStore().ask({
255
+ title: "Delete media",
256
+ message: `Delete "${media.title || media.file}"?`,
257
+ confirmText: "Delete",
258
+ dangerous: true,
259
+ });
260
+ if (!confirmed) return;
261
+ await mediaCrud().delete(media.id);
262
+ if (editMedia.value?.id === media.id) editMedia.value = null;
263
+ await getRoot();
264
+ }
265
+
266
+ function select(media: MediaItem): void {
267
+ if (selectMode.value === "none") {
268
+ openEditor(media);
269
+ return;
270
+ }
271
+ if (selectMode.value === "single") {
272
+ selection.value = media;
273
+ return;
274
+ }
275
+ // multi
276
+ const current = (selection.value as MediaItem[]) ?? [];
277
+ const idx = current.findIndex((m) => m.id === media.id);
278
+ selection.value =
279
+ idx === -1
280
+ ? [...current, media]
281
+ : current.filter((m) => m.id !== media.id);
282
+ }
283
+
284
+ function setSelectionMode(mode: SelectMode): void {
285
+ selectMode.value = mode;
286
+ selection.value = mode === "multi" ? [] : null;
287
+ }
288
+
289
+ function setSelection(value: MediaItem | MediaItem[] | null): void {
290
+ selection.value = value;
291
+ }
292
+
293
+ function editSelect(id: number | number[]): void {
294
+ const ids = Array.isArray(id) ? id : [id];
295
+ const set = new Set(editList.value);
296
+ for (const i of ids) {
297
+ if (set.has(i)) set.delete(i);
298
+ else set.add(i);
299
+ }
300
+ editList.value = Array.from(set);
301
+ }
302
+
303
+ function editSelectAll(): void {
304
+ const allIds = medias.value.map((m) => m.id);
305
+ const allSelected = allIds.every((id) => editListSet.value.has(id));
306
+ if (allSelected) {
307
+ editList.value = editList.value.filter((id) => !allIds.includes(id));
308
+ } else {
309
+ const set = new Set([...editList.value, ...allIds]);
310
+ editList.value = Array.from(set);
311
+ }
312
+ }
313
+
314
+ async function deleteSelected(): Promise<void> {
315
+ const count = editList.value.length;
316
+ if (count === 0) return;
317
+ const confirmed = await useConfirmStore().ask({
318
+ title: "Delete selected media",
319
+ message: `Delete ${count} selected media?`,
320
+ confirmText: `Delete ${count}`,
321
+ dangerous: true,
322
+ });
323
+ if (!confirmed) return;
324
+ await Promise.all(editList.value.map((id) => mediaCrud().delete(id)));
325
+ editList.value = [];
326
+ useSnackStore().show(`${count} media deleted`, "success");
327
+ await getRoot();
328
+ }
329
+
330
+ async function uploadMedia(
331
+ payload: MediaUploadPayload,
332
+ onProgress?: (percent: number) => void,
333
+ ): Promise<MediaItem> {
334
+ // Build the body through the same multipart pipeline every other write uses
335
+ // (`data` JSON envelope + files at their dot-path). Hand-rolling a flat
336
+ // FormData here made uploads the only write that spoke a different wire
337
+ // format, which backends parsing the envelope reject.
338
+ const body: Record<string, unknown> = { file: payload.file };
339
+ if (payload.title) body.title = payload.title;
340
+ if (payload.alt_text) body.alt_text = payload.alt_text;
341
+ if (payload.description) body.description = payload.description;
342
+ if (payload.folder != null) body.folder = payload.folder;
343
+ const formData = applyMultipartPolicy(body, "force") as FormData;
344
+
345
+ // ofetch has no upload-progress hook, so uploads go through XHR.
346
+ // Same-origin request: the session cookie is attached automatically.
347
+ return await new Promise<MediaItem>((resolve, reject) => {
348
+ const xhr = new XMLHttpRequest();
349
+ xhr.open("POST", `${endpoints.media.replace(/\/+$/, "")}/`);
350
+ xhr.responseType = "json";
351
+ if (onProgress) {
352
+ xhr.upload.addEventListener("progress", (event) => {
353
+ if (event.lengthComputable)
354
+ onProgress(Math.round((event.loaded / event.total) * 100));
355
+ });
356
+ }
357
+ xhr.addEventListener("load", () => {
358
+ if (xhr.status >= 200 && xhr.status < 300) {
359
+ resolve(xhr.response as MediaItem);
360
+ } else {
361
+ const detail = (xhr.response as { detail?: string } | null)?.detail;
362
+ reject(new Error(detail || `Upload failed (${xhr.status})`));
363
+ }
364
+ });
365
+ xhr.addEventListener("error", () => reject(new Error("Upload failed")));
366
+ xhr.send(formData);
367
+ });
368
+ }
369
+
370
+ function setMimeType(mime: string | null): void {
371
+ // A locked picker can narrow the filter but never widen it past the lock.
372
+ mimeType.value = mime ?? lockedMime.value;
373
+ }
374
+
375
+ function lockMimeType(mime: string | null): void {
376
+ lockedMime.value = mime;
377
+ if (mime) mimeType.value = mime;
378
+ }
379
+
380
+ function reset(): void {
381
+ medias.value = [];
382
+ folders.value = [];
383
+ parentFolders.value = [];
384
+ page.value = 1;
385
+ pages.value = 1;
386
+ mimeType.value = null;
387
+ lockedMime.value = null;
388
+ loading.value = false;
389
+ editMedia.value = null;
390
+ selection.value = null;
391
+ editList.value = [];
392
+ selectMode.value = "none";
393
+ _currentFolderId.value = null;
394
+ _currentSearch.value = "";
395
+ _currentAll.value = false;
396
+ }
397
+
398
+ return {
399
+ // state
400
+ medias,
401
+ folders,
402
+ parentFolders,
403
+ page,
404
+ pages,
405
+ mimeType,
406
+ lockedMime,
407
+ loading,
408
+ editMedia,
409
+ selection,
410
+ editList,
411
+ selectMode,
412
+ // getters
413
+ parentFolder,
414
+ editListSet,
415
+ editListState,
416
+ // actions
417
+ getRoot,
418
+ navigateToFolder,
419
+ openEditor,
420
+ closeEditor,
421
+ setLang,
422
+ updateMedia,
423
+ replaceFile,
424
+ updateOrCreateFolder,
425
+ deleteFolder,
426
+ deleteMedia,
427
+ select,
428
+ setSelectionMode,
429
+ setSelection,
430
+ editSelect,
431
+ editSelectAll,
432
+ deleteSelected,
433
+ uploadMedia,
434
+ setMimeType,
435
+ lockMimeType,
436
+ reset,
437
+ };
438
+ });
@@ -0,0 +1,126 @@
1
+ /**
2
+ * Media **value** types are owned by `@mapomodule/form` (they are the value that
3
+ * lands in the form model, next to their descriptors) and re-exported here so the
4
+ * Media Manager keeps a single import surface. `uikit` already depends on `form`,
5
+ * so this direction introduces no cycle.
6
+ */
7
+ export type {
8
+ MediaLink,
9
+ MediaItem,
10
+ EnhancedMediaValue,
11
+ } from "@mapomodule/form/types";
12
+
13
+ import type { MediaItem } from "@mapomodule/form/types";
14
+
15
+ export interface MediaFolder {
16
+ id: number;
17
+ name: string;
18
+ parent?: number | null;
19
+ /**
20
+ * Materialized path of the folder (e.g. "root/images/hero").
21
+ * Camomilla returns it and the breadcrumb uses it for deduplication.
22
+ * Falls back to `id` when absent.
23
+ */
24
+ path?: string;
25
+ }
26
+
27
+ export interface MediaApiResponse {
28
+ media: {
29
+ items: MediaItem[];
30
+ paginator: { page: number; pages: number };
31
+ };
32
+ folders: MediaFolder[];
33
+ parent_folder: MediaFolder | null;
34
+ }
35
+
36
+ export type SelectMode = "none" | "single" | "multi";
37
+
38
+ export interface MediaGetRootParams {
39
+ page?: number;
40
+ folder?: number | null;
41
+ search?: string;
42
+ mime?: string | null;
43
+ all?: boolean;
44
+ }
45
+
46
+ export interface MediaUploadPayload {
47
+ file: File;
48
+ title?: string;
49
+ alt_text?: string;
50
+ description?: string;
51
+ folder?: number | null;
52
+ }
53
+
54
+ /**
55
+ * REST endpoints used by the media store. Configured via
56
+ * `mapo.uikit.media.endpoints` in `nuxt.config.ts` and forwarded to
57
+ * `runtimeConfig.public.mapoMedia`.
58
+ */
59
+ export interface MediaEndpoints {
60
+ /** Single-media CRUD: detail, partialUpdate, delete, upload (POST). Default `/api/media`. */
61
+ media: string;
62
+ /** Folder navigation + CRUD: list (root), detail (enter folder), create, delete. Default `/api/media-folders`. */
63
+ folders: string;
64
+ }
65
+
66
+ /**
67
+ * Context passed to the adapter when building list/detail query params.
68
+ * Values are the **canonical** Mapo params — the adapter maps them to the
69
+ * shape the target backend expects (e.g. `mime` → `fltr=mime_type=`).
70
+ */
71
+ export interface MediaListParamsContext {
72
+ page?: number;
73
+ search?: string;
74
+ mime?: string | null;
75
+ all?: boolean;
76
+ }
77
+
78
+ /**
79
+ * Backend adapter for the media store. Lets integrations (e.g. Camomilla)
80
+ * remap request params and normalize responses without coupling the store to a
81
+ * specific backend. Injected as `$mapoMediaAdapter` by a Nuxt plugin — functions
82
+ * are not serializable through `runtimeConfig`, so this mirrors the
83
+ * `$mapoFormRegistry` pattern.
84
+ *
85
+ * Every method is optional; the default adapter applies plain REST semantics.
86
+ */
87
+ export interface MediaAdapter {
88
+ /**
89
+ * Build the query params object for the `getRoot` list/detail request.
90
+ * @example
91
+ * // Camomilla: { page, search, fltr: 'mime_type=image/png' }
92
+ */
93
+ buildListParams?(ctx: MediaListParamsContext): Record<string, unknown>;
94
+ /**
95
+ * Normalize a raw `getRoot` response (folder list or detail) into the
96
+ * canonical {@link MediaApiResponse} shape. Default = identity.
97
+ */
98
+ parseRootResponse?(raw: unknown): MediaApiResponse;
99
+ /**
100
+ * Build query params for the single-media detail fetch (`openEditor`).
101
+ * @example
102
+ * // Camomilla: { language_code: 'it' }
103
+ */
104
+ buildDetailParams?(ctx: { lang?: string }): Record<string, unknown>;
105
+ /**
106
+ * Map a canonical folder (`{ name, parent }`) to the backend's create/update
107
+ * payload.
108
+ * @example
109
+ * // Camomilla: { title, slug: slugify(title), updir: parent }
110
+ */
111
+ buildFolderPayload?(folder: Partial<MediaFolder>): Record<string, unknown>;
112
+ /**
113
+ * Build the PATCH payload for a media metadata update.
114
+ * Default: `{ title, alt_text, description, translations }`.
115
+ */
116
+ buildMediaPatchPayload?(media: MediaItem): Record<string, unknown>;
117
+ /**
118
+ * Build the multipart PATCH payload for a file replacement.
119
+ * @example
120
+ * // Default REST: { file, maintain_url } — Camomilla: { file, same_url }
121
+ */
122
+ buildReplaceFilePayload?(
123
+ file: File,
124
+ maintainUrl: boolean,
125
+ ): Record<string, unknown>;
126
+ }