@pattern-stack/frontend-patterns 0.2.0-alpha.1 → 0.2.0-alpha.4

package/dist/atoms/types/ui-metadata.d.ts

@@ -0,0 +1,103 @@
+/**
+ * UI Metadata Types
+ *
+ * This file contains UI metadata types that mirror the backend OpenAPI specification.
+ * These types enable dynamic UI rendering based on field metadata from the API.
+ *
+ * @mirror backend: pattern_stack/atoms/metadata/schemas.py
+ */
+import type { UIType } from "./ui-config";
+/**
+ * Business importance levels for field prioritization.
+ *
+ * Controls field visibility and display priority in responsive layouts.
+ * Uses semantic naming (primary/secondary/tertiary) with backward compatible
+ * severity levels (critical/high/medium/low/minimal).
+ *
+ * @mirror backend: pattern_stack/atoms/metadata/schemas.py::SemanticImportance
+ *
+ * Semantic levels:
+ * - primary: Most important, always show
+ * - secondary: Supporting information
+ * - tertiary: Optional/metadata field (default)
+ *
+ * Backward compatible severity levels (mapped to semantic):
+ * - critical, high -> equivalent to primary
+ * - medium -> equivalent to secondary
+ * - low, minimal -> equivalent to tertiary
+ */
+export type UIImportance = "primary" | "secondary" | "tertiary" | "critical" | "high" | "medium" | "low" | "minimal";
+/**
+ * Column/field metadata for dynamic UI rendering.
+ *
+ * Provides comprehensive metadata about a data field including its type,
+ * importance, display properties, and validation rules. Used by DataTable,
+ * forms, and other data-driven components to render fields appropriately.
+ *
+ * @mirror backend: pattern_stack/atoms/metadata/schemas.py::ColumnMetadata
+ */
+export interface ColumnMetadata {
+    /** Field name/key in the data object */
+    field: string;
+    /** Human-readable label for display */
+    label: string;
+    /** Semantic UI type for rendering */
+    type: UIType;
+    /** Business importance level for prioritization */
+    importance: UIImportance;
+    /** Logical grouping for field organization */
+    group?: string;
+    /** Whether the field supports sorting */
+    sortable?: boolean;
+    /** Whether the field supports filtering */
+    filterable?: boolean;
+    /** Type-specific formatting options */
+    format?: Record<string, unknown>;
+    /** Help text describing the field */
+    description?: string;
+    /** Placeholder text for input fields */
+    placeholder?: string;
+    /** Whether the field is visible by default */
+    visible?: boolean;
+    /** Whether the field is required in forms */
+    required?: boolean;
+    /** Whether the field is computed/read-only */
+    computed?: boolean;
+}
+/**
+ * API response for column metadata.
+ *
+ * Returned by metadata endpoints to provide UI rendering information
+ * for a specific entity and view type.
+ */
+export interface ColumnMetadataResponse {
+    /** Array of column metadata definitions */
+    columns: ColumnMetadata[];
+    /** Entity type these columns belong to */
+    entity: string;
+    /** View context (list/detail/form) */
+    view: "list" | "detail" | "form";
+    /** Metadata schema version */
+    version: string;
+}
+/**
+ * Field group metadata for form sections.
+ *
+ * Organizes related fields into collapsible sections within forms.
+ * Groups provide visual organization and progressive disclosure of form fields.
+ */
+export interface FieldGroupMetadata {
+    /** Unique group identifier */
+    name: string;
+    /** Human-readable group label */
+    label: string;
+    /** Help text describing the group */
+    description?: string;
+    /** Display order relative to other groups */
+    order?: number;
+    /** Whether the group can be collapsed */
+    collapsible?: boolean;
+    /** Whether the group starts collapsed */
+    collapsed_default?: boolean;
+}
+//# sourceMappingURL=ui-metadata.d.ts.map

package/dist/atoms/types/ui-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-metadata.d.ts","sourceRoot":"","sources":["../../../src/atoms/types/ui-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,MAAM,GACN,QAAQ,GACR,KAAK,GACL,SAAS,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,UAAU,EAAE,YAAY,CAAC;IAEzB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEjC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/atoms/utils/field-detection.d.ts

