runeforge 0.0.51 → 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';
@@ -139,10 +140,18 @@
 		activeBulkAction = { action, items };
 	}
 
+	let duplicateSeed = $state<Record<string, unknown> | undefined>(undefined);
+
 	async function navList() {
+		duplicateSeed = undefined;
 		await goto(lastListState.search || '?');
 	}
 	async function navCreate() {
+		duplicateSeed = undefined;
+		await goto('?view=create');
+	}
+	async function navDuplicate(record: Record<string, unknown>) {
+		duplicateSeed = record;
 		await goto('?view=create');
 	}
 	async function navRead(item: T) {
@@ -190,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) =>
@@ -204,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,
@@ -337,6 +350,7 @@
 		fields={resolvedFields}
 		{creation}
 		{serverError}
+		seed={duplicateSeed}
 		onCancel={navList}
 		onSuccess={navList}
 	/>
@@ -364,6 +378,7 @@
 		onCancel={navList}
 		onSuccess={navList}
 		onContinue={navContinueEdit}
+		onDuplicate={navDuplicate}
 	/>
 {:else}
 	<List

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

@@ -1,5 +1,7 @@
 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

@@ -26,6 +26,33 @@ export function seedField(f, raw) {
 export function emptyRecord(fields) {
     return Object.fromEntries(fields.map((f) => [f.attribute, seedField(f, f.default)]));
 }
+// Shared by Update.svelte (loading the instance being edited) and Create.svelte
+// (pre-filling a new record from a duplicated instance): builds a draft record
+// from an arbitrary source object, running each field's `seed` resolver
+// (falling back to the source's raw value) through the same seedField
+// normalization as emptyRecord.
+export function seedRecord(fields, source) {
+    const seeded = { ...source };
+    for (const f of fields) {
+        const raw = f.seed ? f.seed(source) : source[f.attribute];
+        seeded[f.attribute] = seedField(f, raw);
+    }
+    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 } 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';
 
@@ -21,6 +21,7 @@
     fields = [] as FieldDefinition<T>[],
     creation = {} as ActionConfiguration<T>,
     serverError = '',
+    seed = undefined as Record<string, unknown> | undefined,
     onCancel,
     onSuccess,
   }: {
@@ -31,6 +32,9 @@
     fields?: FieldDefinition<T>[];
     creation?: ActionConfiguration<T>;
     serverError?: string;
+    /** Pre-fills the form from another instance's values — used when the
+     * create view is reached via an Update form's "Duplicate" button. */
+    seed?: Record<string, unknown>;
     onCancel?: () => void;
     onSuccess?: () => void;
   } = $props();
@@ -51,7 +55,9 @@
     successTimeout = setTimeout(() => (successMessage = ''), 4000);
   }
 
-  let record = $state<Record<string, unknown>>(untrack(() => emptyRecord(fields)));
+  let record = $state<Record<string, unknown>>(
+    untrack(() => (seed ? seedRecord(fields, seed) : emptyRecord(fields)))
+  );
 
   const groups = $derived(groupFields(fields));
   const hasFileField = $derived(fields.some((f) => f.type === 'file'));
@@ -130,6 +136,7 @@
             fieldErrors = {};
             internalError = '';
             flashSuccess();
+            record = applyDuplicateOmit(fields, record, creation.duplication?.omit);
           } else {
             onSuccess?.();
           }

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

@@ -7,6 +7,9 @@ declare function $$render<T extends object = Record<string, unknown>>(): {
         fields?: FieldDefinition<T>[];
         creation?: ActionConfiguration<T>;
         serverError?: string;
+        /** Pre-fills the form from another instance's values — used when the
+         * create view is reached via an Update form's "Duplicate" button. */
+        seed?: Record<string, unknown>;
         onCancel?: () => void;
         onSuccess?: () => void;
     };

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 { seedField } 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';
 
@@ -26,6 +26,7 @@
     onCancel,
     onSuccess,
     onContinue,
+    onDuplicate,
   }: {
     labelOne?: string;
     labelMany?: string;
@@ -39,6 +40,7 @@
     onCancel?: () => void;
     onSuccess?: () => void;
     onContinue?: () => void;
+    onDuplicate?: (record: Record<string, unknown>) => void;
   } = $props();
 
   const icons = $derived(getIconSet() ?? defaultIconSet);
