@frontmcp/ui 0.5.0 → 0.6.0

package/src/components/table.schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"table.schema.js","sourceRoot":"","sources":["../../../src/components/table.schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file table.schema.ts\n * @description Zod schemas for Table and Pagination component options validation.\n *\n * Provides strict validation schemas for table options including columns,\n * sorting, selection, and pagination with HTMX support.\n *\n * @example\n * ```typescript\n * import { TableColumnSchema, TableOptionsSchema } from '@frontmcp/ui';\n *\n * const columnResult = TableColumnSchema.safeParse({\n *   key: 'name',\n *   header: 'Name',\n *   sortable: true,\n * });\n * ```\n *\n * @module @frontmcp/ui/components/table.schema\n */\n\nimport { z } from 'zod';\n\n// ============================================\n// Column Schema\n// ============================================\n\n/**\n * Table column alignment schema\n */\nexport const TableAlignSchema = z.enum(['left', 'center', 'right']);\n\n/**\n * Table column sort direction schema\n */\nexport const TableSortDirectionSchema = z.enum(['asc', 'desc']).nullable();\n\n/**\n * Table column definition schema\n * Note: render function cannot be validated by Zod, so we use z.any() for it\n */\nexport const TableColumnSchema = z\n  .object({\n    /** Column key (property name) */\n    key: z.string(),\n    /** Column header text */\n    header: z.string(),\n    /** Column width (CSS value) */\n    width: z.string().optional(),\n    /** Text alignment */\n    align: TableAlignSchema.optional(),\n    /** Sortable column */\n    sortable: z.boolean().optional(),\n    /** Current sort direction */\n    sortDirection: TableSortDirectionSchema.optional(),\n    /** Custom cell renderer (function - cannot validate at runtime) */\n    render: z.any().optional(),\n    /** Additional header CSS classes */\n    headerClass: z.string().optional(),\n    /** Additional cell CSS classes */\n    cellClass: z.string().optional(),\n  })\n  .strict();\n\n/**\n * Table column type\n */\nexport type TableColumn = z.infer<typeof TableColumnSchema>;\n\n// ============================================\n// HTMX Schemas\n// ============================================\n\n/**\n * Sort HTMX options schema\n */\nexport const TableSortHtmxSchema = z\n  .object({\n    get: z.string(),\n    target: z.string().optional(),\n    swap: z.string().optional(),\n  })\n  .strict()\n  .optional();\n\n/**\n * Select HTMX options schema\n */\nexport const TableSelectHtmxSchema = z\n  .object({\n    post: z.string(),\n    target: z.string().optional(),\n  })\n  .strict()\n  .optional();\n\n// ============================================\n// Table Options Schema\n// ============================================\n\n/**\n * Complete table options schema\n */\nexport const TableOptionsSchema = z\n  .object({\n    /** Column definitions */\n    columns: z.array(TableColumnSchema),\n    /** Table ID */\n    id: z.string().optional(),\n    /** Show row selection checkboxes */\n    selectable: z.boolean().optional(),\n    /** Row hover effect */\n    hoverable: z.boolean().optional(),\n    /** Striped rows */\n    striped: z.boolean().optional(),\n    /** Bordered cells */\n    bordered: z.boolean().optional(),\n    /** Compact size */\n    compact: z.boolean().optional(),\n    /** Fixed header (sticky) */\n    stickyHeader: z.boolean().optional(),\n    /** Additional CSS classes */\n    className: z.string().optional(),\n    /** Empty state message */\n    emptyMessage: z.string().optional(),\n    /** Empty state HTML */\n    emptyContent: z.string().optional(),\n    /** Loading state */\n    loading: z.boolean().optional(),\n    /** HTMX for sorting */\n    sortHtmx: TableSortHtmxSchema,\n    /** HTMX for selection */\n    selectHtmx: TableSelectHtmxSchema,\n    /** Row key property for selection */\n    rowKey: z.string().optional(),\n    /** Row click handler (URL template with {key}) */\n    onRowClick: z.string().optional(),\n  })\n  .strict();\n\n/**\n * Table options type (derived from schema)\n */\nexport type TableOptions = z.infer<typeof TableOptionsSchema>;\n\n// ============================================\n// Pagination Schema\n// ============================================\n\n/**\n * Pagination HTMX options schema\n */\nexport const PaginationHtmxSchema = z\n  .object({\n    get: z.string(),\n    target: z.string().optional(),\n    swap: z.string().optional(),\n  })\n  .strict()\n  .optional();\n\n/**\n * Pagination options schema\n */\nexport const PaginationOptionsSchema = z\n  .object({\n    /** Current page (1-indexed) */\n    page: z.number().min(1),\n    /** Total pages */\n    totalPages: z.number().min(0),\n    /** Total items count */\n    totalItems: z.number().min(0).optional(),\n    /** Items per page */\n    pageSize: z.number().min(1).optional(),\n    /** Page size options */\n    pageSizeOptions: z.array(z.number()).optional(),\n    /** Show first/last buttons */\n    showFirstLast: z.boolean().optional(),\n    /** Show page count */\n    showPageCount: z.boolean().optional(),\n    /** Show item count */\n    showItemCount: z.boolean().optional(),\n    /** Show page size selector */\n    showPageSize: z.boolean().optional(),\n    /** Max visible page buttons */\n    maxVisiblePages: z.number().min(1).optional(),\n    /** Additional CSS classes */\n    className: z.string().optional(),\n    /** HTMX for page navigation */\n    htmx: PaginationHtmxSchema,\n  })\n  .strict();\n\n/**\n * Pagination options type\n */\nexport type PaginationOptions = z.infer<typeof PaginationOptionsSchema>;\n"]}

