runeforge 0.0.17 → 0.0.19

package/dist/components/table/PaginatedTable.svelte

@@ -30,6 +30,8 @@
     initialSort = undefined as { column: string; direction: SortDirection } | undefined,
     initialFilters = undefined as Partial<FilterSnapshot> | undefined,
     onPaginationChange = undefined as ((query: TableQuery) => void) | undefined,
+    visibleRows = $bindable<T[]>([]),
+    query = $bindable<TableQuery | undefined>(undefined),
   }: {
     data?: T[];
     columns?: ColumnDefinition<T>[];
@@ -45,6 +47,12 @@
     initialSort?: { column: string; direction: SortDirection };
     initialFilters?: Partial<FilterSnapshot>;
     onPaginationChange?: (query: TableQuery) => void;
+    /** Filtered + sorted rows before page slicing (client mode), or the
+     * current page's rows as-is (server mode). Read-only for callers. */
+    visibleRows?: T[];
+    /** Current ordering + filters snapshot, kept in sync for callers that
+     * need to replicate the active query (e.g. exporting server-side). */
+    query?: TableQuery;
   } = $props();
 
   // Intentional one-time hydration of local state from the initial prop
@@ -107,6 +115,14 @@
     }
   });
 
+  // Surface the filtered+sorted rows and current query for callers (e.g. export).
+  $effect(() => {
+    visibleRows = sorted.map((e) => e.row);
+  });
+  $effect(() => {
+    query = currentQuery(displayPage);
+  });
+
   function currentQuery(page: number): TableQuery {
     return {
       page,

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

@@ -21,9 +21,15 @@ declare function $$render<T extends object = Record<string, unknown>>(): {
         };
         initialFilters?: Partial<FilterSnapshot>;
         onPaginationChange?: (query: TableQuery) => void;
+        /** Filtered + sorted rows before page slicing (client mode), or the
+         * current page's rows as-is (server mode). Read-only for callers. */
+        visibleRows?: T[];
+        /** Current ordering + filters snapshot, kept in sync for callers that
+         * need to replicate the active query (e.g. exporting server-side). */
+        query?: TableQuery;
     };
     exports: {};
-    bindings: "selected";
+    bindings: "selected" | "visibleRows" | "query";
     slots: {};
     events: {};
 };
