@asteby/metacore-runtime-react 53.10.2 → 53.12.0

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 (44) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/dist/bulk-image-dialog.d.ts +31 -0
  3. package/dist/bulk-image-dialog.d.ts.map +1 -0
  4. package/dist/bulk-image-dialog.js +339 -0
  5. package/dist/bulk-image-import.d.ts +158 -0
  6. package/dist/bulk-image-import.d.ts.map +1 -0
  7. package/dist/bulk-image-import.js +310 -0
  8. package/dist/dynamic-crud-page.d.ts.map +1 -1
  9. package/dist/dynamic-crud-page.js +2 -1
  10. package/dist/dynamic-form.d.ts +10 -1
  11. package/dist/dynamic-form.d.ts.map +1 -1
  12. package/dist/dynamic-form.js +6 -6
  13. package/dist/dynamic-relation-helpers.d.ts +65 -0
  14. package/dist/dynamic-relation-helpers.d.ts.map +1 -1
  15. package/dist/dynamic-relation-helpers.js +178 -2
  16. package/dist/dynamic-relation.d.ts +16 -0
  17. package/dist/dynamic-relation.d.ts.map +1 -1
  18. package/dist/dynamic-relation.js +277 -13
  19. package/dist/dynamic-relations.d.ts.map +1 -1
  20. package/dist/dynamic-relations.js +1 -1
  21. package/dist/index.d.ts +2 -0
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +2 -0
  24. package/dist/relation-gallery.d.ts +31 -0
  25. package/dist/relation-gallery.d.ts.map +1 -0
  26. package/dist/relation-gallery.js +154 -0
  27. package/dist/upload-field.d.ts +19 -1
  28. package/dist/upload-field.d.ts.map +1 -1
  29. package/dist/upload-field.js +50 -3
  30. package/package.json +2 -1
  31. package/src/__tests__/bulk-image-dialog.test.tsx +127 -0
  32. package/src/__tests__/bulk-image-import.test.ts +129 -0
  33. package/src/__tests__/relation-gallery-helpers.test.ts +154 -0
  34. package/src/__tests__/relation-gallery.test.tsx +229 -0
  35. package/src/bulk-image-dialog.tsx +594 -0
  36. package/src/bulk-image-import.ts +456 -0
  37. package/src/dynamic-crud-page.tsx +2 -0
  38. package/src/dynamic-form.tsx +20 -2
  39. package/src/dynamic-relation-helpers.ts +210 -2
  40. package/src/dynamic-relation.tsx +329 -15
  41. package/src/dynamic-relations.tsx +1 -0
  42. package/src/index.ts +12 -0
  43. package/src/relation-gallery.tsx +489 -0
  44. package/src/upload-field.tsx +60 -2
