zod-collection-ui 0.0.1

package/dist/collection.js

@@ -0,0 +1,273 @@
+/**
+ * Collection Definition: The main entry point.
+ *
+ * `defineCollection` takes a Zod object schema + optional configuration and produces
+ * a CollectionDefinition with resolved affordances, generators, and utilities.
+ */
+import { inferFieldAffordances, getZodBaseType, humanizeFieldName, } from './inference.js';
+// ============================================================================
+// Default Collection Affordances
+// ============================================================================
+const DEFAULT_COLLECTION_AFFORDANCES = {
+    create: true,
+    read: true,
+    update: true,
+    delete: true,
+    bulkDelete: false,
+    bulkEdit: false,
+    search: true,
+    pagination: {
+        defaultPageSize: 25,
+        pageSizeOptions: [10, 25, 50, 100],
+        style: 'pages',
+        serverSide: false,
+    },
+    multiSort: true,
+    filterPanel: true,
+    selectable: 'multi',
+    columnVisibility: true,
+    columnOrder: true,
+    columnResize: true,
+    refresh: true,
+    defaultView: 'table',
+    views: ['table'],
+};
+const DEFAULT_PAGINATION = {
+    defaultPageSize: 25,
+    pageSizeOptions: [10, 25, 50, 100],
+    style: 'pages',
+    serverSide: false,
+};
+const DEFAULT_SEARCH = {
+    debounce: 300,
+    minChars: 1,
+    highlight: false,
+    placeholder: 'Search...',
+};
+// ============================================================================
+// defineCollection
+// ============================================================================
+/**
+ * Define a collection from a Zod object schema and optional configuration.
+ *
+ * This is the main entry point for the collection affordance library.
+ *
+ * @example
+ * ```typescript
+ * const projectCollection = defineCollection(
+ *   z.object({
+ *     id: z.string().uuid(),
+ *     name: z.string().min(1),
+ *     status: z.enum(['draft', 'active', 'archived']),
+ *     priority: z.number().int().min(1).max(5),
+ *   }),
+ *   {
+ *     affordances: { bulkDelete: true, export: ['csv', 'json'] },
+ *     fields: { name: { inlineEditable: true } },
+ *     operations: [{ name: 'archive', label: 'Archive', scope: 'item' }],
+ *   }
+ * );
+ * ```
+ */
+export function defineCollection(schema, config) {
+    // 1. Resolve collection-level affordances
+    const affordances = resolveCollectionAffordances(config?.affordances);
+    // 2. Resolve per-field affordances
+    const fieldAffordances = resolveAllFieldAffordances(schema, config?.fields);
+    // 3. Resolve identity fields
+    const idField = config?.idField ?? detectIdField(schema);
+    const labelField = config?.labelField ?? detectLabelField(schema, fieldAffordances);
+    // 4. Operations
+    const operations = config?.operations ?? [];
+    // 5. Build the collection definition
+    const definition = {
+        schema,
+        affordances,
+        fieldAffordances,
+        operations,
+        idField,
+        labelField,
+        getVisibleFields() {
+            return Object.entries(fieldAffordances)
+                .filter(([_, fa]) => fa.visible !== false && !fa.hidden && !fa.detailOnly)
+                .sort(([, a], [, b]) => (a.order ?? 999) - (b.order ?? 999))
+                .map(([key]) => key);
+        },
+        getSearchableFields() {
+            return Object.entries(fieldAffordances)
+                .filter(([_, fa]) => fa.searchable === true)
+                .map(([key]) => key);
+        },
+        getFilterableFields() {
+            return Object.entries(fieldAffordances)
+                .filter(([_, fa]) => fa.filterable !== false)
+                .map(([key, fa]) => ({ key, affordance: fa }));
+        },
+        getSortableFields() {
+            return Object.entries(fieldAffordances)
+                .filter(([_, fa]) => fa.sortable !== false && fa.sortable !== 'none')
+                .map(([key, fa]) => ({ key, affordance: fa }));
+        },
+        getGroupableFields() {
+            return Object.entries(fieldAffordances)
+                .filter(([_, fa]) => fa.groupable === true)
+                .map(([key, fa]) => ({ key, affordance: fa }));
+        },
+        getOperations(scope) {
+            return operations.filter((op) => op.scope === scope);
+        },
+        describe() {
+            return generateDescription(definition);
+        },
+    };
+    return definition;
+}
+// ============================================================================
+// Internals
+// ============================================================================
+function resolveCollectionAffordances(explicit) {
+    const merged = { ...DEFAULT_COLLECTION_AFFORDANCES, ...explicit };
+    // Normalize pagination
+    if (merged.pagination === true) {
+        merged.pagination = { ...DEFAULT_PAGINATION };
+    }
+    else if (merged.pagination && typeof merged.pagination === 'object') {
+        merged.pagination = { ...DEFAULT_PAGINATION, ...merged.pagination };
+    }
+    // Normalize search
+    if (merged.search === true) {
+        merged.search = { ...DEFAULT_SEARCH };
+    }
+    else if (merged.search && typeof merged.search === 'object') {
+        merged.search = { ...DEFAULT_SEARCH, ...merged.search };
+    }
+    return merged;
+}
+function resolveAllFieldAffordances(schema, explicit) {
+    const shape = schema.shape;
+    const result = {};
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        // Infer defaults from type + name + meta
+        const inferred = inferFieldAffordances(key, fieldSchema);
+        // Merge with explicit overrides
+        const explicitOverrides = explicit?.[key] ?? {};
+        const merged = { ...inferred, ...explicitOverrides };
+        // Ensure title and zodType are set
+        result[key] = {
+            ...merged,
+            title: merged.title ?? humanizeFieldName(key),
+            zodType: getZodBaseType(fieldSchema),
+        };
+    }
+    return result;
+}
+/** Detect the ID field from schema. */
+function detectIdField(schema) {
+    const shape = schema.shape;
+    // Direct 'id' field
+    if ('id' in shape)
+        return 'id';
+    if ('_id' in shape)
+        return '_id';
+    if ('uuid' in shape)
+        return 'uuid';
+    if ('key' in shape)
+        return 'key';
+    // First field ending with Id/id/_id
+    for (const key of Object.keys(shape)) {
+        if (/[iI]d$/.test(key) || key.endsWith('_id'))
+            return key;
+    }
+    // Fallback to first field
+    const keys = Object.keys(shape);
+    return keys[0] ?? 'id';
+}
+/** Detect the label field from schema + affordances. */
+function detectLabelField(schema, fieldAffordances) {
+    // Check for summaryField flag
+    for (const [key, fa] of Object.entries(fieldAffordances)) {
+        if (fa.summaryField)
+            return key;
+    }
+    // Common label field names
+    const labelNames = ['name', 'title', 'label', 'displayName', 'display_name', 'username'];
+    for (const name of labelNames) {
+        if (name in fieldAffordances)
+            return name;
+    }
+    // First string field that's not an ID
+    for (const [key, fa] of Object.entries(fieldAffordances)) {
+        if (fa.zodType === 'string' && fa.editable !== false)
+            return key;
+    }
+    return Object.keys(fieldAffordances)[0] ?? '';
+}
+/** Generate a human-readable description of the collection's affordances. */
+function generateDescription(def) {
+    const lines = [];
+    // Collection info
+    const fieldCount = Object.keys(def.fieldAffordances).length;
+    lines.push(`Collection with ${fieldCount} fields (ID: ${def.idField}, Label: ${def.labelField})`);
+    lines.push('');
+    // CRUD
+    const crud = [];
+    if (def.affordances.create)
+        crud.push('Create');
+    if (def.affordances.read)
+        crud.push('Read');
+    if (def.affordances.update)
+        crud.push('Update');
+    if (def.affordances.delete)
+        crud.push('Delete');
+    lines.push(`CRUD: ${crud.join(', ')}`);
+    // Bulk operations
+    const bulk = [];
+    if (def.affordances.bulkDelete)
+        bulk.push('Bulk Delete');
+    if (def.affordances.bulkEdit)
+        bulk.push('Bulk Edit');
+    if (bulk.length)
+        lines.push(`Bulk: ${bulk.join(', ')}`);
+    // Search
+    if (def.affordances.search) {
+        const searchFields = def.getSearchableFields();
+        lines.push(`Search: Yes (fields: ${searchFields.join(', ')})`);
+    }
+    // Pagination
+    if (def.affordances.pagination && typeof def.affordances.pagination === 'object') {
+        lines.push(`Pagination: ${def.affordances.pagination.style} (default: ${def.affordances.pagination.defaultPageSize})`);
+    }
+    lines.push('');
+    lines.push('Fields:');
+    // Per-field summary
+    for (const [key, fa] of Object.entries(def.fieldAffordances)) {
+        const caps = [];
+        if (fa.sortable && fa.sortable !== 'none')
+            caps.push(`sort:${fa.sortable}`);
+        if (fa.filterable)
+            caps.push(`filter:${fa.filterable}`);
+        if (fa.searchable)
+            caps.push('search');
+        if (fa.groupable)
+            caps.push('group');
+        if (fa.editable)
+            caps.push('edit');
+        if (fa.inlineEditable)
+            caps.push('inline-edit');
+        if (!fa.visible || fa.hidden)
+            caps.push('HIDDEN');
+        if (fa.detailOnly)
+            caps.push('detail-only');
+        lines.push(`  ${key} (${fa.zodType}): ${caps.join(', ') || 'display-only'}`);
+    }
+    // Operations
+    if (def.operations.length > 0) {
+        lines.push('');
+        lines.push('Custom Operations:');
+        for (const op of def.operations) {
+            lines.push(`  ${op.name} [${op.scope}]: ${op.label}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}

package/dist/data-provider.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Data Provider: A normalized interface for CRUD operations on collections.
+ *
+ * Inspired by React Admin's data provider (9 methods) but simplified.
+ * The interface is framework-agnostic — implementations can wrap REST, GraphQL,
+ * Supabase, Firebase, in-memory arrays, or any data source.
+ *
+ * Also includes an in-memory adapter for prototyping and testing.
+ */
+import type { SortingState, ColumnFilter } from './store.js';
+export interface GetListParams {
+    sort?: SortingState[];
+    filter?: ColumnFilter[];
+    search?: string;
+    pagination?: {
+        page: number;
+        pageSize: number;
+    };
+}
+export interface GetListResult<T> {
+    data: T[];
+    total: number;
+}
+/**
+ * Normalized data access interface for collection CRUD operations.
+ *
+ * All methods return Promises to support both sync and async data sources.
+ */
+export interface DataProvider<T> {
+    getList(params: GetListParams): Promise<GetListResult<T>>;
+    getOne(id: string): Promise<T>;
+    create(data: Partial<T>): Promise<T>;
+    update(id: string, data: Partial<T>): Promise<T>;
+    updateMany(ids: string[], data: Partial<T>): Promise<T[]>;
+    delete(id: string): Promise<void>;
+    deleteMany(ids: string[]): Promise<void>;
+}
+export interface InMemoryProviderOptions {
+    /** Field name used as the unique identifier. Default: 'id'. */
+    idField?: string;
+    /** Delay in ms to simulate network latency. Default: 0. */
+    simulateDelay?: number;
+    /** Searchable fields for the `search` parameter. Default: all string fields. */
+    searchFields?: string[];
+}
+/**
+ * Create an in-memory DataProvider from an array of items.
+ *
+ * Useful for prototyping, testing, and small datasets.
+ * Supports sorting, filtering, search, and pagination.
+ *
+ * @example
+ * ```typescript
+ * const provider = createInMemoryProvider([
+ *   { id: '1', name: 'Alpha', priority: 3 },
+ *   { id: '2', name: 'Beta', priority: 1 },
+ * ], { idField: 'id' });
+ *
+ * const { data, total } = await provider.getList({
+ *   sort: [{ id: 'priority', desc: false }],
+ *   pagination: { page: 1, pageSize: 10 },
+ * });
+ * ```
+ */
+export declare function createInMemoryProvider<T extends Record<string, any>>(initialData: T[], options?: InMemoryProviderOptions): DataProvider<T>;

package/dist/data-provider.js

@@ -0,0 +1,185 @@
+/**
+ * Data Provider: A normalized interface for CRUD operations on collections.
+ *
+ * Inspired by React Admin's data provider (9 methods) but simplified.
+ * The interface is framework-agnostic — implementations can wrap REST, GraphQL,
+ * Supabase, Firebase, in-memory arrays, or any data source.
+ *
+ * Also includes an in-memory adapter for prototyping and testing.
+ */
+/**
+ * Create an in-memory DataProvider from an array of items.
+ *
+ * Useful for prototyping, testing, and small datasets.
+ * Supports sorting, filtering, search, and pagination.
+ *
+ * @example
+ * ```typescript
+ * const provider = createInMemoryProvider([
+ *   { id: '1', name: 'Alpha', priority: 3 },
+ *   { id: '2', name: 'Beta', priority: 1 },
+ * ], { idField: 'id' });
+ *
+ * const { data, total } = await provider.getList({
+ *   sort: [{ id: 'priority', desc: false }],
+ *   pagination: { page: 1, pageSize: 10 },
+ * });
+ * ```
+ */
+export function createInMemoryProvider(initialData, options = {}) {
+    const idField = options.idField ?? 'id';
+    const delay = options.simulateDelay ?? 0;
+    const searchFields = options.searchFields;
+    // Internal mutable store
+    let items = [...initialData];
+    let nextId = items.length + 1;
+    const maybeDelay = () => delay > 0 ? new Promise(r => setTimeout(r, delay)) : Promise.resolve();
+    function getItemId(item) {
+        return String(item[idField]);
+    }
+    function matchesFilter(item, filter) {
+        const value = item[filter.id];
+        if (filter.value === undefined || filter.value === null || filter.value === '') {
+            return true;
+        }
+        // Array filter value → check if item value is in the array
+        if (Array.isArray(filter.value)) {
+            if (filter.value.length === 0)
+                return true;
+            if (Array.isArray(value)) {
+                // Array contains any of the filter values
+                return filter.value.some(fv => value.includes(fv));
+            }
+            return filter.value.includes(value);
+        }
+        // Range filter: { min, max }
+        if (typeof filter.value === 'object' && ('min' in filter.value || 'max' in filter.value)) {
+            const range = filter.value;
+            const num = Number(value);
+            if (range.min !== undefined && num < range.min)
+                return false;
+            if (range.max !== undefined && num > range.max)
+                return false;
+            return true;
+        }
+        // Boolean exact match
+        if (typeof filter.value === 'boolean') {
+            return value === filter.value;
+        }
+        // String contains (case-insensitive)
+        if (typeof filter.value === 'string') {
+            return String(value).toLowerCase().includes(filter.value.toLowerCase());
+        }
+        // Exact match fallback
+        return value === filter.value;
+    }
+    function matchesSearch(item, search) {
+        if (!search)
+            return true;
+        const lowerSearch = search.toLowerCase();
+        const fields = searchFields ?? Object.keys(item).filter(k => typeof item[k] === 'string');
+        return fields.some(field => {
+            const val = item[field];
+            return typeof val === 'string' && val.toLowerCase().includes(lowerSearch);
+        });
+    }
+    function compareValues(a, b) {
+        if (a === b)
+            return 0;
+        if (a == null)
+            return -1;
+        if (b == null)
+            return 1;
+        if (typeof a === 'string' && typeof b === 'string') {
+            return a.localeCompare(b);
+        }
+        if (a instanceof Date && b instanceof Date) {
+            return a.getTime() - b.getTime();
+        }
+        return a < b ? -1 : 1;
+    }
+    return {
+        async getList(params) {
+            await maybeDelay();
+            let result = [...items];
+            // Apply filters
+            if (params.filter) {
+                for (const filter of params.filter) {
+                    result = result.filter(item => matchesFilter(item, filter));
+                }
+            }
+            // Apply search
+            if (params.search) {
+                result = result.filter(item => matchesSearch(item, params.search));
+            }
+            const total = result.length;
+            // Apply sorting
+            if (params.sort && params.sort.length > 0) {
+                result.sort((a, b) => {
+                    for (const sortCol of params.sort) {
+                        const cmp = compareValues(a[sortCol.id], b[sortCol.id]);
+                        if (cmp !== 0)
+                            return sortCol.desc ? -cmp : cmp;
+                    }
+                    return 0;
+                });
+            }
+            // Apply pagination
+            if (params.pagination) {
+                const { page, pageSize } = params.pagination;
+                const start = (page - 1) * pageSize;
+                result = result.slice(start, start + pageSize);
+            }
+            return { data: result, total };
+        },
+        async getOne(id) {
+            await maybeDelay();
+            const item = items.find(i => getItemId(i) === id);
+            if (!item)
+                throw new Error(`Item not found: ${id}`);
+            return { ...item };
+        },
+        async create(data) {
+            await maybeDelay();
+            const newItem = {
+                ...data,
+                [idField]: data[idField] ?? String(nextId++),
+            };
+            items.push(newItem);
+            return { ...newItem };
+        },
+        async update(id, data) {
+            await maybeDelay();
+            const index = items.findIndex(i => getItemId(i) === id);
+            if (index === -1)
+                throw new Error(`Item not found: ${id}`);
+            items[index] = { ...items[index], ...data };
+            return { ...items[index] };
+        },
+        async updateMany(ids, data) {
+            await maybeDelay();
+            const updated = [];
+            for (const id of ids) {
+                const index = items.findIndex(i => getItemId(i) === id);
+                if (index !== -1) {
+                    items[index] = { ...items[index], ...data };
+                    updated.push({ ...items[index] });
+                }
+            }
+            return updated;
+        },
+        async delete(id) {
+            await maybeDelay();
+            const index = items.findIndex(i => getItemId(i) === id);
+            if (index === -1)
+                throw new Error(`Item not found: ${id}`);
+            items.splice(index, 1);
+        },
+        async deleteMany(ids) {
+            await maybeDelay();
+            const idSet = new Set(ids);
+            items = items.filter(i => !idSet.has(getItemId(i)));
+        },
+    };
+}
+//# sourceMappingURL=data-provider.js.map

package/dist/data-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-provider.js","sourceRoot":"","sources":["../src/data-provider.ts"],"names":[],"mappings":"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"}

package/dist/generators.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Generators: Transform CollectionDefinition into framework-specific configurations.
+ *
+ * This module produces configuration objects that existing renderers consume:
+ * - toColumnDefs() → TanStack Table ColumnDef[] shape
+ * - toFormConfig() → Form field configuration for create/edit forms
+ * - toFilterConfig() → Filter field configuration for filter panels
+ *
+ * These are "headless" — they produce data, not React components.
+ * The actual rendering is done by a renderer package (e.g. shadcn/ui) or equivalent.
+ */
+import { z } from 'zod';
+import type { CollectionDefinition } from './collection.js';
+import type { FilterType } from './types.js';
+/**
+ * A framework-agnostic column definition.
+ * Structurally compatible with TanStack Table's ColumnDef but framework-independent.
+ */
+export interface ColumnConfig {
+    /** Column identifier (matches field key). */
+    id: string;
+    /** Display header text. */
+    header: string;
+    /** Field accessor key. */
+    accessorKey?: string;
+    enableSorting: boolean;
+    enableColumnFilter: boolean;
+    enableGlobalFilter: boolean;
+    enableGrouping: boolean;
+    enableHiding: boolean;
+    enableResizing: boolean;
+    size?: number;
+    minSize?: number;
+    maxSize?: number;
+    sortingFn?: string;
+    sortDescFirst?: boolean;
+    filterFn?: string;
+    meta: {
+        zodType: string;
+        filterType: FilterType | boolean;
+        editable: boolean;
+        inlineEditable: boolean;
+        displayFormat?: string;
+        badge?: Record<string, string>;
+        copyable?: boolean;
+        truncate?: number;
+        tooltip?: boolean;
+        enumValues?: string[];
+        numericBounds?: {
+            min?: number;
+            max?: number;
+        };
+        pinned?: 'left' | 'right' | false;
+    };
+}
+/**
+ * Generate column definitions from a CollectionDefinition.
+ *
+ * @returns An array of ColumnConfig objects compatible with TanStack Table.
+ */
+export declare function toColumnDefs<T extends z.ZodObject<any>>(collection: CollectionDefinition<T>): ColumnConfig[];
+export interface FormFieldConfig {
+    /** Field key. */
+    name: string;
+    /** Display label. */
+    label: string;
+    /** Input widget type. */
+    type: string;
+    /** Whether this field is required. */
+    required: boolean;
+    /** Whether this field is disabled (read-only). */
+    disabled: boolean;
+    /** Whether this field is hidden. */
+    hidden: boolean;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Help text. */
+    helpText?: string;
+    /** Default value. */
+    defaultValue?: unknown;
+    /** Options for select/multiselect fields. */
+    options?: {
+        label: string;
+        value: string;
+    }[];
+    /** Display order. */
+    order: number;
+    /** Zod type for the underlying schema. */
+    zodType: string;
+}
+/**
+ * Generate form field configurations for create or edit forms.
+ */
+export declare function toFormConfig<T extends z.ZodObject<any>>(collection: CollectionDefinition<T>, mode?: 'create' | 'edit'): FormFieldConfig[];
+export interface FilterFieldConfig {
+    /** Field key. */
+    name: string;
+    /** Display label. */
+    label: string;
+    /** Filter UI type. */
+    filterType: FilterType;
+    /** Options for select/multiselect filters. */
+    options?: {
+        label: string;
+        value: string;
+    }[];
+    /** Numeric bounds for range filters. */
+    bounds?: {
+        min?: number;
+        max?: number;
+    };
+    /** Zod type. */
+    zodType: string;
+}
+/**
+ * Generate filter field configurations for the filter panel.
+ */
+export declare function toFilterConfig<T extends z.ZodObject<any>>(collection: CollectionDefinition<T>): FilterFieldConfig[];