runeforge 0.0.52 → 0.0.53

package/dist/components/crud/GenericCRUD.svelte

@@ -8,6 +8,7 @@
 	import { AUTO_EXCLUDED } from './utils/constants.js';
 	import {
 		resolveFormatter,
+		truncateFormatter,
 		inferType,
 		buildFieldDefinitions
 	} from './utils/resolution.js';
@@ -198,7 +199,7 @@
 							// embedded column without an explicit formatter falls back to
 							// joining each item's label (itemLabel, or the same
 							// sub-field-joining summary the embedded form list uses).
-							const formatter =
+							const resolvedFormatter =
 								resolveFormatter(m, data) ??
 								(embeddedFields
 									? (value: unknown) =>
@@ -212,6 +213,10 @@
 														.join(', ')
 												: ''
 									: undefined);
+							const formatter =
+								m.truncateUpTo != null
+									? truncateFormatter(resolvedFormatter, m.truncateUpTo)
+									: resolvedFormatter;
 							return {
 								attribute: k as keyof T & string,
 								title: m.label ?? k,

package/dist/components/crud/utils/embedded.d.ts

@@ -2,5 +2,6 @@ import type { FieldDefinition } from '../../../types/crud.js';
 export declare function seedField<T extends object = Record<string, unknown>>(f: FieldDefinition<T>, raw: unknown): unknown;
 export declare function emptyRecord<T extends object = Record<string, unknown>>(fields: FieldDefinition<T>[]): Record<string, unknown>;
 export declare function seedRecord<T extends object = Record<string, unknown>>(fields: FieldDefinition<T>[], source: Record<string, unknown>): Record<string, unknown>;
+export declare function applyDuplicateOmit<T extends object = Record<string, unknown>>(fields: FieldDefinition<T>[], record: Record<string, unknown>, omit?: string[]): Record<string, unknown>;
 export declare function formatEmbeddedFieldValue<T extends object = Record<string, unknown>>(f: FieldDefinition<T>, raw: unknown): string;
 export declare function defaultItemLabel<T extends object = Record<string, unknown>>(fields: FieldDefinition<T>[], item: Record<string, unknown>): string;

package/dist/components/crud/utils/embedded.js

@@ -39,6 +39,20 @@ export function seedRecord(fields, source) {
     }
     return seeded;
 }
+// Shared by Update.svelte and Create.svelte's "Duplicate" handling: returns a
+// copy of the just-saved record with `omit`-listed attributes reset to their
+// field default, so the new draft doesn't inherit values that only made sense
+// for the original instance (e.g. a publication date).
+export function applyDuplicateOmit(fields, record, omit = []) {
+    if (!omit.length)
+        return record;
+    const result = { ...record };
+    for (const f of fields) {
+        if (omit.includes(f.attribute))
+            result[f.attribute] = seedField(f, f.default);
+    }
+    return result;
+}
 // Shared by defaultItemLabel and the CSV/XLSX export column expansion: renders
 // one sub-field's raw stored value as display text, resolving a select's
 // option label instead of its stored value. Booleans are left to the caller

package/dist/components/crud/utils/formatters.d.ts

@@ -1,4 +1,3 @@
 export declare const formatBoolean: (trueLabel?: string, falseLabel?: string) => () => (value: boolean) => string;
 export declare const formatDatetime: (format?: string, timeZone?: string) => (() => (value: Date) => string);
-export declare function formatTruncateTextUpTo(maxLength: number): () => (value: string) => string;
 export declare function formatInstance<T extends Record<string, unknown>>(attribute: keyof T & string, instances: T[], urlPath: string, idKey?: keyof T & string): (value: unknown) => string;

package/dist/components/crud/utils/formatters.js

@@ -52,12 +52,6 @@ export const formatDatetime = (format = 'dd/mm/YYYY HH:MM', timeZone) => {
     };
     return () => fmt;
 };
