zod-collection-ui 0.0.1

package/dist/inference.js

@@ -0,0 +1,395 @@
+/**
+ * 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())
+ */
+// ============================================================================
+// Schema Introspection Helpers
+// ============================================================================
+/** Get the underlying type name from a Zod schema, unwrapping optionals/nullables/defaults. */
+export function getZodBaseType(schema) {
+    const def = schema._zod?.def;
+    if (!def)
+        return 'unknown';
+    // Unwrap wrapper types
+    if (def.type === 'optional' || def.type === 'nullable' || def.type === 'default') {
+        return getZodBaseType(def.innerType);
+    }
+    return def.type ?? 'unknown';
+}
+/** Get the inner schema, unwrapping optionals/nullables/defaults. */
+export function unwrapZodSchema(schema) {
+    const def = schema._zod?.def;
+    if (!def)
+        return schema;
+    if (def.type === 'optional' || def.type === 'nullable' || def.type === 'default') {
+        return unwrapZodSchema(def.innerType);
+    }
+    return schema;
+}
+/** Check if a Zod schema has a specific check/validation. */
+export function hasZodCheck(schema, kind) {
+    const unwrapped = unwrapZodSchema(schema);
+    const def = unwrapped._zod?.def;
+    if (!def)
+        return false;
+    // Zod v4: checks are on the def
+    if (def.checks) {
+        return def.checks.some((c) => c.kind === kind);
+    }
+    // Zod v4: format checks might be on the type itself
+    if (def.format === kind)
+        return true;
+    if (def.type === kind)
+        return true;
+    return false;
+}
+/** Get enum values from a Zod enum schema. */
+export function getEnumValues(schema) {
+    const unwrapped = unwrapZodSchema(schema);
+    const def = unwrapped._zod?.def;
+    if (!def)
+        return null;
+    if (def.type === 'enum') {
+        // Zod v4 uses `entries` (object { a: 'a', b: 'b' }) not `values` (array)
+        if (def.entries) {
+            return Object.values(def.entries);
+        }
+        return def.values ?? null;
+    }
+    return null;
+}
+/** Read Zod v4 metadata from the global registry. */
+export function getZodMeta(schema) {
+    try {
+        // Zod v4: .meta() without args returns the metadata
+        const meta = schema.meta?.();
+        return meta ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Get the numeric min/max from Zod checks. */
+export function getNumericBounds(schema) {
+    const unwrapped = unwrapZodSchema(schema);
+    const result = {};
+    // Zod v4: min/max are instance properties on the schema
+    const asAny = unwrapped;
+    if (typeof asAny.minValue === 'number' && asAny.minValue !== -Number.MAX_SAFE_INTEGER) {
+        result.min = asAny.minValue;
+    }
+    if (typeof asAny.maxValue === 'number' && asAny.maxValue !== Number.MAX_SAFE_INTEGER) {
+        result.max = asAny.maxValue;
+    }
+    // Fallback: check the checks array (Zod v3 style)
+    const def = unwrapped._zod?.def;
+    if (def?.checks) {
+        for (const check of def.checks) {
+            if (check.kind === 'min' && result.min === undefined)
+                result.min = check.value;
+            if (check.kind === 'max' && result.max === undefined)
+                result.max = check.value;
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Type-Based Inference
+// ============================================================================
+const STRING_FIELD_DEFAULTS = {
+    sortable: 'both',
+    filterable: 'search',
+    searchable: true,
+    groupable: false,
+    editable: true,
+    visible: true,
+};
+const NUMBER_FIELD_DEFAULTS = {
+    sortable: 'both',
+    filterable: 'range',
+    searchable: false,
+    groupable: false,
+    editable: true,
+    visible: true,
+    aggregatable: ['sum', 'avg', 'min', 'max'],
+};
+const BOOLEAN_FIELD_DEFAULTS = {
+    sortable: 'both',
+    filterable: 'boolean',
+    searchable: false,
+    groupable: true,
+    editable: true,
+    visible: true,
+};
+const ENUM_FIELD_DEFAULTS = {
+    sortable: 'both',
+    filterable: 'select',
+    searchable: false,
+    groupable: true,
+    editable: true,
+    visible: true,
+};
+const DATE_FIELD_DEFAULTS = {
+    sortable: 'both',
+    filterable: 'range',
+    searchable: false,
+    groupable: false,
+    editable: true,
+    visible: true,
+};
+const ARRAY_FIELD_DEFAULTS = {
+    sortable: false,
+    filterable: 'contains',
+    searchable: false,
+    groupable: false,
+    editable: true,
+    visible: true,
+};
+const OBJECT_FIELD_DEFAULTS = {
+    sortable: false,
+    filterable: false,
+    searchable: false,
+    groupable: false,
+    editable: true,
+    visible: true,
+    detailOnly: true,
+};
+const UNKNOWN_FIELD_DEFAULTS = {
+    sortable: false,
+    filterable: false,
+    searchable: false,
+    groupable: false,
+    editable: false,
+    visible: true,
+};
+/** Map Zod base type to default affordances. */
+function getTypeDefaults(zodType) {
+    switch (zodType) {
+        case 'string':
+            return { ...STRING_FIELD_DEFAULTS };
+        case 'number':
+        case 'int':
+        case 'float':
+        case 'bigint':
+            return { ...NUMBER_FIELD_DEFAULTS };
+        case 'boolean':
+            return { ...BOOLEAN_FIELD_DEFAULTS };
+        case 'enum':
+        case 'nativeEnum':
+            return { ...ENUM_FIELD_DEFAULTS };
+        case 'date':
+            return { ...DATE_FIELD_DEFAULTS };
+        case 'array':
+        case 'set':
+        case 'tuple':
+            return { ...ARRAY_FIELD_DEFAULTS };
+        case 'object':
+        case 'record':
+        case 'map':
+            return { ...OBJECT_FIELD_DEFAULTS };
+        default:
+            return { ...UNKNOWN_FIELD_DEFAULTS };
+    }
+}
+// ============================================================================
+// Validation-Based Refinements
+// ============================================================================
+/** Refine defaults based on Zod validations/checks. */
+function refineByValidations(schema, defaults) {
+    const unwrapped = unwrapZodSchema(schema);
+    const def = unwrapped._zod?.def;
+    if (!def)
+        return defaults;
+    const refined = { ...defaults };
+    // String format checks
+    if (def.type === 'string') {
+        // Check for format-specific strings
+        if (def.checks) {
+            for (const check of def.checks) {
+                if (check.kind === 'email') {
+                    refined.editWidget = 'email';
+                    refined.filterable = 'search';
+                }
+                if (check.kind === 'url' || check.kind === 'uri') {
+                    refined.editWidget = 'url';
+                    refined.searchable = false;
+                    refined.filterable = 'exact';
+                }
+                if (check.kind === 'uuid' || check.kind === 'ulid' || check.kind === 'cuid') {
+                    refined.editable = false;
+                    refined.filterable = 'exact';
+                    refined.searchable = false;
+                }
+                if (check.kind === 'regex') {
+                    // Has a pattern validation
+                }
+            }
+        }
+        // Check for format property (Zod v4 uses this for email, url, etc.)
+        if (def.format === 'email') {
+            refined.editWidget = 'email';
+        }
+        if (def.format === 'uri' || def.format === 'url') {
+            refined.editWidget = 'url';
+            refined.searchable = false;
+        }
+        if (def.format === 'uuid') {
+            refined.editable = false;
+            refined.filterable = 'exact';
+            refined.searchable = false;
+        }
+    }
+    // Boolean with default → might be a toggle
+    if (def.type === 'boolean' && 'defaultValue' in def) {
+        refined.editWidget = 'switch';
+    }
+    return refined;
+}
+// ============================================================================
+// Name-Based Heuristics
+// ============================================================================
+const ID_PATTERNS = /^(id|_id|uuid|uid|key|pk)$/i;
+const ID_SUFFIX_PATTERNS = /(_id|Id|ID|_key|Key)$/;
+const CREATED_PATTERNS = /^(created_?at|creation_?date|date_?created|ctime)$/i;
+const UPDATED_PATTERNS = /^(updated_?at|modified_?at|last_?modified|mtime|changed_?at)$/i;
+const DELETED_PATTERNS = /^(deleted_?at|removed_?at)$/i;
+const SECRET_PATTERNS = /^(password|secret|token|api_?key|access_?key|private_?key|hash|salt)$/i;
+const EMAIL_PATTERNS = /^(email|e_?mail)$/i;
+const NAME_PATTERNS = /^(name|title|label|display_?name|full_?name|username)$/i;
+const DESCRIPTION_PATTERNS = /^(description|summary|body|content|text|bio|about|notes)$/i;
+const IMAGE_PATTERNS = /^(image|photo|avatar|thumbnail|picture|icon|logo)(_?url)?$/i;
+const STATUS_PATTERNS = /^(status|state|phase|stage)$/i;
+/** Refine defaults based on field name heuristics. */
+function refineByFieldName(key, defaults) {
+    const refined = { ...defaults };
+    if (ID_PATTERNS.test(key) || ID_SUFFIX_PATTERNS.test(key)) {
+        refined.editable = false;
+        refined.visible = key === 'id' ? false : refined.visible;
+        refined.filterable = 'exact';
+        refined.searchable = false;
+    }
+    if (CREATED_PATTERNS.test(key)) {
+        refined.editable = false;
+        refined.sortable = 'both';
+        refined.filterable = 'range';
+    }
+    if (UPDATED_PATTERNS.test(key)) {
+        refined.editable = false;
+        refined.visible = false;
+        refined.sortable = 'both';
+    }
+    if (DELETED_PATTERNS.test(key)) {
+        refined.editable = false;
+        refined.visible = false;
+    }
+    if (SECRET_PATTERNS.test(key)) {
+        refined.readable = false;
+        refined.searchable = false;
+        refined.sortable = false;
+        refined.filterable = false;
+        refined.visible = false;
+    }
+    if (EMAIL_PATTERNS.test(key)) {
+        refined.editWidget = refined.editWidget ?? 'email';
+        refined.filterable = 'search';
+        refined.searchable = true;
+    }
+    if (NAME_PATTERNS.test(key)) {
+        refined.searchable = true;
+        refined.summaryField = true;
+        refined.sortable = 'both';
+    }
+    if (DESCRIPTION_PATTERNS.test(key)) {
+        refined.editWidget = refined.editWidget ?? 'textarea';
+        refined.truncate = refined.truncate ?? 100;
+        refined.tooltip = true;
+        refined.sortable = false;
+    }
+    if (IMAGE_PATTERNS.test(key)) {
+        refined.sortable = false;
+        refined.filterable = false;
+        refined.searchable = false;
+    }
+    if (STATUS_PATTERNS.test(key)) {
+        refined.groupable = true;
+        refined.filterable = 'select';
+    }
+    return refined;
+}
+// ============================================================================
+// Public API: inferFieldAffordances
+// ============================================================================
+/**
+ * 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 function inferFieldAffordances(key, schema) {
+    const baseType = getZodBaseType(schema);
+    // Layer 1: Type-based defaults
+    let affordances = getTypeDefaults(baseType);
+    // Layer 2: Validation-based refinements
+    affordances = refineByValidations(schema, affordances);
+    // Layer 3: Name-based heuristics
+    affordances = refineByFieldName(key, affordances);
+    // Layer 4: Zod .meta() annotations (if any)
+    const meta = getZodMeta(schema);
+    if (meta) {
+        affordances = { ...affordances, ...extractAffordancesFromMeta(meta) };
+    }
+    // Always set the title if not explicitly provided
+    if (!affordances.title) {
+        affordances.title = humanizeFieldName(key);
+    }
+    return affordances;
+}
+/** Extract affordance-relevant fields from Zod metadata. */
+function extractAffordancesFromMeta(meta) {
+    const result = {};
+    // Direct affordance fields
+    const affordanceKeys = [
+        'sortable', 'filterable', 'searchable', 'groupable', 'aggregatable',
+        'readable', 'editable', 'inlineEditable', 'requiredOnCreate', 'requiredOnUpdate',
+        'immutableAfterCreate', 'visible', 'hidden', 'detailOnly', 'summaryField',
+        'columnWidth', 'minWidth', 'maxWidth', 'resizable', 'pinned', 'order',
+        'title', 'description', 'displayFormat', 'badge', 'copyable', 'truncate',
+        'tooltip', 'editWidget', 'editPlaceholder', 'editHelp',
+    ];
+    for (const key of affordanceKeys) {
+        if (key in meta) {
+            result[key] = meta[key];
+        }
+    }
+    // Support nested affordance object from .meta({ affordances: { ... } })
+    if (meta.affordances && typeof meta.affordances === 'object') {
+        Object.assign(result, meta.affordances);
+    }
+    // Map standard Zod meta fields
+    if (meta.title && !result.title)
+        result.title = meta.title;
+    if (meta.description && !result.description)
+        result.description = meta.description;
+    return result;
+}
+/** Convert a camelCase or snake_case field name to a human-readable label. */
+export function humanizeFieldName(key) {
+    return key
+        // Insert space before uppercase letters (camelCase)
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        // Replace underscores and hyphens with spaces
+        .replace(/[_-]+/g, ' ')
+        // Capitalize first letter of each word
+        .replace(/\b\w/g, (c) => c.toUpperCase())
+        .trim();
+}
+//# sourceMappingURL=inference.js.map

package/dist/inference.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AI Prompt Generator: Produce machine-readable descriptions of collections.
+ *
+ * Follows the json-render `generateCatalogPrompt()` pattern:
+ * given a collection definition, produce a structured text that an LLM can
+ * consume to understand what UI components to generate, what operations
+ * are available, and what constraints exist.
+ *
+ * Use cases:
+ * - Feed to an LLM to generate UI specifications
+ * - Feed to an agent to understand available CRUD operations
+ * - Generate API documentation from schema
+ */
+import type { CollectionDefinition } from './collection.js';
+/**
+ * Generate an AI-consumable prompt describing a collection's affordances.
+ *
+ * The prompt is structured for LLM consumption: it clearly separates
+ * data shape, field capabilities, collection operations, and custom actions.
+ *
+ * @example
+ * ```typescript
+ * const prompt = toPrompt(projectCollection);
+ * // Feed to an LLM:
+ * // "Given the following collection definition, generate a React component..."
+ * // + prompt
+ * ```
+ */
+export declare function toPrompt(collection: CollectionDefinition<any>): string;