runeforge 0.0.57 → 0.0.59

package/dist/components/crud/views/list/Toolbar.svelte

@@ -6,12 +6,11 @@
 	import { defaultIconSet } from '../../../../icons/sets/default.js';
 	import type {
 		ActionConfiguration,
-		ColumnDefinition,
 		CustomBulkAction,
-		ExportConfiguration,
-		SearchConfiguration,
 		ViewBasedCustomBulkAction
-	} from '../../../../types/crud.js';
+	} from '../../../../types/crud/actions.js';
+	import type { ColumnDefinition } from '../../../../types/crud/columns.js';
+	import type { ExportConfiguration, SearchConfiguration } from '../../../../types/crud/list-config.js';
 	import type { ServerPagination, TableQuery } from '../../../../types/table.js';
 	import { getStrings } from '../../../../i18n/context.js';
 	import SearchInput from '../../SearchInput.svelte';

package/dist/components/crud/views/list/Toolbar.svelte.d.ts

@@ -1,4 +1,6 @@
-import type { ActionConfiguration, ColumnDefinition, CustomBulkAction, ExportConfiguration, SearchConfiguration } from '../../../../types/crud.js';
+import type { ActionConfiguration, CustomBulkAction } from '../../../../types/crud/actions.js';
+import type { ColumnDefinition } from '../../../../types/crud/columns.js';
+import type { ExportConfiguration, SearchConfiguration } from '../../../../types/crud/list-config.js';
 import type { ServerPagination, TableQuery } from '../../../../types/table.js';
 declare function $$render<T extends object = Record<string, unknown>>(): {
     props: {

package/dist/components/table/ColumnFilter.svelte

@@ -13,7 +13,7 @@
 	});
 	import type { DistinctEntry } from '../../types/table.js';
 	import type { FilterState } from './state.svelte.js';