@@ -3,11 +3,11 @@
  *
  * Automatically detects field types based on name, pattern, and value
  */
-import type { UIFieldType, UIConfig } from "../types/ui-config";
+import type { UIType, UIConfig } from "../types/ui-config";
 /**
  * Get field type for a given field name and optional value
  */
-export declare function getFieldType(fieldName: string, value?: unknown, explicitUI?: UIConfig): UIFieldType;
+export declare function getFieldType(fieldName: string, value?: unknown, explicitUI?: UIConfig): UIType;
 /**
  * Analyze an array of data to build automatic UI configuration
  */

package/dist/atoms/utils/field-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-detection.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/field-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAuNhE;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,EACf,UAAU,CAAC,EAAE,QAAQ,GACpB,WAAW,CA8Bb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAqBb"}
+{"version":3,"file":"field-detection.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/field-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAuN3D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,EACf,UAAU,CAAC,EAAE,QAAQ,GACpB,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GACvB,QAAQ,CAAC,CAAC,CAAC,CAqBb"}

package/dist/atoms/utils/ui-mapping.d.ts

@@ -4,10 +4,15 @@
  * Maps field types to their corresponding UI components
  */
 import React from "react";
-import type { UIFieldType } from "../types/ui-config";
+import type { UIType, FieldFormat } from "../types/ui-config";
 import type { FieldRendererRegistry } from "../types/ui-config";
-export type { FieldRendererRegistry };
+export type { FieldRendererRegistry, FieldFormat };
 import type { Breakpoint } from "../config/responsive";
+/**
+ * Normalize a type string to canonical UIType.
+ * @deprecated Types should match exactly. No normalization needed.
+ */
+export declare function normalizeFieldType(type: string): UIType;
 /**
  * Default field renderers for each UI type
  */
@@ -15,5 +20,6 @@ export declare const defaultFieldRenderers: FieldRendererRegistry;
 /**
  * Render a field value using the appropriate component
  */
-export declare function renderField(value: unknown, fieldName: string, fieldType: UIFieldType, breakpoint: Breakpoint, item?: Record<string, unknown>, customRenderers?: Partial<FieldRendererRegistry>): React.ReactNode;
+export declare function renderField(value: unknown, fieldName: string, fieldType: string, // Accept string, not just UIFieldType
+breakpoint: Breakpoint, item?: Record<string, unknown>, customRenderers?: Partial<FieldRendererRegistry>, format?: FieldFormat): React.ReactNode;
 //# sourceMappingURL=ui-mapping.d.ts.map

package/dist/atoms/utils/ui-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-mapping.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/ui-mapping.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,YAAY,EAAE,qBAAqB,EAAE,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAsFvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBA0LnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,WAAW,EACtB,UAAU,EAAE,UAAU,EACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,eAAe,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAC/C,KAAK,CAAC,SAAS,CAWjB"}
+{"version":3,"file":"ui-mapping.d.ts","sourceRoot":"","sources":["../../../src/atoms/utils/ui-mapping.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQvD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAsJD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAoOnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,sCAAsC;AACzD,UAAU,EAAE,UAAU,EACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,eAAe,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,EAChD,MAAM,CAAC,EAAE,WAAW,GACnB,KAAK,CAAC,SAAS,CAYjB"}

package/dist/features/auth/hooks/useAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../../../src/features/auth/hooks/useAuth.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EAGT,MAAM,sBAAsB,CAAC;AAG9B,UAAU,iBAAiB;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAAE,EAC1D,QAAQ,EACR,MAAM,GACP,EAAE,iBAAiB,2CAqLnB"}
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../../../src/features/auth/hooks/useAuth.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EAGT,MAAM,sBAAsB,CAAC;AAG9B,UAAU,iBAAiB;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAAE,EAC1D,QAAQ,EACR,MAAM,GACP,EAAE,iBAAiB,2CAqLnB"}