@frontmcp/ui 0.5.1 → 0.6.0

package/esm/widgets/progress.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Progress and Status Widgets
+ *
+ * Components for displaying progress, loading states, and status information.
+ */
+/**
+ * Progress bar options
+ */
+export interface ProgressBarOptions {
+    /** Progress value (0-100) */
+    value: number;
+    /** Show percentage text */
+    showLabel?: boolean;
+    /** Label position */
+    labelPosition?: 'inside' | 'outside' | 'none';
+    /** Size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Color variant */
+    variant?: 'primary' | 'success' | 'warning' | 'danger' | 'info';
+    /** Animated (striped) */
+    animated?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+    /** Custom label */
+    label?: string;
+}
+/**
+ * Build a progress bar
+ */
+export declare function progressBar(options: ProgressBarOptions): string;
+/**
+ * Step definition
+ */
+export interface Step {
+    /** Step label */
+    label: string;
+    /** Step description */
+    description?: string;
+    /** Step status */
+    status: 'completed' | 'current' | 'upcoming';
+    /** Icon (optional) */
+    icon?: string;
+    /** URL for clickable steps */
+    href?: string;
+}
+/**
+ * Multi-step progress options
+ */
+export interface StepProgressOptions {
+    /** Steps */
+    steps: Step[];
+    /** Orientation */
+    orientation?: 'horizontal' | 'vertical';
+    /** Connector style */
+    connector?: 'line' | 'dashed' | 'none';
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build a multi-step progress indicator
+ */
+export declare function stepProgress(options: StepProgressOptions): string;
+/**
+ * Circular progress options
+ */
+export interface CircularProgressOptions {
+    /** Progress value (0-100) */
+    value: number;
+    /** Size in pixels */
+    size?: number;
+    /** Stroke width */
+    strokeWidth?: number;
+    /** Color variant */
+    variant?: 'primary' | 'success' | 'warning' | 'danger';
+    /** Show percentage */
+    showLabel?: boolean;
+    /** Custom label */
+    label?: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build a circular progress indicator
+ */
+export declare function circularProgress(options: CircularProgressOptions): string;
+/**
+ * Status indicator options
+ */
+export interface StatusIndicatorOptions {
+    /** Status state */
+    status: 'online' | 'offline' | 'busy' | 'away' | 'loading' | 'error' | 'success';
+    /** Status label */
+    label?: string;
+    /** Size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Show pulse animation */
+    pulse?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build a status indicator
+ */
+export declare function statusIndicator(options: StatusIndicatorOptions): string;
+/**
+ * Skeleton loader options
+ */
+export interface SkeletonOptions {
+    /** Skeleton type */
+    type?: 'text' | 'circle' | 'rect' | 'card';
+    /** Width (CSS value) */
+    width?: string;
+    /** Height (CSS value) */
+    height?: string;
+    /** Number of text lines */
+    lines?: number;
+    /** Animated */
+    animated?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build a skeleton loader
+ */
+export declare function skeleton(options?: SkeletonOptions): string;
+/**
+ * Build a content skeleton with avatar and text
+ */
+export declare function contentSkeleton(options?: {
+    animated?: boolean;
+    className?: string;
+}): string;
+//# sourceMappingURL=progress.d.ts.map

package/esm/widgets/progress.d.ts.map

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

package/esm/widgets/resource.d.ts

@@ -0,0 +1,163 @@
+/**
+ * OpenAI App SDK Resource Widgets
+ *
+ * Components for displaying resources in OpenAI's App SDK format.
+ * These widgets are designed to work with OpenAI Canvas and similar interfaces.
+ */
+import { type CardOptions } from '../components/card';
+import { type BadgeVariant } from '../components/badge';
+/**
+ * Resource type identifiers
+ */
+export type ResourceType = 'document' | 'image' | 'code' | 'data' | 'file' | 'link' | 'user' | 'event' | 'message' | 'task' | 'custom';
+/**
+ * Resource metadata
+ */
+export interface ResourceMeta {
+    /** Creation timestamp */
+    createdAt?: string | Date;
+    /** Last modified timestamp */
+    updatedAt?: string | Date;
+    /** Author/creator */
+    author?: string;
+    /** File size (bytes) */
+    size?: number;
+    /** MIME type */
+    mimeType?: string;
+    /** Tags */
+    tags?: string[];
+    /** Custom metadata */
+    [key: string]: unknown;
+}
+/**
+ * Resource action
+ */
+export interface ResourceAction {
+    /** Action label */
+    label: string;
+    /** Action icon */
+    icon?: string;
+    /** Action URL */
+    href?: string;
+    /** HTMX attributes */
+    htmx?: {
+        get?: string;
+        post?: string;
+        delete?: string;
+        target?: string;
+        swap?: string;
+        confirm?: string;
+    };
+    /** Variant */
+    variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
+    /** Disabled */
+    disabled?: boolean;
+}
+/**
+ * Base resource options
+ */
+export interface ResourceOptions {
+    /** Resource type */
+    type: ResourceType;
+    /** Resource title */
+    title: string;
+    /** Resource description */
+    description?: string;
+    /** Resource icon */
+    icon?: string;
+    /** Resource thumbnail URL */
+    thumbnail?: string;
+    /** Resource URL */
+    url?: string;
+    /** Resource metadata */
+    meta?: ResourceMeta;
+    /** Resource status */
+    status?: {
+        label: string;
+        variant: BadgeVariant;
+    };
+    /** Available actions */
+    actions?: ResourceAction[];
+    /** Additional CSS classes */
+    className?: string;
+    /** Card options */
+    cardOptions?: Partial<CardOptions>;
+}
+/**
+ * Build a resource widget
+ */
+export declare function resourceWidget(options: ResourceOptions): string;
+/**
+ * Resource list options
+ */
+export interface ResourceListOptions {
+    /** Resources to display */
+    resources: ResourceOptions[];
+    /** List title */
+    title?: string;
+    /** Empty state message */
+    emptyMessage?: string;
+    /** Grid or list layout */
+    layout?: 'list' | 'grid';
+    /** Grid columns */
+    columns?: 1 | 2 | 3 | 4;
+    /** Additional CSS classes */
+    className?: string;
+    /** Show load more button */
+    showLoadMore?: boolean;
+    /** Load more URL */
+    loadMoreUrl?: string;
+}
+/**
+ * Build a resource list widget
+ */
+export declare function resourceList(options: ResourceListOptions): string;
+/**
+ * Build a compact resource item (for inline display)
+ */
+export declare function resourceItem(options: Omit<ResourceOptions, 'cardOptions'>): string;
+/**
+ * Code preview options
+ */
+export interface CodePreviewOptions {
+    /** Code content */
+    code: string;
+    /** Language */
+    language?: string;
+    /** Filename */
+    filename?: string;
+    /** Show line numbers */
+    lineNumbers?: boolean;
+    /** Max height */
+    maxHeight?: string;
+    /** Copy button */
+    showCopy?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build a code preview widget
+ */
+export declare function codePreview(options: CodePreviewOptions): string;
+/**
+ * Image preview options
+ */
+export interface ImagePreviewOptions {
+    /** Image URL */
+    src: string;
+    /** Alt text */
+    alt: string;
+    /** Caption */
+    caption?: string;
+    /** Max height */
+    maxHeight?: string;
+    /** Clickable (opens in new tab) */
+    clickable?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Build an image preview widget
+ */
+export declare function imagePreview(options: ImagePreviewOptions): string;
+//# sourceMappingURL=resource.d.ts.map

package/esm/widgets/resource.d.ts.map

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

package/handlebars/expression-extractor.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Handlebars Expression Extractor
+ *
+ * Extracts variable paths from Handlebars templates for validation
+ * against schemas.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Type of Handlebars expression.
+ */
+export type ExpressionType = 'variable' | 'helper' | 'block' | 'block-close';
+/**
+ * Extracted expression with metadata.
+ */
+export interface ExtractedExpression {
+    /** The variable path (e.g., "output.temperature") */
+    path: string;
+    /** The full expression (e.g., "{{output.temperature}}") */
+    fullExpression: string;
+    /** Line number in template (1-indexed) */
+    line: number;
+    /** Column position (1-indexed) */
+    column: number;
+    /** Type of expression */
+    type: ExpressionType;
+    /** For helpers, the helper name */
+    helperName?: string;
+}
+/**
+ * Result of expression extraction.
+ */
+export interface ExtractionResult {
+    /** All extracted expressions */
+    expressions: ExtractedExpression[];
+    /** Unique variable paths */
+    paths: string[];
+    /** Paths starting with "output." */
+    outputPaths: string[];
+    /** Paths starting with "input." */
+    inputPaths: string[];
+    /** Paths starting with "structuredContent." */
+    structuredContentPaths: string[];
+}
+/**
+ * Extract all Handlebars expressions from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of extracted expressions with metadata
+ *
+ * @example
+ * ```typescript
+ * const expressions = extractExpressions('<div>{{output.name}}</div>');
+ * // [{ path: 'output.name', fullExpression: '{{output.name}}', ... }]
+ * ```
+ */
+export declare function extractExpressions(template: string): ExtractedExpression[];
+/**
+ * Extract all variable paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique variable paths
+ *
+ * @example
+ * ```typescript
+ * const paths = extractVariablePaths('<div>{{output.a}} {{input.b}}</div>');
+ * // ['output.a', 'input.b']
+ * ```
+ */
+export declare function extractVariablePaths(template: string): string[];
+/**
+ * Extract only output.* paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique output paths
+ *
+ * @example
+ * ```typescript
+ * const paths = extractOutputPaths('<div>{{output.temp}} {{input.city}}</div>');
+ * // ['output.temp']
+ * ```
+ */
+export declare function extractOutputPaths(template: string): string[];
+/**
+ * Extract only input.* paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique input paths
+ */
+export declare function extractInputPaths(template: string): string[];
+/**
+ * Extract only structuredContent.* paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique structuredContent paths
+ */
+export declare function extractStructuredContentPaths(template: string): string[];
+/**
+ * Comprehensive extraction returning all path categories.
+ *
+ * @param template - Handlebars template string
+ * @returns Extraction result with categorized paths
+ *
+ * @example
+ * ```typescript
+ * const result = extractAll('<div>{{output.a}} {{input.b}}</div>');
+ * // {
+ * //   expressions: [...],
+ * //   paths: ['output.a', 'input.b'],
+ * //   outputPaths: ['output.a'],
+ * //   inputPaths: ['input.b'],
+ * //   structuredContentPaths: []
+ * // }
+ * ```
+ */
+export declare function extractAll(template: string): ExtractionResult;
+/**
+ * Check if a template contains any Handlebars expressions with variable paths.
+ *
+ * @param template - Handlebars template string
+ * @returns true if template contains variable paths
+ */
+export declare function hasVariablePaths(template: string): boolean;
+/**
+ * Get expression details at a specific line and column.
+ *
+ * @param template - Handlebars template string
+ * @param line - Line number (1-indexed)
+ * @param column - Column number (1-indexed)
+ * @returns Expression at position or undefined
+ */
+export declare function getExpressionAt(template: string, line: number, column: number): ExtractedExpression | undefined;
+/**
+ * Normalize a path for comparison.
+ * Converts array index access to wildcard format.
+ *
+ * @param path - Variable path
+ * @returns Normalized path
+ *
+ * @example
+ * ```typescript
+ * normalizePath('output.items.0.name'); // 'output.items.[].name'
+ * normalizePath('output.data[0].value'); // 'output.data.[].value'
+ * ```
+ */
+export declare function normalizePath(path: string): string;
+//# sourceMappingURL=expression-extractor.d.ts.map

package/handlebars/expression-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-extractor.d.ts","sourceRoot":"","sources":["../../src/handlebars/expression-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mCAAmC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+CAA+C;IAC/C,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmE1E;AAgDD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAExE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAW7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAS/G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD"}