-	import type { ColumnDefinition } from '../../types/crud.js';
+	import type { ColumnDefinition } from '../../types/crud/columns.js';
 
 	let {
 		column,

package/dist/components/table/ColumnFilter.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { DistinctEntry } from '../../types/table.js';
 import type { FilterState } from './state.svelte.js';
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 declare function $$render<T extends object>(): {
     props: {
         column: ColumnDefinition<T>;

package/dist/components/table/PaginatedTable.svelte

@@ -17,7 +17,7 @@
 		TableQuery
 	} from '../../types/table.js';
 	import { tick, type Snippet } from 'svelte';
-	import type { ColumnDefinition } from '../../types/crud.js';
+	import type { ColumnDefinition } from '../../types/crud/columns.js';
 	import { getStrings } from '../../i18n/context.js';
 
 	const strings = getStrings();

package/dist/components/table/PaginatedTable.svelte.d.ts

@@ -1,7 +1,7 @@
 import { SvelteSet } from 'svelte/reactivity';
 import type { FilterSnapshot, ReorderOptions, ServerPagination, SortDirection, TableQuery } from '../../types/table.js';
 import { type Snippet } from 'svelte';
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 declare function $$render<T extends object = Record<string, unknown>>(): {
     props: {
         data?: T[];

package/dist/components/table/TableBody.svelte

@@ -1,7 +1,7 @@
 <script lang="ts" generics="T extends object">
   import type { Snippet } from 'svelte';
   import type { SvelteSet } from 'svelte/reactivity';
-  import type { ColumnDefinition } from '../../types/crud.js';
+  import type { ColumnDefinition } from '../../types/crud/columns.js';
   import type { IndexedRow, ReorderOptions } from '../../types/table.js';
   import { sortableRows, type SortEndIndices } from './sortable.js';
   import { moveIndexedRows } from './utils.js';

package/dist/components/table/TableBody.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { Snippet } from 'svelte';
 import type { SvelteSet } from 'svelte/reactivity';
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 import type { IndexedRow, ReorderOptions } from '../../types/table.js';
 declare function $$render<T extends object>(): {
     props: {

package/dist/components/table/TableHeader.svelte

@@ -3,7 +3,7 @@
   import ColumnFilter from './ColumnFilter.svelte';
   import { isSortable, isFilterable } from './utils.js';
   import type { DistinctEntry } from '../../types/table.js';
-  import type { ColumnDefinition } from '../../types/crud.js';
+  import type { ColumnDefinition } from '../../types/crud/columns.js';
   import type { SortState, FilterState } from './state.svelte.js';
   import { getStrings } from '../../i18n/context.js';
 

package/dist/components/table/TableHeader.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { DistinctEntry } from '../../types/table.js';
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 import type { SortState, FilterState } from './state.svelte.js';
 declare function $$render<T extends object>(): {
     props: {

package/dist/components/table/export.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 /**
  * Minimal duck-typed subset of the SheetJS (`xlsx`) module API used for
  * building a workbook. Runeforge never imports `xlsx` itself — the consumer

package/dist/components/table/state.svelte.d.ts

@@ -1,5 +1,5 @@
 import { SvelteMap, SvelteSet } from 'svelte/reactivity';
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 import type { FilterSnapshot, IndexedRow, SortDirection } from '../../types/table.js';
 export declare class SortState {
     column: string | null;

package/dist/components/table/utils.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnDefinition } from '../../types/crud.js';
+import type { ColumnDefinition } from '../../types/crud/columns.js';
 import type { DistinctEntry, IndexedRow } from '../../types/table.js';
 export declare function cellRenderedText<T extends object>(row: T, col: ColumnDefinition<T>): string;
 export declare function isSortable<T extends object>(col: ColumnDefinition<T>): boolean;

package/dist/index.d.ts

@@ -2,7 +2,11 @@ export type { BreadcrumbItem } from './types/breadcrumb.js';
 export { AttributeType } from './types/attribute.js';
 export type { AttributeMetadata, InterfaceMetadata, SelectOption, OptionsResolver, FormatterResolver, EmbeddedItemLabelResolver } from './types/attribute.js';
 export type { CellProps, CellComponent, CellFormatter, SortDirection, IndexedRow, DistinctEntry, PaginatedEnvelope, ServerPagination, FilterSnapshot, TableQuery, ReorderOptions } from './types/table.js';
-export type { ColumnDefinition, FieldDefinition, ActionConfiguration, CustomAction, BaseCustomBulkAction, ViewBasedCustomBulkAction, EndpointBasedCustomBulkAction, CustomBulkAction, RowAction, SearchConfiguration, ExportConfiguration, ReorderConfiguration, ListActions, ListConfig } from './types/crud.js';
+export type { ColumnDefinition } from './types/crud/columns.js';
+export type { FieldDefinition } from './types/crud/fields.js';
+export type { ActionConfiguration, CustomAction, BaseCustomBulkAction, ViewBasedCustomBulkAction, EndpointBasedCustomBulkAction, CustomBulkAction, RowAction, ListActions } from './types/crud/actions.js';
+export type { SearchConfiguration, ExportConfiguration, ListConfig } from './types/crud/list-config.js';
+export type { ReorderConfiguration } from './types/crud/reorder.js';
 export type { RuneforgeConfig } from './config/context.js';
 export { setConfig, getConfig } from './config/context.js';
 export type { CRUDIconSet, IconComponent } from './icons/types.js';

package/dist/types/attribute.d.ts

@@ -25,15 +25,46 @@ export type SelectOption = {
 };
 export type OptionsResolver = SelectOption[] | ((data: any) => SelectOption[]);
 export type FormatterResolver = (data?: any) => CellFormatter<any, any>;
-export type DependentOptionsResolver = (data: any, record: Record<string, unknown>) => SelectOption[];
+/** `parent` is only ever populated for a sub-field nested inside an
+ * `embedded` field — the outer form's own record, distinct from `record`
+ * (the embedded item's own draft). Undefined for a top-level field. */
+export type DependentOptionsResolver = (data: any, record: Record<string, unknown>, parent?: Record<string, unknown>) => SelectOption[];
 export type SearchResolver = (query: string) => Promise<SelectOption[]>;
-export type DisabledResolver = (record: Record<string, unknown>) => boolean;
-export type HiddenResolver = (record: Record<string, unknown>) => boolean;
-export type RequiredResolver = (record: Record<string, unknown>) => boolean;
+/** See `DependentOptionsResolver` re: `parent`. */
+export type DisabledResolver = (record: Record<string, unknown>, parent?: Record<string, unknown>) => boolean;
+/** See `DependentOptionsResolver` re: `parent`. */
+export type HiddenResolver = (record: Record<string, unknown>, parent?: Record<string, unknown>) => boolean;
+/** See `DependentOptionsResolver` re: `parent`. */
+export type RequiredResolver = (record: Record<string, unknown>, parent?: Record<string, unknown>) => boolean;
+/** Embedded fields only: called once right after the parent record's
+ * `dependsOn` attribute changes value (not on every parent mutation) —
+ * receives the embedded list's current items and the parent record, and
+ * returns the list that should replace it. Return the same array reference
+ * unchanged when nothing needs to happen; a new array (e.g. `items.filter(…)`)
+ * prunes/adjusts now-invalid items instead of leaving them silently stale. */
+export type EmbeddedRevalidateResolver = (items: Record<string, unknown>[], parent: Record<string, unknown>) => Record<string, unknown>[];
 export type SeedResolver = (instance: any) => unknown;
 /** Embedded fields only: renders a short summary for one item in the list.
  * Falls back to a dash-joined summary of the item's sub-field values. */
 export type EmbeddedItemLabelResolver = (item: Record<string, unknown>) => string;
+export type ValidateResolver = (value: unknown, record: Record<string, unknown>) => string | undefined;
+/** Sets a field's value from within a `FieldButtonAction.run` callback —
+ * usually the same field the button sits next to, but any sibling attribute
+ * works too. */
+export type FieldSetter = (attribute: string, value: unknown) => void;
+/** A button rendered next to a field's label that runs entirely client-side
+ * — no submit, no request — instead of persisting a model attribute of its
+ * own. See `AttributeMetadata.actions`. */
+export type FieldButtonAction = {
+    label: string;
+    icon?: any;
+    class?: string;
+    /** Hide the button in certain conditions. Re-evaluated live, same as `disabled`. */
+    condition?: (record: Record<string, unknown>) => boolean;
+    /** Receives the field's current value, the form's full draft record, and a
+     * setter to write back into this field (or a sibling one). */
+    run: (value: unknown, record: Record<string, unknown>, setField: FieldSetter) => void;
+};
 export type AttributeMetadata = {
     label?: string;
     type?: AttributeType;
@@ -91,16 +122,37 @@ export type AttributeMetadata = {
     minLength?: number;
     maxLength?: number;
     pattern?: string;
+    /** Custom validation, run after this field's built-in rules
+     * (required/min/max/minLength/maxLength/pattern) pass, and only when none
+     * of them already failed. Receives the field's submitted value and the
+     * full draft record (including sibling fields currently in the form), so
+     * the same hook covers a lone-field rule and a cross-field rule alike —
+     * e.g. an `extension_date` that must be later than the record's
+     * `submission_date`. Return an error message, or `undefined` when the
+     * value is valid. */
+    validate?: ValidateResolver;
     /** Textarea fields only: the HTML `rows` attribute, controlling height. */
     rows?: number;
     /** Embedded fields only: schema for each item added through the "+" modal. */
     fields?: InterfaceMetadata<any>;
     /** Embedded fields only: short label for an item in the list. */
     itemLabel?: EmbeddedItemLabelResolver;
+    /** Embedded fields only: re-derives the embedded list whenever the parent
+     * record's `dependsOn` attribute changes — see `EmbeddedRevalidateResolver`.
+     * Requires `dependsOn`; ignored without it. */
+    revalidate?: EmbeddedRevalidateResolver;
+    /** Embedded fields only: parent record attribute that `revalidate` reacts
+     * to. Only that one attribute is watched — changes to anything else in the
+     * parent record don't trigger `revalidate`. */
+    dependsOn?: string;
     /** Tree fields only: whether parent nodes start expanded. Defaults to `true`. */
     defaultExpanded?: boolean;
     /** Fields sharing the same `row` string render side by side on desktop and
      * stacked on mobile — see the Field rows section. Only merges fields that
      * are also in the same `groupedAs` bucket (or both ungrouped). */
     row?: string;
+    /** Extra buttons rendered next to this field's label — e.g. a "Capitalize"
+     * button that transforms the field's own value client-side. See "Field
+     * actions" in the README. */
+    actions?: FieldButtonAction[];
 };

package/dist/types/{crud.d.ts → crud/actions.d.ts}

@@ -1,63 +1,4 @@
 import type { Component } from 'svelte';
-import type { FullAutoFill } from 'svelte/elements';
-import type { AttributeType, SearchResolver, RequiredResolver, SelectOption } from './attribute.js';
-import type { CellComponent, CellFormatter, SortableModule, TableQuery } from './table.js';
-import type { XlsxModule } from '../components/table/export.js';
-export type ColumnDefinition<T extends object = Record<string, unknown>> = {
-    [K in keyof T & string]: {
-        attribute: K;
-        title?: string;
-        type?: AttributeType;
-        component?: CellComponent<T, T[K]>;
-        formatter?: CellFormatter<T, T[K]>;
-        sortable?: boolean;
-        filterable?: boolean;
-        /** Static, exhaustive filter choices — see `AttributeMetadata.filterOptions`. */
-        filterOptions?: SelectOption[];
-        /** Embedded columns only: sub-field definitions for each item, used to
-         * render a default cell summary and to expand the column into one
-         * sub-column per field on CSV/XLSX export. */
-        fields?: FieldDefinition<Record<string, unknown>>[];
-        /** Embedded columns only: short label for an item, reused from the form
-         * field's `itemLabel` for the default cell summary. */
-        itemLabel?: (item: Record<string, unknown>) => string;
-    };
-}[keyof T & string];
-export interface FieldDefinition<T extends object = Record<string, unknown>> {
-    attribute: keyof T & string;
-    title?: string;
-    type?: AttributeType;
-    required?: boolean | RequiredResolver;
-    autocomplete?: FullAutoFill;
-    placeholder?: string;
-    default?: any;
-    options?: SelectOption[];
-    dependentOptions?: (record: Record<string, unknown>) => SelectOption[];
-    search?: SearchResolver;
-    disabled?: (record: Record<string, unknown>) => boolean;
-    hidden?: boolean | ((record: Record<string, unknown>) => boolean);
-    seed?: (instance: any) => unknown;
-    /** Read-only rendering only (the Read view, and any other readonly Field) */
-    formatter?: (value: unknown, record: Record<string, unknown>) => string;
-    groupedAs?: string;
-    min?: number;
-    max?: number;
-    integer?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    /** Textarea fields only: the HTML `rows` attribute, controlling height. */
-    rows?: number;
-    /** Embedded fields only: sub-field definitions for each item, built from
-     * the metadata's `fields`. */
-    fields?: FieldDefinition<Record<string, unknown>>[];
-    /** Embedded fields only: short label for an item in the list. */
-    itemLabel?: (item: Record<string, unknown>) => string;
-    /** Tree fields only: whether parent nodes start expanded. Defaults to `true`. */
-    defaultExpanded?: boolean;
-    /** Fields sharing the same `row` string render side by side. */
-    row?: string;
-}
 /** A create-form button whose visibility, label and styling can all be
  * overridden — `enabled` falls back to the button's own default (see
  * `continue`/`duplication` on `ActionConfiguration`), `label` falls back to
@@ -180,59 +121,6 @@ export interface EndpointBasedCustomBulkAction<T extends object = Record<string,
  * `'endpoint'` brings `endpoint`/`confirm` and forbids `view` — see
  * `ViewBasedCustomBulkAction` / `EndpointBasedCustomBulkAction`. */
 export type CustomBulkAction<T extends object = Record<string, unknown>> = ViewBasedCustomBulkAction<T> | EndpointBasedCustomBulkAction<T>;
-export interface SearchConfiguration {
-    param?: string;
-    placeholder?: string;
-    debounceMs?: number;
-}
-export interface ExportConfiguration<T extends object = Record<string, unknown>> {
-    callback?: (query: TableQuery) => Promise<T[]>;
-    xlsx?: XlsxModule;
-}
-/** Turns on drag-to-reorder rows in the list view — off by default, enabled
- * by providing this object (`enabled: false` keeps the configuration in
- * place but disables dragging, e.g. temporarily). Not supported alongside
- * [server-side pagination](#server-side-pagination-sorting--filtering): the
- * whole row set needs to be reachable client-side for indices to stay
- * meaningful, so `reorder` is ignored whenever a `PaginatedEnvelope` is used. */
-export interface ReorderConfiguration<T extends object = Record<string, unknown>> {
-    enabled?: boolean;
-    /** The attribute that stores each row's order index. Establishes the
-     * default ascending order (when `compare` is absent) and is written to
-     * its new sequential 0-based value on every row whose position changes
-     * after a drag. */
-    attribute: keyof T & string;
-    /** Resolved `sortablejs` default export, e.g. `import Sortable from
-     * 'sortablejs'`. Runeforge never bundles `sortablejs` itself — install it
-     * separately and pass it in, so the dependency stays fully optional. */
-    sortable: SortableModule;
-    /** Overrides the plain `attribute`-ascending order for composite orders
-     * — e.g. a row's true resting position depends first on a related
-     * record's own order, and only then on this row's `attribute`. Takes
-     * full ownership of row order while reorder is active (column-header
-     * sorting is unavailable, same as the plain `attribute` case). */
-    compare?: (a: T, b: T) => number;
-    /** POSTed once per drag that settles with at least one changed row — a
-     * single request, not one per row — then the list is refreshed. FormData
-     * field `changes` carries a JSON-encoded array of `{ id, value }` pairs,
-     * one per row whose `attribute` changed (`value` being its new
-     * sequential position). Provide this or `callback`. */
-    endpoint?: string;
-    /** Alternative to `endpoint`: receives the rows whose `attribute` value
-     * changed, already updated to their new index. */
-    callback?: (items: T[]) => void | Promise<void>;
-    /** Drag-handle icon shown at the start of each row. Falls back to the
-     * active icon set's `grip` icon. */
-    icon?: any;
-    /** Lets dragging one row of the current checkbox selection move the
-     * whole selection together, via SortableJS's `MultiDrag` plugin (must be
-     * mounted on the `sortable` module you pass in). Off by default. */
-    multiDrag?: boolean;
-    /** While dragging, hovering over the edge zone for this long flips a
-     * page instead of requiring one long drag across the whole list.
-     * Default `2000`. */
-    pageFlipThresholdMs?: number;
-}
 /** Groups the list view's row-level and selection-level custom actions —
  * `custom` replaces the old top-level `actions` prop, `bulk` replaces
  * `customBulkActions`. */
@@ -242,14 +130,3 @@ export interface ListActions<T extends object = Record<string, unknown>> {
     /** Extra actions on the current selection — see Custom bulk actions. */
     bulk?: CustomBulkAction<T>[];
 }
-/** Groups the list view's opt-in behaviors. Replaces the old top-level
- * `search`, `enableExport`/`onExport`/`xlsx` props. */
-export interface ListConfig<T extends object = Record<string, unknown>> {
-    /** Free-text search box — see Free-text search. */
-    search?: SearchConfiguration;
-    /** CSV/Excel export. Presence of this object enables the export button —
-     * even as an empty `{}` — replacing the old `enableExport` boolean. */
-    export?: ExportConfiguration<T>;
-    /** Drag-to-reorder rows — see Reordering rows. */
-    reorder?: ReorderConfiguration<T>;
-}

package/dist/types/crud/columns.d.ts

@@ -0,0 +1,23 @@
+import type { AttributeType, SelectOption } from '../attribute.js';
+import type { CellComponent, CellFormatter } from '../table.js';
+import type { FieldDefinition } from './fields.js';
+export type ColumnDefinition<T extends object = Record<string, unknown>> = {
+    [K in keyof T & string]: {
+        attribute: K;
+        title?: string;
+        type?: AttributeType;
+        component?: CellComponent<T, T[K]>;
+        formatter?: CellFormatter<T, T[K]>;
+        sortable?: boolean;
+        filterable?: boolean;
+        /** Static, exhaustive filter choices — see `AttributeMetadata.filterOptions`. */
+        filterOptions?: SelectOption[];
+        /** Embedded columns only: sub-field definitions for each item, used to
+         * render a default cell summary and to expand the column into one
+         * sub-column per field on CSV/XLSX export. */
+        fields?: FieldDefinition<Record<string, unknown>>[];
+        /** Embedded columns only: short label for an item, reused from the form
+         * field's `itemLabel` for the default cell summary. */
+        itemLabel?: (item: Record<string, unknown>) => string;
+    };
+}[keyof T & string];

package/dist/types/crud/columns.js

@@ -0,0 +1 @@
+export {};

package/dist/types/crud/fields.d.ts

@@ -0,0 +1,48 @@
+import type { FullAutoFill } from 'svelte/elements';
+import type { AttributeType, SearchResolver, RequiredResolver, DisabledResolver, HiddenResolver, EmbeddedRevalidateResolver, SelectOption, FieldButtonAction } from '../attribute.js';
+export interface FieldDefinition<T extends object = Record<string, unknown>> {
+    attribute: keyof T & string;
+    title?: string;
+    type?: AttributeType;
+    required?: boolean | RequiredResolver;
+    autocomplete?: FullAutoFill;
+    placeholder?: string;
+    default?: any;
+    options?: SelectOption[];
+    /** Resolved form of `AttributeMetadata.dependentOptions` — `data` is
+     * already baked in by `buildFieldDefinitions`, so only `record`/`parent`
+     * remain live parameters. */
+    dependentOptions?: (record: Record<string, unknown>, parent?: Record<string, unknown>) => SelectOption[];
+    search?: SearchResolver;
+    disabled?: DisabledResolver;
+    hidden?: boolean | HiddenResolver;
+    seed?: (instance: any) => unknown;
+    /** Read-only rendering only (the Read view, and any other readonly Field) */
+    formatter?: (value: unknown, record: Record<string, unknown>) => string;
+    groupedAs?: string;
+    min?: number;
+    max?: number;
+    integer?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    /** See `AttributeMetadata.validate`. */
+    validate?: (value: unknown, record: Record<string, unknown>) => string | undefined;
+    /** Textarea fields only: the HTML `rows` attribute, controlling height. */
+    rows?: number;
+    /** Embedded fields only: sub-field definitions for each item, built from
+     * the metadata's `fields`. */
+    fields?: FieldDefinition<Record<string, unknown>>[];
+    /** Embedded fields only: short label for an item in the list. */
+    itemLabel?: (item: Record<string, unknown>) => string;
+    /** Embedded fields only: see `AttributeMetadata.revalidate`. */
+    revalidate?: EmbeddedRevalidateResolver;
+    /** Embedded fields only: see `AttributeMetadata.dependsOn`. */
+    dependsOn?: string;
+    /** Tree fields only: whether parent nodes start expanded. Defaults to `true`. */
+    defaultExpanded?: boolean;
+    /** Fields sharing the same `row` string render side by side. */
+    row?: string;
+    /** See `AttributeMetadata.actions`. */
+    actions?: FieldButtonAction[];
+}

package/dist/types/crud/fields.js

@@ -0,0 +1 @@
+export {};

package/dist/types/crud/list-config.d.ts

@@ -0,0 +1,23 @@
+import type { TableQuery } from '../table.js';
+import type { XlsxModule } from '../../components/table/export.js';
+import type { ReorderConfiguration } from './reorder.js';
+export interface SearchConfiguration {
+    param?: string;
+    placeholder?: string;
+    debounceMs?: number;
+}
+export interface ExportConfiguration<T extends object = Record<string, unknown>> {
+    callback?: (query: TableQuery) => Promise<T[]>;
+    xlsx?: XlsxModule;
+}
+/** Groups the list view's opt-in behaviors. Replaces the old top-level
+ * `search`, `enableExport`/`onExport`/`xlsx` props. */
+export interface ListConfig<T extends object = Record<string, unknown>> {
+    /** Free-text search box — see Free-text search. */
+    search?: SearchConfiguration;
+    /** CSV/Excel export. Presence of this object enables the export button —
+     * even as an empty `{}` — replacing the old `enableExport` boolean. */
+    export?: ExportConfiguration<T>;
+    /** Drag-to-reorder rows — see Reordering rows. */
+    reorder?: ReorderConfiguration<T>;
+}

package/dist/types/crud/list-config.js

@@ -0,0 +1 @@
+export {};

package/dist/types/crud/reorder.d.ts

@@ -0,0 +1,45 @@
+import type { SortableModule } from '../table.js';
+/** Turns on drag-to-reorder rows in the list view — off by default, enabled
+ * by providing this object (`enabled: false` keeps the configuration in
+ * place but disables dragging, e.g. temporarily). Not supported alongside
+ * [server-side pagination](#server-side-pagination-sorting--filtering): the
+ * whole row set needs to be reachable client-side for indices to stay
+ * meaningful, so `reorder` is ignored whenever a `PaginatedEnvelope` is used. */
+export interface ReorderConfiguration<T extends object = Record<string, unknown>> {
+    enabled?: boolean;
+    /** The attribute that stores each row's order index. Establishes the
+     * default ascending order (when `compare` is absent) and is written to
+     * its new sequential 0-based value on every row whose position changes
+     * after a drag. */
+    attribute: keyof T & string;
+    /** Resolved `sortablejs` default export, e.g. `import Sortable from
+     * 'sortablejs'`. Runeforge never bundles `sortablejs` itself — install it
+     * separately and pass it in, so the dependency stays fully optional. */
+    sortable: SortableModule;
+    /** Overrides the plain `attribute`-ascending order for composite orders
+     * — e.g. a row's true resting position depends first on a related
+     * record's own order, and only then on this row's `attribute`. Takes
+     * full ownership of row order while reorder is active (column-header
+     * sorting is unavailable, same as the plain `attribute` case). */
+    compare?: (a: T, b: T) => number;
+    /** POSTed once per drag that settles with at least one changed row — a
+     * single request, not one per row — then the list is refreshed. FormData
+     * field `changes` carries a JSON-encoded array of `{ id, value }` pairs,
+     * one per row whose `attribute` changed (`value` being its new
+     * sequential position). Provide this or `callback`. */
+    endpoint?: string;
+    /** Alternative to `endpoint`: receives the rows whose `attribute` value
+     * changed, already updated to their new index. */
+    callback?: (items: T[]) => void | Promise<void>;
+    /** Drag-handle icon shown at the start of each row. Falls back to the
+     * active icon set's `grip` icon. */
+    icon?: any;
+    /** Lets dragging one row of the current checkbox selection move the
+     * whole selection together, via SortableJS's `MultiDrag` plugin (must be
+     * mounted on the `sortable` module you pass in). Off by default. */
+    multiDrag?: boolean;
+    /** While dragging, hovering over the edge zone for this long flips a
+     * page instead of requiring one long drag across the whole list.
+     * Default `2000`. */
+    pageFlipThresholdMs?: number;
+}

package/dist/types/crud/reorder.js

@@ -0,0 +1 @@
+export {};

package/package.json

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