package/src/handlebars/helpers.d.ts

@@ -1,348 +0,0 @@
-/**
- * Handlebars Built-in Helpers
- *
- * Provides a collection of helper functions for Handlebars templates.
- * Includes formatting, escaping, conditionals, and iteration helpers.
- *
- * @packageDocumentation
- */
-/**
- * Helper function type for Handlebars.
- * Allows any function signature since Handlebars helpers vary widely.
- */
-export type HelperFunction = (...args: any[]) => string | boolean | unknown;
-/**
- * Escape HTML special characters to prevent XSS.
- *
- * @param str - String to escape
- * @returns Escaped string safe for HTML output
- *
- * @example
- * ```handlebars
- * {{escapeHtml output.userInput}}
- * ```
- */
-export declare function escapeHtml(str: unknown): string;
-/**
- * Format a date for display.
- *
- * @param date - Date object, ISO string, or timestamp
- * @param format - Optional format string (default: localized date)
- * @returns Formatted date string
- *
- * @example
- * ```handlebars
- * {{formatDate output.createdAt}}
- * {{formatDate output.createdAt "short"}}
- * {{formatDate output.createdAt "long"}}
- * ```
- */
-export declare function formatDate(date: unknown, format?: string): string;
-/**
- * Format a number as currency.
- *
- * @param amount - Numeric amount
- * @param currency - ISO 4217 currency code (default: 'USD')
- * @returns Formatted currency string
- *
- * @example
- * ```handlebars
- * {{formatCurrency output.price}}
- * {{formatCurrency output.price "EUR"}}
- * ```
- */
-export declare function formatCurrency(amount: unknown, currency?: string): string;
-/**
- * Format a number with locale-aware separators.
- *
- * @param value - Number to format
- * @param decimals - Number of decimal places (optional)
- * @returns Formatted number string
- *
- * @example
- * ```handlebars
- * {{formatNumber output.count}}
- * {{formatNumber output.percentage 2}}
- * ```
- */
-export declare function formatNumber(value: unknown, decimals?: number): string;
-/**
- * Safely embed JSON data in HTML.
- * Escapes script-breaking characters.
- *
- * @param data - Data to serialize
- * @returns JSON string safe for embedding
- *
- * @example
- * ```handlebars
- * <script type="application/json" id="data">
- *   {{{jsonEmbed output}}}
- * </script>
- * ```
- */
-export declare function jsonEmbed(data: unknown): string;
-/**
- * Convert data to JSON string.
- *
- * @param data - Data to serialize
- * @param pretty - Whether to pretty-print (optional)
- * @returns JSON string
- *
- * @example
- * ```handlebars
- * <pre>{{json output true}}</pre>
- * ```
- */
-export declare function json(data: unknown, pretty?: boolean): string;
-/**
- * Equality comparison.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if values are equal
- *
- * @example
- * ```handlebars
- * {{#if (eq output.status "active")}}Active{{/if}}
- * ```
- */
-export declare function eq(a: unknown, b: unknown): boolean;
-/**
- * Inequality comparison.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if values are not equal
- *
- * @example
- * ```handlebars
- * {{#if (ne output.status "deleted")}}Visible{{/if}}
- * ```
- */
-export declare function ne(a: unknown, b: unknown): boolean;
-/**
- * Greater than comparison.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if a > b
- *
- * @example
- * ```handlebars
- * {{#if (gt output.count 10)}}Many items{{/if}}
- * ```
- */
-export declare function gt(a: unknown, b: unknown): boolean;
-/**
- * Greater than or equal comparison.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if a >= b
- */
-export declare function gte(a: unknown, b: unknown): boolean;
-/**
- * Less than comparison.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if a < b
- *
- * @example
- * ```handlebars
- * {{#if (lt output.remaining 5)}}Running low{{/if}}
- * ```
- */
-export declare function lt(a: unknown, b: unknown): boolean;
-/**
- * Less than or equal comparison.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if a <= b
- */
-export declare function lte(a: unknown, b: unknown): boolean;
-/**
- * Logical AND.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if both values are truthy
- *
- * @example
- * ```handlebars
- * {{#if (and output.enabled output.visible)}}Show content{{/if}}
- * ```
- */
-export declare function and(a: unknown, b: unknown): boolean;
-/**
- * Logical OR.
- *
- * @param a - First value
- * @param b - Second value
- * @returns true if either value is truthy
- *
- * @example
- * ```handlebars
- * {{#if (or output.featured output.promoted)}}Highlight{{/if}}
- * ```
- */
-export declare function or(a: unknown, b: unknown): boolean;
-/**
- * Logical NOT.
- *
- * @param value - Value to negate
- * @returns Negated boolean
- *
- * @example
- * ```handlebars
- * {{#if (not output.hidden)}}Visible{{/if}}
- * ```
- */
-export declare function not(value: unknown): boolean;
-/**
- * Get the first element of an array.
- *
- * @param arr - Array
- * @returns First element
- *
- * @example
- * ```handlebars
- * {{first output.items}}
- * ```
- */
-export declare function first<T>(arr: T[]): T | undefined;
-/**
- * Get the last element of an array.
- *
- * @param arr - Array
- * @returns Last element
- *
- * @example
- * ```handlebars
- * {{last output.items}}
- * ```
- */
-export declare function last<T>(arr: T[]): T | undefined;
-/**
- * Get the length of an array or string.
- *
- * @param value - Array or string
- * @returns Length
- *
- * @example
- * ```handlebars
- * {{length output.items}} items
- * ```
- */
-export declare function length(value: unknown): number;
-/**
- * Check if a value is in an array.
- *
- * @param arr - Array to search
- * @param value - Value to find
- * @returns true if value is in array
- *
- * @example
- * ```handlebars
- * {{#if (includes output.tags "featured")}}Featured{{/if}}
- * ```
- */
-export declare function includes(arr: unknown, value: unknown): boolean;
-/**
- * Join array elements with a separator.
- *
- * @param arr - Array to join
- * @param separator - Separator string (default: ', ')
- * @returns Joined string
- *
- * @example
- * ```handlebars
- * {{join output.tags ", "}}
- * ```
- */
-export declare function join(arr: unknown, separator?: string): string;
-/**
- * Convert to uppercase.
- *
- * @param str - String to convert
- * @returns Uppercase string
- *
- * @example
- * ```handlebars
- * {{uppercase output.status}}
- * ```
- */
-export declare function uppercase(str: unknown): string;
-/**
- * Convert to lowercase.
- *
- * @param str - String to convert
- * @returns Lowercase string
- *
- * @example
- * ```handlebars
- * {{lowercase output.name}}
- * ```
- */
-export declare function lowercase(str: unknown): string;
-/**
- * Capitalize the first letter.
- *
- * @param str - String to capitalize
- * @returns Capitalized string
- *
- * @example
- * ```handlebars
- * {{capitalize output.name}}
- * ```
- */
-export declare function capitalize(str: unknown): string;
-/**
- * Truncate a string to a maximum length.
- *
- * @param str - String to truncate
- * @param maxLength - Maximum length
- * @param suffix - Suffix to add if truncated (default: '...')
- * @returns Truncated string
- *
- * @example
- * ```handlebars
- * {{truncate output.description 100}}
- * ```
- */
-export declare function truncate(str: unknown, maxLength?: number, suffix?: string): string;
-/**
- * Provide a default value if the input is falsy.
- *
- * @param value - Value to check
- * @param defaultValue - Default value if falsy
- * @returns Value or default
- *
- * @example
- * ```handlebars
- * {{default output.name "Unknown"}}
- * ```
- */
-export declare function defaultValue(value: unknown, defaultValue: unknown): unknown;
-export declare function uniqueId(prefix?: string): string;
-/**
- * Reset the unique ID counter (for testing).
- */
-export declare function resetUniqueIdCounter(): void;
-/**
- * Conditionally join class names.
- *
- * @param classes - Class names (falsy values are filtered)
- * @returns Space-separated class string
- *
- * @example
- * ```handlebars
- * <div class="{{classNames 'base' (if active 'active') (if disabled 'disabled')}}">
- * ```
- */
-export declare function classNames(...classes: unknown[]): string;
-/**
- * Collection of all built-in helpers.
- */
-export declare const builtinHelpers: Record<string, HelperFunction>;