zod-collection-ui 0.0.1

package/dist/generators.js

@@ -0,0 +1,239 @@
+/**
+ * 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 { getEnumValues, getNumericBounds } from './inference.js';
+/** Map Zod type to the appropriate TanStack Table sort function name. */
+function inferSortFnName(zodType, affordance) {
+    switch (zodType) {
+        case 'string': return 'text';
+        case 'number':
+        case 'int':
+        case 'float':
+        case 'bigint': return 'basic';
+        case 'date': return 'datetime';
+        case 'boolean': return 'basic';
+        case 'enum': return 'text';
+        default: return 'basic';
+    }
+}
+/** Map filter type + Zod type to the appropriate TanStack Table filter function name. */
+function inferFilterFnName(filterType, zodType) {
+    if (typeof filterType === 'boolean')
+        return 'includesString';
+    switch (filterType) {
+        case 'exact': return 'equalsString';
+        case 'search': return 'includesString';
+        case 'select': return 'arrIncludes';
+        case 'multiSelect': return 'arrIncludesSome';
+        case 'range': return 'inNumberRange';
+        case 'contains': return 'arrIncludesAll';
+        case 'boolean': return 'equals';
+        case 'fuzzy': return 'includesString';
+        default: return 'includesString';
+    }
+}
+/**
+ * Generate column definitions from a CollectionDefinition.
+ *
+ * @returns An array of ColumnConfig objects compatible with TanStack Table.
+ */
+export function toColumnDefs(collection) {
+    const columns = [];
+    const shape = collection.schema.shape;
+    // Selection column (if selectable)
+    if (collection.affordances.selectable) {
+        columns.push({
+            id: 'select',
+            header: '',
+            enableSorting: false,
+            enableColumnFilter: false,
+            enableGlobalFilter: false,
+            enableGrouping: false,
+            enableHiding: false,
+            enableResizing: false,
+            size: 40,
+            meta: {
+                zodType: 'display',
+                filterType: false,
+                editable: false,
+                inlineEditable: false,
+            },
+        });
+    }
+    // Data columns from visible fields
+    const visibleFields = collection.getVisibleFields();
+    for (const key of visibleFields) {
+        const fa = collection.fieldAffordances[key];
+        const fieldSchema = shape[key];
+        if (!fieldSchema)
+            continue;
+        const zodType = fa.zodType;
+        columns.push({
+            id: key,
+            header: fa.title,
+            accessorKey: key,
+            enableSorting: fa.sortable !== false && fa.sortable !== 'none',
+            enableColumnFilter: fa.filterable !== false,
+            enableGlobalFilter: fa.searchable ?? false,
+            enableGrouping: fa.groupable ?? false,
+            enableHiding: !fa.hidden,
+            enableResizing: fa.resizable ?? true,
+            size: fa.columnWidth,
+            minSize: fa.minWidth,
+            maxSize: fa.maxWidth,
+            sortingFn: inferSortFnName(zodType, fa),
+            sortDescFirst: fa.sortable === 'desc',
+            filterFn: fa.filterable ? inferFilterFnName(fa.filterable, zodType) : undefined,
+            meta: {
+                zodType,
+                filterType: fa.filterable ?? false,
+                editable: fa.editable ?? false,
+                inlineEditable: fa.inlineEditable ?? false,
+                displayFormat: fa.displayFormat,
+                badge: fa.badge,
+                copyable: fa.copyable,
+                truncate: fa.truncate,
+                tooltip: fa.tooltip,
+                enumValues: fieldSchema ? getEnumValues(fieldSchema) ?? undefined : undefined,
+                numericBounds: fieldSchema ? getNumericBounds(fieldSchema) : undefined,
+                pinned: fa.pinned,
+            },
+        });
+    }
+    // Actions column (if there are item-level operations)
+    const itemOps = collection.getOperations('item');
+    if (itemOps.length > 0) {
+        columns.push({
+            id: 'actions',
+            header: '',
+            enableSorting: false,
+            enableColumnFilter: false,
+            enableGlobalFilter: false,
+            enableGrouping: false,
+            enableHiding: false,
+            enableResizing: false,
+            size: 60 + (itemOps.length - 1) * 32,
+            meta: {
+                zodType: 'display',
+                filterType: false,
+                editable: false,
+                inlineEditable: false,
+            },
+        });
+    }
+    return columns;
+}
+/** Infer the form widget type from Zod type + affordances. */
+function inferFormWidgetType(zodType, fa) {
+    // Explicit override takes precedence
+    if (fa.editWidget)
+        return fa.editWidget;
+    switch (zodType) {
+        case 'string': return 'text';
+        case 'number':
+        case 'int':
+        case 'float': return 'number';
+        case 'boolean': return 'checkbox';
+        case 'enum': return 'select';
+        case 'date': return 'date';
+        case 'array': return 'tags';
+        case 'object': return 'json';
+        default: return 'text';
+    }
+}
+/**
+ * Generate form field configurations for create or edit forms.
+ */
+export function toFormConfig(collection, mode = 'create') {
+    const fields = [];
+    const shape = collection.schema.shape;
+    let orderCounter = 0;
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        const fa = collection.fieldAffordances[key];
+        // Skip fields that are not relevant for this mode
+        if (fa.readable === false && mode === 'edit')
+            continue;
+        if (fa.editable === false && mode === 'create' && !fa.requiredOnCreate)
+            continue;
+        if (fa.editable === false && mode === 'edit')
+            continue;
+        if (fa.hidden)
+            continue;
+        // Skip immutable fields on edit
+        if (mode === 'edit' && fa.immutableAfterCreate)
+            continue;
+        const zodType = fa.zodType;
+        const isRequired = mode === 'create'
+            ? (fa.requiredOnCreate ?? false)
+            : (fa.requiredOnUpdate ?? false);
+        // Get enum options if applicable
+        let options;
+        const enumValues = getEnumValues(fieldSchema);
+        if (enumValues) {
+            options = enumValues.map(v => ({
+                label: v.charAt(0).toUpperCase() + v.slice(1),
+                value: v,
+            }));
+        }
+        fields.push({
+            name: key,
+            label: fa.title,
+            type: inferFormWidgetType(zodType, fa),
+            required: isRequired,
+            disabled: fa.editable === false,
+            hidden: fa.hidden ?? false,
+            placeholder: fa.editPlaceholder,
+            helpText: fa.editHelp ?? fa.description,
+            options,
+            order: fa.order ?? orderCounter++,
+            zodType,
+        });
+    }
+    return fields.sort((a, b) => a.order - b.order);
+}
+/**
+ * Generate filter field configurations for the filter panel.
+ */
+export function toFilterConfig(collection) {
+    const filters = [];
+    const shape = collection.schema.shape;
+    const filterableFields = collection.getFilterableFields();
+    for (const { key, affordance } of filterableFields) {
+        const fieldSchema = shape[key];
+        if (!fieldSchema)
+            continue;
+        const filterType = typeof affordance.filterable === 'string'
+            ? affordance.filterable
+            : 'search';
+        let options;
+        const enumValues = getEnumValues(fieldSchema);
+        if (enumValues && (filterType === 'select' || filterType === 'multiSelect')) {
+            options = enumValues.map(v => ({
+                label: v.charAt(0).toUpperCase() + v.slice(1),
+                value: v,
+            }));
+        }
+        let bounds;
+        if (filterType === 'range') {
+            bounds = getNumericBounds(fieldSchema);
+        }
+        filters.push({
+            name: key,
+            label: affordance.title ?? key,
+            filterType,
+            options,
+            bounds,
+            zodType: collection.fieldAffordances[key].zodType,
+        });
+    }
+    return filters;
+}
+//# sourceMappingURL=generators.js.map