@@ -0,0 +1,310 @@
1
+ import { relationColumnUi, relationGalleryColumn } from './dynamic-relation-helpers';
2
+ export const BULK_IMAGE_EXTENSIONS = ['jpg', 'jpeg', 'png', 'webp', 'gif', 'avif'];
3
+ /** Lado largo por debajo del cual la foto se avisa como «baja resolución». */
4
+ export const DEFAULT_MIN_LONG_SIDE = 600;
5
+ /** Máximo de archivos por lote (la vista previa y la subida viven en memoria). */
6
+ export const MAX_BULK_FILES = 500;
7
+ // ---------------------------------------------------------------------------
8
+ // Nombres de archivo
9
+ // ---------------------------------------------------------------------------
10
+ /** Último segmento de una ruta (acepta `/` y `\`). */
11
+ export function baseName(path) {
12
+ const parts = path.split(/[\\/]/);
13
+ return parts[parts.length - 1] ?? '';
14
+ }
15
+ /** ¿Es una entrada ignorable (carpetas de macOS, archivos ocultos, no-imagen)? */
16
+ export function isIgnoredEntry(path) {
17
+ if (path.endsWith('/') || path.endsWith('\\'))
18
+ return true;
19
+ if (/(^|[\\/])__MACOSX([\\/]|$)/.test(path))
20
+ return true;
21
+ const name = baseName(path);
22
+ if (name === '' || name.startsWith('.'))
23
+ return true;
24
+ return !isImageName(name);
25
+ }
26
+ export function isImageName(name) {
27
+ const ext = name.split('.').pop()?.toLowerCase() ?? '';
28
+ return BULK_IMAGE_EXTENSIONS.includes(ext);
29
+ }
30
+ /**
31
+ * `SKU.ext` → orden 1; `SKU_2.ext` → orden 2. Como un SKU real puede terminar
32
+ * en `_N`, se ofrecen los dos candidatos y gana el que exista en el catálogo
33
+ * (primero el nombre completo).
34
+ */
35
+ export function parseImageName(path) {
36
+ const name = baseName(path);
37
+ const dot = name.lastIndexOf('.');
38
+ const stem = (dot > 0 ? name.slice(0, dot) : name).trim();
39
+ const candidates = [];
40
+ if (stem)
41
+ candidates.push({ sku: stem, order: 1 });
42
+ const m = /^(.+?)_(\d{1,3})$/.exec(stem);
43
+ if (m)
44
+ candidates.push({ sku: m[1].trim(), order: Math.max(1, parseInt(m[2], 10)) });
45
+ return { stem, candidates };
46
+ }
47
+ export const normalizeSku = (s) => s.trim().toLowerCase();
48
+ /**
49
+ * SKUs a consultar (todos los candidatos, sin repetir), para pedirlos por
50
+ * lotes. El `IN` del servidor distingue mayúsculas, así que se piden también
51
+ * las variantes en MAYÚSCULAS y minúsculas; el cruce local no distingue.
52
+ */
53
+ export function collectCandidateSkus(names) {
54
+ const seen = new Set();
55
+ for (const n of names) {
56
+ for (const c of parseImageName(n).candidates) {
57
+ for (const v of [c.sku, c.sku.toUpperCase(), c.sku.toLowerCase()])
58
+ seen.add(v);
59
+ }
60
+ }
61
+ return [...seen];
62
+ }
63
+ export function chunk(arr, size) {
64
+ const out = [];
65
+ for (let i = 0; i < arr.length; i += size)
66
+ out.push(arr.slice(i, i + size));
67
+ return out;
68
+ }
69
+ /**
70
+ * Busca la relación 1:N con galería. Necesita la metadata del hijo (para saber
71
+ * cuál es su columna de imagen); `childMetadata` la resuelve el llamador.
72
+ */
73
+ export function deriveBulkImageTarget(relation, childMetadata) {
74
+ if (relation.kind !== 'one_to_many')
75
+ return null;
76
+ const img = relationGalleryColumn(childMetadata);
77
+ if (!img)
78
+ return null;
79
+ // Sin la FK declarada el listado ignoraría `f_<fk>=in:` en silencio y devolvería todo.
80
+ if (!(childMetadata?.columns ?? []).some((c) => c.key === relation.foreign_key))
81
+ return null;
82
+ const sc = (img.styleConfig ?? {});
83
+ const keyOf = (derive) => (childMetadata?.columns ?? []).find((c) => relationColumnUi(c).derive === derive)?.key;
84
+ const storagePath = (sc.storage_path ?? sc.storagePath);
85
+ return {
86
+ childModel: relation.through,
87
+ foreignKey: relation.foreign_key,
88
+ imageKey: img.key,
89
+ widthKey: keyOf('image_width'),
90
+ heightKey: keyOf('image_height'),
91
+ positionKey: keyOf('next_position') ?? (childMetadata?.columns ?? []).find((c) => c.key === 'position')?.key,
92
+ storagePath: typeof storagePath === 'string' && storagePath ? storagePath : undefined,
93
+ accept: img.accept || 'image/*',
94
+ maxSize: img.maxSize ?? img.max_size,
95
+ scope: relation.scope,
96
+ };
97
+ }
98
+ /** ¿La fila se importa por defecto? (`low_res` sí, con aviso; el usuario puede excluirla). */
99
+ export const isImportable = (r) => r.status === 'ok' || r.status === 'low_res';
100
+ /**
101
+ * Cruza los archivos con el catálogo. Reglas:
102
+ * - gana el nombre completo; si no existe como SKU, se prueba quitando `_N`;
103
+ * - dos archivos para el mismo SKU y el mismo orden son duplicados (se
104
+ * conserva el primero por ruta; el resto se marca y no se importa);
105
+ * - las fotos de un producto se numeran a continuación de las que ya tiene,
106
+ * en orden de `_N` (y de ruta a igualdad).
107
+ */
108
+ export function buildPreview(inputs, parentsBySku, opts = {}) {
109
+ const minLong = opts.minLongSide ?? DEFAULT_MIN_LONG_SIDE;
110
+ const rows = inputs
111
+ .slice()
112
+ .sort((a, b) => a.path.localeCompare(b.path, undefined, { numeric: true }))
113
+ .map((inp, i) => {
114
+ const base = { ...inp, key: `${i}:${inp.path}`, status: 'ok' };
115
+ if (inp.decodable === false)
116
+ return { ...base, status: 'invalid_image', note: 'No es una imagen válida' };
117
+ if (opts.maxSize && inp.size > opts.maxSize)
118
+ return { ...base, status: 'too_large', note: 'Excede el tamaño máximo' };
119
+ const parsed = parseImageName(inp.path);
120
+ for (const c of parsed.candidates) {
121
+ const parent = parentsBySku.get(normalizeSku(c.sku));
122
+ if (parent) {
123
+ const long = Math.max(inp.width ?? 0, inp.height ?? 0);
124
+ const lowRes = long > 0 && long < minLong;
125
+ return {
126
+ ...base,
127
+ sku: parent.sku,
128
+ order: c.order,
129
+ parent,
130
+ status: lowRes ? 'low_res' : 'ok',
131
+ note: lowRes ? `Baja resolución (${inp.width}×${inp.height})` : undefined,
132
+ };
133
+ }
134
+ }
135
+ return { ...base, sku: parsed.stem, status: 'sku_not_found', note: 'SKU no encontrado' };
136
+ });
137
+ // Duplicados: mismo producto + mismo orden.
138
+ const seen = new Set();
139
+ for (const r of rows) {
140
+ if (!r.parent)
141
+ continue;
142
+ const k = `${r.parent.id}#${r.order}`;
143
+ if (seen.has(k)) {
144
+ r.status = 'duplicate';
145
+ r.note = `Duplicado: ya hay otra foto ${r.order === 1 ? 'principal' : `_${r.order}`} para ${r.parent.sku}`;
146
+ }
147
+ else {
148
+ seen.add(k);
149
+ }
150
+ }
151
+ // Posiciones consecutivas por producto, a continuación de las existentes.
152
+ const byParent = new Map();
153
+ for (const r of rows) {
154
+ if (!r.parent || !isImportable(r))
155
+ continue;
156
+ const list = byParent.get(r.parent.id) ?? [];
157
+ list.push(r);
158
+ byParent.set(r.parent.id, list);
159
+ }
160
+ for (const list of byParent.values()) {
161
+ list.sort((a, b) => (a.order ?? 1) - (b.order ?? 1) || a.path.localeCompare(b.path, undefined, { numeric: true }));
162
+ list.forEach((r, i) => {
163
+ r.position = (r.parent?.existingMaxPosition ?? -1) + i + 1;
164
+ });
165
+ }
166
+ return rows;
167
+ }
168
+ export function summarizePreview(rows, excluded) {
169
+ const s = {
170
+ total: rows.length, importable: 0, products: 0, ok: 0, low_res: 0,
171
+ sku_not_found: 0, duplicate: 0, invalid_image: 0, too_large: 0,
172
+ };
173
+ const parents = new Set();
174
+ for (const r of rows) {
175
+ s[r.status] += 1;
176
+ if (isImportable(r) && !excluded?.has(r.key)) {
177
+ s.importable += 1;
178
+ if (r.parent)
179
+ parents.add(r.parent.id);
180
+ }
181
+ }
182
+ s.products = parents.size;
183
+ return s;
184
+ }
185
+ /**
186
+ * Tras excluir filas a mano, las posiciones se recalculan para no dejar
187
+ * huecos (la 2.ª foto de un producto cuya 1.ª se excluyó pasa a ser la 1.ª).
188
+ */
189
+ export function selectForImport(rows, excluded) {
190
+ const byOrder = (a, b) => (a.order ?? 1) - (b.order ?? 1) || a.path.localeCompare(b.path, undefined, { numeric: true });
191
+ // Mismo criterio que buildPreview: dentro de cada producto manda `_N`, no la ruta.
192
+ const picked = rows.filter((r) => isImportable(r) && !excluded.has(r.key)).sort(byOrder);
193
+ const counter = new Map();
194
+ return picked.map((r) => {
195
+ const n = (counter.get(r.parent.id) ?? 0) + 1;
196
+ counter.set(r.parent.id, n);
197
+ return { ...r, position: r.parent.existingMaxPosition + n };
198
+ });
199
+ }
200
+ // ---------------------------------------------------------------------------
201
+ // Cuerpo de la fila hija
202
+ // ---------------------------------------------------------------------------
203
+ export function buildChildPayload(target, row, url) {
204
+ const out = {
205
+ ...(target.scope || {}),
206
+ [target.imageKey]: url,
207
+ [target.foreignKey]: row.parent.id,
208
+ };
209
+ if (target.positionKey && typeof row.position === 'number')
210
+ out[target.positionKey] = row.position;
211
+ if (target.widthKey && row.width)
212
+ out[target.widthKey] = Math.round(row.width);
213
+ if (target.heightKey && row.height)
214
+ out[target.heightKey] = Math.round(row.height);
215
+ return out;
216
+ }
217
+ const LOG_KEY = 'metacore.bulk-image-batches.v1';
218
+ const MAX_LOGS = 10;
219
+ export function newBatchId(now = new Date()) {
220
+ return `bulk-${now.toISOString().replace(/[-:.TZ]/g, '').slice(0, 14)}-${Math.random().toString(36).slice(2, 6)}`;
221
+ }
222
+ export function loadBatchLogs(storage = safeStorage(), scope) {
223
+ try {
224
+ const raw = storage?.getItem(LOG_KEY);
225
+ const parsed = raw ? JSON.parse(raw) : [];
226
+ if (!Array.isArray(parsed))
227
+ return [];
228
+ // Con `scope`, solo los lotes de esa organización/usuario.
229
+ return scope === undefined ? parsed : parsed.filter((l) => !!l.scope && l.scope === scope);
230
+ }
231
+ catch {
232
+ return [];
233
+ }
234
+ }
235
+ export function saveBatchLog(log, storage = safeStorage()) {
236
+ try {
237
+ const all = loadBatchLogs(storage).filter((l) => l.batchId !== log.batchId);
238
+ all.unshift(log);
239
+ storage?.setItem(LOG_KEY, JSON.stringify(all.slice(0, MAX_LOGS)));
240
+ }
241
+ catch {
242
+ /* almacenamiento no disponible: el registro descargable sigue siendo válido */
243
+ }
244
+ }
245
+ function safeStorage() {
246
+ try {
247
+ return typeof localStorage !== 'undefined' ? localStorage : undefined;
248
+ }
249
+ catch {
250
+ return undefined;
251
+ }
252
+ }
253
+ /** Filas del lote que aún se pueden deshacer. */
254
+ export const pendingUndo = (log) => log.items.filter((i) => !i.undone);
255
+ const MIME_BY_EXT = {
256
+ jpg: 'image/jpeg', jpeg: 'image/jpeg', png: 'image/png', webp: 'image/webp', gif: 'image/gif', avif: 'image/avif',
257
+ };
258
+ /** Máximo descomprimido aceptado por archivo de un ZIP (defensa ante zip-bombs). */
259
+ export const MAX_ENTRY_BYTES = 25 * 1024 * 1024;
260
+ export const MAX_TOTAL_BYTES = 400 * 1024 * 1024;
261
+ /** Descomprime un ZIP en el navegador y devuelve solo las imágenes. */
262
+ export async function readZipImages(zip) {
263
+ const { unzipSync } = await import('fflate');
264
+ const data = new Uint8Array(await zip.arrayBuffer());
265
+ let total = 0;
266
+ let skipped = 0;
267
+ const files = [];
268
+ const entries = unzipSync(data, {
269
+ filter: (f) => {
270
+ if (f.name.endsWith('/'))
271
+ return false;
272
+ // Solo almacenado (0) o deflate (8): deflate64/cifrado abortarían todo el ZIP.
273
+ if (isIgnoredEntry(f.name) || (f.compression !== 0 && f.compression !== 8)) {
274
+ skipped += 1;
275
+ return false;
276
+ }
277
+ total += f.originalSize;
278
+ if (f.originalSize > MAX_ENTRY_BYTES || total > MAX_TOTAL_BYTES) {
279
+ skipped += 1;
280
+ return false;
281
+ }
282
+ return true;
283
+ },
284
+ });
285
+ for (const [path, bytes] of Object.entries(entries)) {
286
+ const ext = path.split('.').pop()?.toLowerCase() ?? '';
287
+ files.push({ path, file: new File([bytes], baseName(path), { type: MIME_BY_EXT[ext] ?? '' }) });
288
+ }
289
+ return { files, skipped };
290
+ }
291
+ /** Normaliza lo que entrega un `<input>` / drop: ZIP o imágenes sueltas/carpeta. */
292
+ export async function collectBulkFiles(list) {
293
+ const files = [];
294
+ let skipped = 0;
295
+ for (const f of list) {
296
+ if (/\.zip$/i.test(f.name) || f.type === 'application/zip' || f.type === 'application/x-zip-compressed') {
297
+ const z = await readZipImages(f);
298
+ files.push(...z.files);
299
+ skipped += z.skipped;
300
+ continue;
301
+ }
302
+ const rel = f.webkitRelativePath || f.name;
303
+ if (isIgnoredEntry(rel)) {
304
+ skipped += 1;
305
+ continue;
306
+ }
307
+ files.push({ path: rel, file: f });
308
+ }
309
+ return { files, skipped };
310
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"dynamic-crud-page.d.ts","sourceRoot":"","sources":["../src/dynamic-crud-page.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAKN,MAAM,OAAO,CAAA;AAMd,OAAO,EAKH,KAAK,eAAe,EACvB,MAAM,wBAAwB,CAAA;AAO/B,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,SAAS,CAAA;AAEnE,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;mDAC+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AASD,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,sBAAsB,CAAA;IAC7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,sDAAsD;IACtD,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAA;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B;;;;OAIG;IACH,aAAa,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IACvE;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;CACvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAmP1D"}
1
+ {"version":3,"file":"dynamic-crud-page.d.ts","sourceRoot":"","sources":["../src/dynamic-crud-page.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAKN,MAAM,OAAO,CAAA;AAMd,OAAO,EAKH,KAAK,eAAe,EACvB,MAAM,wBAAwB,CAAA;AAQ/B,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,SAAS,CAAA;AAEnE,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;mDAC+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AASD,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,sBAAsB,CAAA;IAC7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,sDAAsD;IACtD,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAA;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B;;;;OAIG;IACH,aAAa,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IACvE;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;CACvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAoP1D"}
@@ -34,6 +34,7 @@ import { ExportDialog } from './dialogs/export';
34
34
  import { ImportDialog } from './dialogs/import';
35
35
  import { getModelExtension } from './model-extension-registry';
36
36
  import { ModelActionToolbar } from './model-action-toolbar';
37
+ import { BulkImageImportButton } from './bulk-image-dialog';
37
38
  import { resolveListPrimaryAction } from './list-primary-action';
38
39
  import { useCan, modelCapability } from './permissions-context';
39
40
  const defaultStrings = {
@@ -139,5 +140,5 @@ export function DynamicCRUDPage(props) {
139
140
  const titleCls = classes?.title ?? 'text-2xl font-bold tracking-tight';
140
141
  const toolbarCls = classes?.toolbar ?? 'flex items-center gap-2';
141
142
  const tableWrapperCls = classes?.tableWrapper ?? 'flex-1 min-h-0';
142
- return (_jsxs("div", { className: rootCls, children: [_jsxs("div", { className: containerCls, children: [ext?.headerExtras && _jsx(ext.headerExtras, { model: model, onRefresh: handleRefresh }), headerExtras, _jsxs("div", { className: headerCls, children: [metadata ? (_jsx("h1", { className: titleCls, children: title })) : (_jsx("div", { className: 'h-8 w-48 bg-muted rounded animate-pulse' })), _jsxs("div", { className: toolbarCls, children: [showRefresh && (_jsx("button", { type: 'button', onClick: handleRefresh, "aria-label": strings.refresh, className: 'inline-flex items-center justify-center size-9 rounded-md border border-border bg-background hover:bg-accent text-foreground', children: _jsx(RefreshCw, { className: 'size-4' }) })), metadata && showExport && (_jsxs("button", { type: 'button', onClick: () => setOpenExport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Download, { className: 'size-4' }), strings.export] })), metadata && showImport && (_jsxs("button", { type: 'button', onClick: () => setOpenImport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Upload, { className: 'size-4' }), strings.import] })), ext?.toolbarExtras && _jsx(ext.toolbarExtras, { model: model, onRefresh: handleRefresh }), toolbarExtras, _jsx(ModelActionToolbar, { model: model, endpoint: dataEndpoint, actions: metadata?.actions, primaryActionKey: ext?.primaryActionKey, onChange: handleRefresh }), showCreate && (_jsxs("button", { type: 'button', "data-primary": 'true', onClick: () => setOpenCreate(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md bg-primary text-primary-foreground hover:opacity-90 text-sm font-medium', children: [_jsx(Plus, { className: 'size-4' }), resolvedNewLabel ?? `${strings.newPrefix} ${singular}`] }))] })] }), _jsx("div", { className: tableWrapperCls, children: _jsx(DynamicTable, { model: model, endpoint: dataEndpoint, refreshTrigger: refreshKey, defaultFilters: tableFilters }, model) })] }), showCreate && guidedForms && (_jsx(DocumentFormDialog, { open: openCreate, onOpenChange: setOpenCreate, model: model, endpoint: dataEndpoint, forms: guidedForms, initialType: initialCreate?.type, initialSource: initialCreate?.source, onSaved: handleRefresh, onDelegateCreate: onDelegateCreate })), showCreate && !guidedForms && (_jsx(DynamicRecordDialog, { open: openCreate && !initialCreate?.source, onOpenChange: setOpenCreate, mode: 'create', model: model, endpoint: dataEndpoint, onSaved: handleRefresh })), metadata && showExport && (_jsx(ExportDialog, { open: openExport, onOpenChange: setOpenExport, model: model, metadata: metadata })), metadata && showImport && (_jsx(ImportDialog, { open: openImport, onOpenChange: setOpenImport, model: model, metadata: metadata, onImported: handleRefresh }))] }));
143
+ return (_jsxs("div", { className: rootCls, children: [_jsxs("div", { className: containerCls, children: [ext?.headerExtras && _jsx(ext.headerExtras, { model: model, onRefresh: handleRefresh }), headerExtras, _jsxs("div", { className: headerCls, children: [metadata ? (_jsx("h1", { className: titleCls, children: title })) : (_jsx("div", { className: 'h-8 w-48 bg-muted rounded animate-pulse' })), _jsxs("div", { className: toolbarCls, children: [showRefresh && (_jsx("button", { type: 'button', onClick: handleRefresh, "aria-label": strings.refresh, className: 'inline-flex items-center justify-center size-9 rounded-md border border-border bg-background hover:bg-accent text-foreground', children: _jsx(RefreshCw, { className: 'size-4' }) })), metadata && showExport && (_jsxs("button", { type: 'button', onClick: () => setOpenExport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Download, { className: 'size-4' }), strings.export] })), metadata && showImport && (_jsxs("button", { type: 'button', onClick: () => setOpenImport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Upload, { className: 'size-4' }), strings.import] })), metadata && !scoped.hideCreate && can(modelCapability(model, 'create')) && _jsx(BulkImageImportButton, { model: model, metadata: metadata, onChange: handleRefresh }), ext?.toolbarExtras && _jsx(ext.toolbarExtras, { model: model, onRefresh: handleRefresh }), toolbarExtras, _jsx(ModelActionToolbar, { model: model, endpoint: dataEndpoint, actions: metadata?.actions, primaryActionKey: ext?.primaryActionKey, onChange: handleRefresh }), showCreate && (_jsxs("button", { type: 'button', "data-primary": 'true', onClick: () => setOpenCreate(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md bg-primary text-primary-foreground hover:opacity-90 text-sm font-medium', children: [_jsx(Plus, { className: 'size-4' }), resolvedNewLabel ?? `${strings.newPrefix} ${singular}`] }))] })] }), _jsx("div", { className: tableWrapperCls, children: _jsx(DynamicTable, { model: model, endpoint: dataEndpoint, refreshTrigger: refreshKey, defaultFilters: tableFilters }, model) })] }), showCreate && guidedForms && (_jsx(DocumentFormDialog, { open: openCreate, onOpenChange: setOpenCreate, model: model, endpoint: dataEndpoint, forms: guidedForms, initialType: initialCreate?.type, initialSource: initialCreate?.source, onSaved: handleRefresh, onDelegateCreate: onDelegateCreate })), showCreate && !guidedForms && (_jsx(DynamicRecordDialog, { open: openCreate && !initialCreate?.source, onOpenChange: setOpenCreate, mode: 'create', model: model, endpoint: dataEndpoint, onSaved: handleRefresh })), metadata && showExport && (_jsx(ExportDialog, { open: openExport, onOpenChange: setOpenExport, model: model, metadata: metadata })), metadata && showImport && (_jsx(ImportDialog, { open: openImport, onOpenChange: setOpenImport, model: model, metadata: metadata, onImported: handleRefresh }))] }));
143
144
  }
@@ -32,8 +32,17 @@ export interface DynamicFormProps {
32
32
  * debe ser flex-col con alto máximo (p.ej. `max-h-[90dvh]`).
33
33
  */
34
34
  scrollableBody?: boolean;
35
+ /**
36
+ * Side data an upload widget learned about the file it stored (an image's
37
+ * natural width/height). Lets the host fill derived columns that are not
38
+ * form inputs. Optional; forms without it behave as before.
39
+ */
40
+ onFieldMeta?: (key: string, meta: {
41
+ width?: number;
42
+ height?: number;
43
+ }) => void;
35
44
  }
36
- export declare function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel, cancelLabel, disabled, formLayout, scrollableBody, }: DynamicFormProps): import("react").JSX.Element;
45
+ export declare function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel, cancelLabel, disabled, formLayout, scrollableBody, onFieldMeta, }: DynamicFormProps): import("react").JSX.Element;
37
46
  /**
38
47
  * Radix Select puede emitir `onValueChange('')` sin interacción del usuario (su
39
48
  * <select> nativo oculto colapsa a '' si recibe el valor antes que sus
@@ -1 +1 @@
1
- {"version":3,"file":"dynamic-form.d.ts","sourceRoot":"","sources":["../src/dynamic-form.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAerE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EACH,cAAc,EACd,aAAa,EAOhB,MAAM,uBAAuB,CAAA;AAc9B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEzF,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CAC3B;AAsBD,wBAAgB,WAAW,CAAC,EACxB,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAuB,EACvB,WAAwB,EACxB,QAAgB,EAChB,UAAU,EACV,cAAsB,GACzB,EAAE,gBAAgB,+BAiOlB;AAsQD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,EAC1B,YAAY,EAAE,SAAS,OAAO,EAAE,GACjC,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAMrB"}
1
+ {"version":3,"file":"dynamic-form.d.ts","sourceRoot":"","sources":["../src/dynamic-form.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAerE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EACH,cAAc,EACd,aAAa,EAOhB,MAAM,uBAAuB,CAAA;AAc9B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEzF,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACjF;AAsBD,wBAAgB,WAAW,CAAC,EACxB,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAuB,EACvB,WAAwB,EACxB,QAAgB,EAChB,UAAU,EACV,cAAsB,EACtB,WAAW,GACd,EAAE,gBAAgB,+BAkOlB;AAgRD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,EAC1B,YAAY,EAAE,SAAS,OAAO,EAAE,GACjC,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAMrB"}
@@ -45,7 +45,7 @@ function seedValues(fields, initialValues) {
45
45
  }
46
46
  const isReadonlyField = (f) => !!f.readonly ||
47
47
  !!f.readOnly;
48
- export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel = 'Guardar', cancelLabel = 'Cancelar', disabled = false, formLayout, scrollableBody = false, }) {
48
+ export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel = 'Guardar', cancelLabel = 'Cancelar', disabled = false, formLayout, scrollableBody = false, onFieldMeta, }) {
49
49
  const [errors, setErrors] = useState({});
50
50
  const [submitting, setSubmitting] = useState(false);
51
51
  // Readonly fields are system-owned (connection state, sync-written values):
@@ -147,7 +147,7 @@ export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitL
147
147
  // Renders one group's fields into the responsive 2-column grid: scalar
148
148
  // header fields flow through it; line-items grids (and textareas) span full
149
149
  // width so the row table / memo gets room. Shared by every layout mode.
150
- const renderGrid = (groupFields) => (_jsx("div", { className: "grid gap-4 sm:grid-cols-2", children: groupFields.map((field) => (_jsx(FieldRow, { field: field, value: values[field.key], onChange: (v) => update(field.key, v), values: values, error: errors[field.key], initialValues: initialValues }, field.key))) }));
150
+ const renderGrid = (groupFields) => (_jsx("div", { className: "grid gap-4 sm:grid-cols-2", children: groupFields.map((field) => (_jsx(FieldRow, { field: field, value: values[field.key], onChange: (v) => update(field.key, v), values: values, error: errors[field.key], initialValues: initialValues, onFieldMeta: onFieldMeta }, field.key))) }));
151
151
  // scrollableBody: el cuerpo hace scroll y el footer de botones queda fijo.
152
152
  const formClass = scrollableBody ? 'flex min-h-0 flex-1 flex-col gap-4' : 'grid gap-4';
153
153
  const bodyClass = scrollableBody ? '-mx-1 grid min-h-0 flex-1 gap-4 overflow-y-auto px-1' : 'grid gap-4';
@@ -190,7 +190,7 @@ export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitL
190
190
  // component so a STATIC enum select whose options are all gated out by a sibling
191
191
  // value (`when`) can hide the ENTIRE row (label included) and run its reset
192
192
  // effect with valid hook ordering.
193
- function FieldRow({ field, value, onChange, values, error, initialValues }) {
193
+ function FieldRow({ field, value, onChange, values, error, initialValues, onFieldMeta }) {
194
194
  const isStaticSelect = resolveWidget(field) === 'select' && !field.ref && Array.isArray(field.options);
195
195
  const effectiveOptions = isStaticSelect
196
196
  ? applyOptionWhen(field.options, values, getDependsOn(field))
@@ -210,7 +210,7 @@ function FieldRow({ field, value, onChange, values, error, initialValues }) {
210
210
  const fullWidth = isLineItemsField(field) ||
211
211
  resolveWidget(field) === 'textarea' ||
212
212
  resolveWidget(field) === 'richtext';
213
- return (_jsxs("div", { className: 'grid gap-2 ' + (fullWidth ? 'sm:col-span-2' : ''), children: [_jsxs(Label, { htmlFor: field.key, children: [field.label, field.required && _jsx("span", { className: "text-red-500 ml-1", children: "*" })] }), _jsx(FieldRenderer, { field: field, value: value, onChange: onChange, initialValues: initialValues, values: values, effectiveOptions: effectiveOptions, error: error }), error && _jsx("span", { className: "text-red-500 text-sm", role: "alert", children: error })] }));
213
+ return (_jsxs("div", { className: 'grid gap-2 ' + (fullWidth ? 'sm:col-span-2' : ''), children: [_jsxs(Label, { htmlFor: field.key, children: [field.label, field.required && _jsx("span", { className: "text-red-500 ml-1", children: "*" })] }), _jsx(FieldRenderer, { field: field, value: value, onChange: onChange, initialValues: initialValues, values: values, effectiveOptions: effectiveOptions, error: error, onFieldMeta: onFieldMeta }), error && _jsx("span", { className: "text-red-500 text-sm", role: "alert", children: error })] }));
214
214
  }
215
215
  // seedOptionFromSibling builds a pre-resolved option for an FK field from the
216
216
  // resolved sibling the backend served on the initial record (e.g. a line item's
@@ -237,7 +237,7 @@ function seedOptionFromSibling(field, value, initialValues) {
237
237
  icon: sib.icon,
238
238
  };
239
239
  }
240
- function FieldRenderer({ field, value, onChange, initialValues, values, effectiveOptions, error, }) {
240
+ function FieldRenderer({ field, value, onChange, initialValues, values, effectiveOptions, error, onFieldMeta, }) {
241
241
  // Host-registered widget (`widget: "<name>"`) wins over every built-in and
242
242
  // type-based branch. Unregistered names fall through untouched.
243
243
  useFieldWidgetRegistryVersion();
@@ -267,7 +267,7 @@ function FieldRenderer({ field, value, onChange, initialValues, values, effectiv
267
267
  // File upload → themed picker that POSTs to the host upload endpoint and
268
268
  // stores the returned file url/path as the field value.
269
269
  if (widget === 'upload') {
270
- return _jsx(UploadField, { field: field, value: value, onChange: onChange });
270
+ return (_jsx(UploadField, { field: field, value: value, onChange: onChange, onFileMeta: onFieldMeta ? (meta) => onFieldMeta(field.key, meta) : undefined }));
271
271
  }
272
272
  // Icon picker → lucide glyph search grid, with an "Imagen" mode that
273
273
  // delegates to the same UploadField as `upload`. Stores a plain string:
@@ -1,5 +1,70 @@
1
1
  import type { ActionFieldDef, ColumnDefinition, TableMetadata } from './types';
2
2
  export type DynamicRelationKind = 'one_to_many' | 'many_to_many';
3
+ export declare function isManagedRelationColumn(key: string): boolean;
4
+ export declare function relationMediaKind(col: ColumnDefinition): 'image' | 'file' | undefined;
5
+ export type RelationDerive = 'image_width' | 'image_height' | 'next_position';
6
+ /**
7
+ * Declarative form hints a child column carries in its manifest
8
+ * `display_config` (served as `styleConfig`, no kernel field needed):
9
+ * - `form: "hidden"` → never an input in the row form.
10
+ * - `derive: <RelationDerive>` → not an input; filled by the SDK (image
11
+ * size measured in the browser on upload, next gallery position on create).
12
+ * - `default_from_parent: <k>` → create-form initial value from the parent
13
+ * record's `<k>` (e.g. the product name as the image alt text), editable.
14
+ * - `empty_label: <text>` → placeholder of an optional picker
15
+ * ("Para todas las variantes").
16
+ * - `gallery: true` (on the image column) → the relation renders as a
17
+ * thumbnail gallery instead of a table.
18
+ * A column with none of them behaves exactly as before.
19
+ */
20
+ export interface RelationColumnUi {
21
+ form?: 'hidden' | 'advanced';
22
+ derive?: RelationDerive;
23
+ defaultFromParent?: string;
24
+ emptyLabel?: string;
25
+ gallery?: boolean;
26
+ }
27
+ export declare function relationColumnUi(col: ColumnDefinition): RelationColumnUi;
28
+ /** The gallery image column (media + `display_config.gallery: true`), if any. */
29
+ export declare function relationGalleryColumn(metadata: Pick<TableMetadata, 'columns'> | null | undefined): ColumnDefinition | undefined;
30
+ export interface ImageMeta {
31
+ width?: number;
32
+ height?: number;
33
+ }
34
+ /**
35
+ * Values the SDK fills for derived columns of a child row. `next_position`
36
+ * only on create (an edit keeps the stored order); image size only when the
37
+ * upload measured one. Never invents a value it does not know.
38
+ */
39
+ export declare function relationDerivedValues(metadata: Pick<TableMetadata, 'columns'> | null | undefined, ctx: {
40
+ isCreate: boolean;
41
+ rows: Record<string, any>[];
42
+ image?: ImageMeta | null;
43
+ }): Record<string, number>;
44
+ /** Create-form initial values copied from the parent (`default_from_parent`). */
45
+ export declare function relationInitialValues(metadata: Pick<TableMetadata, 'columns'> | null | undefined, parent: Record<string, unknown> | null | undefined): Record<string, any>;
46
+ /** Key of the child model's ordering column (`position`), if it declares one. */
47
+ export declare function relationPositionKey(metadata: Pick<TableMetadata, 'columns'> | null | undefined): string | undefined;
48
+ /** True when the list endpoint can sort by the position column (declared sortable). */
49
+ export declare function relationPositionSortable(metadata: Pick<TableMetadata, 'columns'> | null | undefined): boolean;
50
+ /** Rows sorted ascending by their position column; rows without one go last, stable. */
51
+ export declare function sortRelationRows<T extends Record<string, any>>(rows: T[], positionKey?: string): T[];
52
+ /** Default position for a new child row: one past the highest loaded, 0 when empty. */
53
+ export declare function nextRelationPosition(rows: Record<string, any>[], positionKey?: string): number;
54
+ /**
55
+ * Renumbers a gallery contiguously (0..n-1). Order: current `position`
56
+ * ascending (empty/invalid last); ties — the duplicated positions an older
57
+ * client could leave — go oldest first (`created_at`, then `id`), so a
58
+ * product's original photo stays ahead of the ones uploaded later.
59
+ * `updates` holds only the rows whose stored position differs.
60
+ */
61
+ export declare function contiguousPositionUpdates(rows: Record<string, any>[], positionKey?: string): {
62
+ ordered: Record<string, any>[];
63
+ updates: Array<{
64
+ id: string | number;
65
+ position: number;
66
+ }>;
67
+ };
3
68
  export declare function objectLabel(value: unknown): string | undefined;
4
69
  export declare function formatRelationCell(row: Record<string, unknown>, col: ColumnDefinition): string;
5
70
  export interface PivotRowLike {
@@ -1 +1 @@
1
- {"version":3,"file":"dynamic-relation-helpers.d.ts","sourceRoot":"","sources":["../src/dynamic-relation-helpers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dynamic-relation-helpers.d.ts","sourceRoot":"","sources":["../src/dynamic-relation-helpers.ts"],"names":[],"mappings":"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"}