-export function formatTruncateTextUpTo(maxLength) {
-    return () => (value) => {
-        const str = String(value ?? '');
-        return str.length > maxLength ? str.slice(0, maxLength) + '…' : str;
-    };
-}
 function escapeHtml(str) {
     return str
         .replace(/&/g, '&')

package/dist/components/crud/utils/resolution.d.ts

@@ -3,5 +3,6 @@ import type { FieldDefinition } from '../../../types/crud.js';
 export declare function resolveOptions(m: AttributeMetadata, d: unknown): SelectOption[] | undefined;
 export declare function resolveDefault(m: AttributeMetadata, d: unknown): unknown;
 export declare function resolveFormatter(m: AttributeMetadata, d: unknown): import("../../../index.ts").CellFormatter<any, any> | undefined;
+export declare function truncateFormatter<T extends object = Record<string, unknown>, V = unknown>(formatter: ((value: V, row: T) => string) | undefined, maxLength: number): (value: V, row: T) => string;
 export declare function inferType(key: string, value: unknown): AttributeType;
 export declare function buildFieldDefinitions<T extends object = Record<string, unknown>>(meta: Partial<Record<string, AttributeMetadata>>, data: unknown, excludedFlag: 'excludedFromCreate' | 'excludedFromRead' | 'excludedFromUpdate' | 'excludedFromList', excluded: Set<string>): FieldDefinition<T>[];

package/dist/components/crud/utils/resolution.js

@@ -9,6 +9,17 @@ export function resolveDefault(m, d) {
 export function resolveFormatter(m, d) {
     return m.formatter?.(d);
 }
+// List column only (GenericCRUD's resolvedColumns): wraps `formatter` (or,
+// absent one, the same raw String(value) TableBody falls back to) so a column
+// that needs to stay narrow can truncate its cell without that truncation
+// leaking into the Read view or the Create/Update forms, which call
+// `formatter` directly and never go through this wrapper.
+export function truncateFormatter(formatter, maxLength) {
+    return (value, row) => {
+        const str = formatter ? formatter(value, row) : String(value ?? '');
+        return str.length > maxLength ? str.slice(0, maxLength) + '…' : str;
+    };
+}
 export function inferType(key, value) {
     if (typeof value === 'boolean')
         return 'boolean';

package/dist/components/crud/views/Create.svelte

@@ -8,7 +8,7 @@
   import { defaultIconSet } from '../../../icons/sets/default.js';
   import { validateAll } from '../utils/validation.js';
   import { groupFields } from '../utils/grouping.js';
-  import { emptyRecord, seedRecord } from '../utils/embedded.js';
+  import { applyDuplicateOmit, emptyRecord, seedRecord } from '../utils/embedded.js';
   import type { ActionConfiguration, FieldDefinition } from '../../../types/crud.js';
   import { getStrings } from '../../../i18n/context.js';
 
@@ -136,6 +136,7 @@
             fieldErrors = {};
             internalError = '';
             flashSuccess();
+            record = applyDuplicateOmit(fields, record, creation.duplication?.omit);
           } else {
             onSuccess?.();
           }

package/dist/components/crud/views/Update.svelte

@@ -8,7 +8,7 @@
   import { defaultIconSet } from '../../../icons/sets/default.js';
   import { validateAll } from '../utils/validation.js';
   import { groupFields } from '../utils/grouping.js';
-  import { seedRecord } from '../utils/embedded.js';
+  import { applyDuplicateOmit, seedRecord } from '../utils/embedded.js';
   import type { ActionConfiguration, FieldDefinition } from '../../../types/crud.js';
   import { getStrings } from '../../../i18n/context.js';
 
@@ -123,7 +123,7 @@
             onContinue?.();
           } else if (duplicating) {
             duplicating = false;
-            onDuplicate?.(record);
+            onDuplicate?.(applyDuplicateOmit(fields, record, update.duplication?.omit));
           } else {
             onSuccess?.();
           }

package/dist/index.d.ts

@@ -44,9 +44,9 @@ export { default as CRUDRead } from './components/crud/views/Read.svelte';
 export { default as CRUDUpdate } from './components/crud/views/Update.svelte';
 export { default as SearchInput } from './components/crud/SearchInput.svelte';
 export { AUTO_EXCLUDED } from './components/crud/utils/constants.js';
-export { resolveOptions, resolveFormatter, inferType, buildFieldDefinitions } from './components/crud/utils/resolution.js';
+export { resolveOptions, resolveFormatter, truncateFormatter, inferType, buildFieldDefinitions } from './components/crud/utils/resolution.js';
 export { fieldLabel, initials } from './components/crud/utils/misc.js';
-export { formatBoolean, formatDatetime, formatTruncateTextUpTo, formatInstance } from './components/crud/utils/formatters.js';
+export { formatBoolean, formatDatetime, formatInstance } from './components/crud/utils/formatters.js';
 export { groupFields } from './components/crud/utils/grouping.js';
 export type { FieldGroup } from './components/crud/utils/grouping.js';
 export { validateAll } from './components/crud/utils/validation.js';

package/dist/index.js

@@ -42,9 +42,9 @@ export { default as CRUDUpdate } from './components/crud/views/Update.svelte';
 export { default as SearchInput } from './components/crud/SearchInput.svelte';
 // CRUD utilities
 export { AUTO_EXCLUDED } from './components/crud/utils/constants.js';
-export { resolveOptions, resolveFormatter, inferType, buildFieldDefinitions } from './components/crud/utils/resolution.js';
+export { resolveOptions, resolveFormatter, truncateFormatter, inferType, buildFieldDefinitions } from './components/crud/utils/resolution.js';
 export { fieldLabel, initials } from './components/crud/utils/misc.js';
-export { formatBoolean, formatDatetime, formatTruncateTextUpTo, formatInstance } from './components/crud/utils/formatters.js';
+export { formatBoolean, formatDatetime, formatInstance } from './components/crud/utils/formatters.js';
 export { groupFields } from './components/crud/utils/grouping.js';
 export { validateAll } from './components/crud/utils/validation.js';
 export { emptyRecord, defaultItemLabel } from './components/crud/utils/embedded.js';

package/dist/types/attribute.d.ts

@@ -51,7 +51,15 @@ export type AttributeMetadata = {
     hidden?: boolean | HiddenResolver;
     seed?: SeedResolver;
     component?: CellComponent<any, any>;
+    /** Formats the raw value everywhere it's displayed read-only: the list
+     * column's cell, the Read view's field, and any other readonly Field. */
     formatter?: FormatterResolver;
+    /** List column only: truncates the cell's text to this many characters,
+     * appending an ellipsis, applied to `formatter`'s output (or, absent one,
+     * the raw stringified value) — the Read view and Create/Update forms
+     * always show the untruncated value. Handy for a long free-text column
+     * that would otherwise blow out the table's width. */
+    truncateUpTo?: number;
     /** Pass a function to require a field only in certain conditions, e.g. a
      * quantity that only applies to some of a select's options. */
     required?: boolean | RequiredResolver;

package/dist/types/crud.d.ts

@@ -65,6 +65,14 @@ export interface CreateFormButtonConfiguration {
     label?: string;
     class?: string;
 }
+/** The "Duplicate" button's configuration — a `CreateFormButtonConfiguration`
+ * plus which attributes to leave out of the duplicated draft. */
+export interface DuplicationButtonConfiguration extends CreateFormButtonConfiguration {
+    /** Attribute names reset to the field's `default` instead of copying the
+     * source instance's value — e.g. a publication date that should depend on
+     * when the copy is itself published, not on when the original was. */
+    omit?: string[];
+}
 export interface ActionConfiguration<T extends object = Record<string, unknown>> {
     enabled?: boolean;
     label?: string;
@@ -90,7 +98,7 @@ export interface ActionConfiguration<T extends object = Record<string, unknown>>
      *   create form pre-filled with the just-saved instance's values, so a new
      *   record can be started from it without retyping everything.
      * Disabled by default — pass `{ enabled: true }` to show it. */
-    duplication?: CreateFormButtonConfiguration;
+    duplication?: DuplicationButtonConfiguration;
 }
 export interface CustomAction<T extends object = Record<string, unknown>> {
     label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runeforge",
-  "version": "0.0.52",
+  "version": "0.0.53",
   "description": "SvelteKit toolkit for building metadata-driven CRUD interfaces with tables, forms, and actions",
   "license": "MIT",
   "author": "Ezequiel Puerta",