package/dist/generators.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * zod-collection-ui — Schema-driven collection affordances
+ *
+ * Declare once, render anywhere. Define a Zod schema with affordance metadata
+ * and get auto-generated table configurations, form configs, and action definitions.
+ */
+export { defineCollection } from './collection.js';
+export type { CollectionDefinition } from './collection.js';
+export { inferFieldAffordances, getZodBaseType, unwrapZodSchema, hasZodCheck, getEnumValues, getZodMeta, getNumericBounds, humanizeFieldName, } from './inference.js';
+export { toColumnDefs, toFormConfig, toFilterConfig, } from './generators.js';
+export type { ColumnConfig, FormFieldConfig, FilterFieldConfig } from './generators.js';
+export { createCollectionStore } from './store.js';
+export type { CollectionState, CollectionActions, CollectionStore, SortingState, ColumnFilter, PaginationState, } from './store.js';
+export { createInMemoryProvider } from './data-provider.js';
+export type { DataProvider, GetListParams, GetListResult, InMemoryProviderOptions } from './data-provider.js';
+export { toPrompt } from './prompt.js';
+export type { FieldAffordance, SortDirection, FilterType, AggregationFn, CollectionAffordances, CollectionConfig, PaginationConfig, SearchConfig, MultiSortConfig, GroupByConfig, FilterPreset, ViewMode, OperationDefinition, OperationScope, OperationConfirmation, } from './types.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * zod-collection-ui — Schema-driven collection affordances
+ *
+ * Declare once, render anywhere. Define a Zod schema with affordance metadata
+ * and get auto-generated table configurations, form configs, and action definitions.
+ */
+export { defineCollection } from './collection.js';
+export { inferFieldAffordances, getZodBaseType, unwrapZodSchema, hasZodCheck, getEnumValues, getZodMeta, getNumericBounds, humanizeFieldName, } from './inference.js';
+export { toColumnDefs, toFormConfig, toFilterConfig, } from './generators.js';
+export { createCollectionStore } from './store.js';
+export { createInMemoryProvider } from './data-provider.js';
+export { toPrompt } from './prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAUnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/inference.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Inference Engine: Zod Type → Default Affordances
+ *
+ * Given a Zod schema field (with no .meta() annotations), infers sensible
+ * default affordances based on:
+ * 1. The Zod type (string, number, boolean, enum, date, array, object)
+ * 2. Zod validations/checks (email, url, uuid, min, max, etc.)
+ * 3. Field name heuristics (id, createdAt, password, etc.)
+ * 4. Zod v4 metadata (if present via .meta())
+ */
+import { z } from 'zod';
+import type { FieldAffordance } from './types.js';
+/** Get the underlying type name from a Zod schema, unwrapping optionals/nullables/defaults. */
+export declare function getZodBaseType(schema: z.ZodType): string;
+/** Get the inner schema, unwrapping optionals/nullables/defaults. */
+export declare function unwrapZodSchema(schema: z.ZodType): z.ZodType;
+/** Check if a Zod schema has a specific check/validation. */
+export declare function hasZodCheck(schema: z.ZodType, kind: string): boolean;
+/** Get enum values from a Zod enum schema. */
+export declare function getEnumValues(schema: z.ZodType): string[] | null;
+/** Read Zod v4 metadata from the global registry. */
+export declare function getZodMeta(schema: z.ZodType): Record<string, unknown> | undefined;
+/** Get the numeric min/max from Zod checks. */
+export declare function getNumericBounds(schema: z.ZodType): {
+    min?: number;
+    max?: number;
+};
+/**
+ * Given a field name and its Zod schema, infer sensible default affordances.
+ *
+ * Inference layers (later layers override earlier):
+ * 1. Type-based defaults (string → searchable, number → range filterable, etc.)
+ * 2. Validation-based refinements (email → email widget, uuid → not editable)
+ * 3. Name-based heuristics (id → hidden, createdAt → not editable, password → not readable)
+ * 4. Zod .meta() annotations (explicit overrides from the developer)
+ */
+export declare function inferFieldAffordances(key: string, schema: z.ZodType): FieldAffordance;
+/** Convert a camelCase or snake_case field name to a human-readable label. */
+export declare function humanizeFieldName(key: string): string;