@@ -47,24 +49,16 @@
   let fieldErrors = $state<Record<string, string>>({});
   let internalError = $state('');
   let continuing = $state(false);
-
-  function seedFromInstance(inst: Record<string, unknown>): Record<string, unknown> {
-    const seeded: Record<string, unknown> = { ...inst };
-    for (const f of fields) {
-      const raw = f.seed ? f.seed(inst) : inst[f.attribute];
-      seeded[f.attribute] = seedField(f, raw);
-    }
-    return seeded;
-  }
+  let duplicating = $state(false);
 
   let record = $state<Record<string, unknown>>(
-    untrack(() => seedFromInstance(instance as Record<string, unknown>))
+    untrack(() => seedRecord(fields, instance as Record<string, unknown>))
   );
 
   $effect(() => {
     const id = (instance as Record<string, unknown>)[idKey];
     if (!id) return;
-    untrack(() => { record = seedFromInstance(instance as Record<string, unknown>); });
+    untrack(() => { record = seedRecord(fields, instance as Record<string, unknown>); });
   });
 
   const groups = $derived(groupFields(fields));
@@ -74,6 +68,10 @@
   const continueLabel = $derived(update.continue?.label ?? strings.saveAndContinue);
   const continueClass = $derived(update.continue?.class ?? '');
 
+  const duplicationEnabled = $derived(update.duplication?.enabled ?? false);
+  const duplicationLabel = $derived(update.duplication?.label ?? strings.duplicate);
+  const duplicationClass = $derived(update.duplication?.class ?? '');
+
   const errorEntries = $derived([
     ...((serverError || internalError) ? [['_global', internalError || serverError] as [string, string]] : []),
     ...Object.entries(fieldErrors),
@@ -123,6 +121,9 @@
           if (continuing) {
             continuing = false;
             onContinue?.();
+          } else if (duplicating) {
+            duplicating = false;
+            onDuplicate?.(applyDuplicateOmit(fields, record, update.duplication?.omit));
           } else {
             onSuccess?.();
           }
@@ -173,17 +174,27 @@
       <Button variant="ghost" onclick={() => onCancel?.()}>
         {strings.cancel}
       </Button>
+      {#if duplicationEnabled}
+        <Button
+          type="submit"
+          variant="warning"
+          class={duplicationClass}
+          onclick={() => { continuing = false; duplicating = true; }}
+        >
+          {duplicationLabel}
+        </Button>
+      {/if}
       {#if continueEnabled}
         <Button
           type="submit"
           variant="secondary"
           class={continueClass}
-          onclick={() => { continuing = true; }}
+          onclick={() => { continuing = true; duplicating = false; }}
         >
           {continueLabel}
         </Button>
       {/if}
-      <Button type="submit" variant="primary" onclick={() => { continuing = false; }}>
+      <Button type="submit" variant="primary" onclick={() => { continuing = false; duplicating = false; }}>
         {strings.save}
       </Button>
     </div>

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

@@ -12,6 +12,7 @@ declare function $$render<T extends object = Record<string, unknown>>(): {
         onCancel?: () => void;
         onSuccess?: () => void;
         onContinue?: () => void;
+        onDuplicate?: (record: Record<string, unknown>) => void;
     };
     exports: {};
     bindings: "";

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;
@@ -81,12 +89,16 @@ export interface ActionConfiguration<T extends object = Record<string, unknown>>
      *   Falls back to reloading the current instance when there is no next
      *   one. Disabled by default — pass `{ enabled: true }` to show it. */
     continue?: CreateFormButtonConfiguration;
-    /** Create form only: shows a "Duplicate" button alongside Save/Cancel that
-     * submits to the same `endpoint`, but — unlike "Save and continue", which
-     * blanks the form — leaves the just-submitted values in place so the user
-     * can tweak a few fields and save again as a new record. Disabled by
-     * default — pass `{ enabled: true }` to show it. */
-    duplication?: CreateFormButtonConfiguration;
+    /** Shows a "Duplicate" button alongside Save/Cancel.
+     * - Create form: submits to the same `endpoint`, but — unlike "Save and
+     *   continue", which blanks the form — leaves the just-submitted values in
+     *   place so the user can tweak a few fields and save again as a new
+     *   record.
+     * - Update form: submits the edit to the same `endpoint`, then opens the
+     *   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?: DuplicationButtonConfiguration;
 }
 export interface CustomAction<T extends object = Record<string, unknown>> {
     label: string;

package/package.json

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