@@ -31,7 +37,7 @@ declare class __sveltets_Render<T extends object = Record<string, unknown>> {
     props(): ReturnType<typeof $$render<T>>['props'];
     events(): ReturnType<typeof $$render<T>>['events'];
     slots(): ReturnType<typeof $$render<T>>['slots'];
-    bindings(): "selected";
+    bindings(): "selected" | "visibleRows" | "query";
     exports(): {};
 }
 interface $$IsomorphicComponent {

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

@@ -0,0 +1,17 @@
+import type { ColumnDefinition } from '../../types/crud.js';
+/**
+ * Minimal duck-typed subset of the SheetJS (`xlsx`) module API used for
+ * building a workbook. Runeforge never imports `xlsx` itself — the consumer
+ * installs it and passes the resolved module in, so the dependency stays
+ * fully optional and never affects consumers who don't use Excel export.
+ */
+export interface XlsxModule {
+    utils: {
+        aoa_to_sheet: (data: unknown[][]) => unknown;
+        book_new: () => unknown;
+        book_append_sheet: (workbook: unknown, worksheet: unknown, name?: string) => void;
+    };
+    writeFile: (workbook: unknown, filename: string) => void;
+}
+export declare function downloadCsv<T extends object>(rows: T[], columns: ColumnDefinition<T>[], filename: string): void;
+export declare function downloadXlsx<T extends object>(rows: T[], columns: ColumnDefinition<T>[], filename: string, xlsx: XlsxModule): void;

package/dist/components/table/export.js

@@ -0,0 +1,31 @@
+import { cellRenderedText } from './utils.js';
+function buildTable(rows, columns) {
+    const headers = columns.map((col) => col.title ?? col.attribute);
+    const body = rows.map((row) => columns.map((col) => cellRenderedText(row, col)));
+    return { headers, body };
+}
+function escapeCsvCell(value) {
+    return /[",\n]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+function triggerDownload(blob, filename) {
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.href = url;
+    link.download = filename;
+    link.click();
+    URL.revokeObjectURL(url);
+}
+export function downloadCsv(rows, columns, filename) {
+    const { headers, body } = buildTable(rows, columns);
+    const csv = [headers, ...body]
+        .map((line) => line.map(escapeCsvCell).join(','))
+        .join('\r\n');
+    triggerDownload(new Blob([csv], { type: 'text/csv;charset=utf-8;' }), `${filename}.csv`);
+}
+export function downloadXlsx(rows, columns, filename, xlsx) {
+    const { headers, body } = buildTable(rows, columns);
+    const worksheet = xlsx.utils.aoa_to_sheet([headers, ...body]);
+    const workbook = xlsx.utils.book_new();
+    xlsx.utils.book_append_sheet(workbook, worksheet);
+    xlsx.writeFile(workbook, `${filename}.xlsx`);
+}

package/dist/i18n/en.js

@@ -15,6 +15,10 @@ export const en = {
     edit: 'Edit',
     delete: 'Delete',
     create: 'Create',
+    searchPlaceholder: 'Search...',
+    export: 'Export',
+    exportCsv: 'Export as CSV',
+    exportExcel: 'Export as Excel',
     save: 'Save',
     saveAndContinue: 'Save and continue',
     cancel: 'Cancel',
@@ -22,5 +26,5 @@ export const en = {
     confirm: 'Confirm',
     deleteConfirm: (count, actionLabel) => `Are you sure you want to ${String(actionLabel).toLowerCase()} ${count} item${count === 1 ? '' : 's'}?`,
     required: (field) => `${field} is required`,
-    serverError: 'Unexpected server error.',
+    serverError: 'Unexpected server error.'
 };

package/dist/i18n/es.js

@@ -15,6 +15,10 @@ export const es = {
     edit: 'Editar',
     delete: 'Eliminar',
     create: 'Crear',
+    searchPlaceholder: 'Buscar...',
+    export: 'Exportar',
+    exportCsv: 'Exportar a CSV',
+    exportExcel: 'Exportar a Excel',
     save: 'Guardar',
     saveAndContinue: 'Guardar y continuar',
     cancel: 'Cancelar',
@@ -22,5 +26,5 @@ export const es = {
     confirm: 'Confirmar',
     deleteConfirm: (count, actionLabel) => `¿Seguro que querés ${String(actionLabel).toLowerCase()} ${count} elemento${count === 1 ? '' : 's'}?`,
     required: (field) => `${field} es requerido`,
-    serverError: 'Error inesperado del servidor.',
+    serverError: 'Error inesperado del servidor.'
 };

package/dist/i18n/types.d.ts

@@ -15,6 +15,10 @@ export interface RuneforgeStrings {
     edit: string;
     delete: string;
     create: string;
+    searchPlaceholder: string;
+    export: string;
+    exportCsv: string;
+    exportExcel: string;
     save: string;
     saveAndContinue: string;
     cancel: string;

package/dist/icons/defaults/Download.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+  let { size = '1em', class: cls = '' }: { size?: string | number; class?: string } = $props();
+</script>
+<svg xmlns="http://www.w3.org/2000/svg" width={size} height={size} viewBox="0 0 16 16" fill="currentColor" class={cls}>
+  <path d="M.5 9.9a.5.5 0 0 1 .5.5v2.5a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-2.5a.5.5 0 0 1 1 0v2.5a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2v-2.5a.5.5 0 0 1 .5-.5"/>
+  <path d="M7.646 11.854a.5.5 0 0 0 .708 0l3-3a.5.5 0 0 0-.708-.708L8.5 10.293V1.5a.5.5 0 0 0-1 0v8.793L5.354 8.146a.5.5 0 1 0-.708.708z"/>
+</svg>

package/dist/icons/defaults/Download.svelte.d.ts

@@ -0,0 +1,7 @@
+type $$ComponentProps = {
+    size?: string | number;
+    class?: string;
+};
+declare const Download: import("svelte").Component<$$ComponentProps, {}, "">;
+type Download = ReturnType<typeof Download>;
+export default Download;

package/dist/icons/sets/bootstrap.js

@@ -10,7 +10,7 @@
  *   setIconSet(bootstrapIconSet);
  */
 import * as Icons from 'svelte-bootstrap-icons';
-const { ChevronExpand, CaretUpFill, CaretDownFill, Funnel, FunnelFill, Plus, Eye, PencilSquare, Trash3, HouseDoor, Folder, EyeSlash, X, } = Icons;
+const { ChevronExpand, CaretUpFill, CaretDownFill, Funnel, FunnelFill, Plus, Eye, PencilSquare, Trash3, HouseDoor, Folder, EyeSlash, X, Download, } = Icons;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function asIcon(c) { return c; }
 export const bootstrapIconSet = {
@@ -28,6 +28,7 @@ export const bootstrapIconSet = {
     folder: asIcon(Folder),
     passwordShow: asIcon(Eye),
     passwordHide: asIcon(EyeSlash),
+    download: asIcon(Download),
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getByName: (name) => asIcon(Icons[name]) ?? null,
 };

package/dist/icons/sets/default.js

@@ -12,6 +12,7 @@ import Home from '../defaults/Home.svelte';
 import Folder from '../defaults/Folder.svelte';
 import PasswordShow from '../defaults/PasswordShow.svelte';
 import PasswordHide from '../defaults/PasswordHide.svelte';
+import Download from '../defaults/Download.svelte';
 export const defaultIconSet = {
     sortNone: SortNone,
     sortAsc: SortAsc,
@@ -27,4 +28,5 @@ export const defaultIconSet = {
     folder: Folder,
     passwordShow: PasswordShow,
     passwordHide: PasswordHide,
+    download: Download,
 };

package/dist/icons/types.d.ts

@@ -18,5 +18,6 @@ export interface CRUDIconSet {
     folder: IconComponent;
     passwordShow: IconComponent;
     passwordHide: IconComponent;
+    download: IconComponent;
     getByName?: (name: string) => IconComponent | null;
 }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { BreadcrumbItem } from './types/breadcrumb.js';
 export { AttributeType } from './types/attribute.js';
 export type { AttributeMetadata, InterfaceMetadata, SelectOption, OptionsResolver, FormatterResolver } from './types/attribute.js';
 export type { CellProps, CellComponent, CellFormatter, SortDirection, IndexedRow, DistinctEntry, PaginatedEnvelope, ServerPagination, FilterSnapshot, TableQuery } from './types/table.js';
-export type { ColumnDefinition, FieldDefinition, ActionConfiguration, CustomAction, RowAction } from './types/crud.js';
+export type { ColumnDefinition, FieldDefinition, ActionConfiguration, CustomAction, CustomBulkAction, RowAction, SearchConfiguration } from './types/crud.js';
 export type { RuneforgeConfig } from './config/context.js';
 export { setConfig, getConfig } from './config/context.js';
 export type { CRUDIconSet, IconComponent } from './icons/types.js';
@@ -39,6 +39,7 @@ export { default as CRUDList } from './components/crud/views/List.svelte';
 export { default as CRUDCreate } from './components/crud/views/Create.svelte';
 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 } from './components/crud/utils/resolution.js';
 export { fieldLabel, initials } from './components/crud/utils/misc.js';

package/dist/index.js

@@ -36,6 +36,7 @@ export { default as CRUDList } from './components/crud/views/List.svelte';
 export { default as CRUDCreate } from './components/crud/views/Create.svelte';
 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';
 // CRUD utilities
 export { AUTO_EXCLUDED } from './components/crud/utils/constants.js';
 export { resolveOptions, resolveFormatter, inferType } from './components/crud/utils/resolution.js';

package/dist/types/crud.d.ts

@@ -47,3 +47,16 @@ export interface RowAction<T extends object = Record<string, unknown>> {
     condition?: (item: T) => boolean;
     run: (item: T) => void;
 }
+export interface CustomBulkAction<T extends object = Record<string, unknown>> {
+    label: string;
+    icon: any;
+    endpoint: string;
+    variant?: string;
+    confirm?: boolean;
+    condition?: (items: T[]) => boolean;
+}
+export interface SearchConfiguration {
+    param?: string;
+    placeholder?: string;
+    debounceMs?: number;
+}

package/package.json

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