analytica-frontend-lib 1.2.45 → 1.2.47

package/dist/hooks/useRecommendedLessons/index.mjs

@@ -0,0 +1,155 @@
+// src/hooks/useRecommendedLessons.ts
+import { useState, useCallback } from "react";
+import { z } from "zod";
+import dayjs from "dayjs";
+var goalSubjectSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string()
+}).nullable();
+var goalCreatorSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string()
+}).nullable();
+var goalStatsSchema = z.object({
+  totalStudents: z.number(),
+  completedCount: z.number(),
+  completionPercentage: z.number()
+});
+var goalBreakdownSchema = z.object({
+  classId: z.string().uuid(),
+  className: z.string(),
+  schoolId: z.string(),
+  schoolName: z.string(),
+  studentCount: z.number(),
+  completedCount: z.number()
+});
+var goalDataSchema = z.object({
+  id: z.string().uuid(),
+  title: z.string(),
+  startDate: z.string().nullable(),
+  finalDate: z.string().nullable(),
+  createdAt: z.string(),
+  progress: z.number(),
+  totalLessons: z.number()
+});
+var goalHistoryItemSchema = z.object({
+  goal: goalDataSchema,
+  subject: goalSubjectSchema,
+  creator: goalCreatorSchema,
+  stats: goalStatsSchema,
+  breakdown: z.array(goalBreakdownSchema)
+});
+var goalsHistoryApiResponseSchema = z.object({
+  message: z.string(),
+  data: z.object({
+    goals: z.array(goalHistoryItemSchema),
+    total: z.number()
+  })
+});
+var determineGoalStatus = (finalDate, completionPercentage) => {
+  if (completionPercentage === 100) {
+    return "CONCLU\xCDDA" /* CONCLUIDA */;
+  }
+  if (finalDate) {
+    const now = dayjs();
+    const deadline = dayjs(finalDate);
+    if (deadline.isBefore(now)) {
+      return "VENCIDA" /* VENCIDA */;
+    }
+  }
+  return "ATIVA" /* ATIVA */;
+};
+var transformGoalToTableItem = (item) => {
+  const firstBreakdown = item.breakdown[0];
+  const schoolName = firstBreakdown?.schoolName || "-";
+  const className = firstBreakdown?.className || "-";
+  const classDisplay = item.breakdown.length > 1 ? `${item.breakdown.length} turmas` : className;
+  return {
+    id: item.goal.id,
+    startDate: item.goal.startDate ? dayjs(item.goal.startDate).format("DD/MM") : "-",
+    deadline: item.goal.finalDate ? dayjs(item.goal.finalDate).format("DD/MM") : "-",
+    title: item.goal.title,
+    school: schoolName,
+    year: "-",
+    // API doesn't provide year directly
+    subject: item.subject?.name || "-",
+    class: classDisplay,
+    status: determineGoalStatus(
+      item.goal.finalDate,
+      item.stats.completionPercentage
+    ),
+    completionPercentage: item.stats.completionPercentage
+  };
+};
+var handleGoalFetchError = (error) => {
+  if (error instanceof z.ZodError) {
+    console.error("Erro ao validar dados de hist\xF3rico de aulas:", error);
+    return "Erro ao validar dados de hist\xF3rico de aulas";
+  }
+  console.error("Erro ao carregar hist\xF3rico de aulas:", error);
+  return "Erro ao carregar hist\xF3rico de aulas";
+};
+var createUseRecommendedLessonsHistory = (fetchGoalsHistory) => {
+  return () => {
+    const [state, setState] = useState({
+      goals: [],
+      loading: false,
+      error: null,
+      pagination: {
+        total: 0,
+        page: 1,
+        limit: 10,
+        totalPages: 0
+      }
+    });
+    const fetchGoals = useCallback(
+      async (filters) => {
+        setState((prev) => ({ ...prev, loading: true, error: null }));
+        try {
+          const responseData = await fetchGoalsHistory(filters);
+          const validatedData = goalsHistoryApiResponseSchema.parse(responseData);
+          const tableItems = validatedData.data.goals.map(
+            transformGoalToTableItem
+          );
+          const page = filters?.page || 1;
+          const limit = filters?.limit || 10;
+          const total = validatedData.data.total;
+          const totalPages = Math.ceil(total / limit);
+          setState({
+            goals: tableItems,
+            loading: false,
+            error: null,
+            pagination: {
+              total,
+              page,
+              limit,
+              totalPages
+            }
+          });
+        } catch (error) {
+          const errorMessage = handleGoalFetchError(error);
+          setState((prev) => ({
+            ...prev,
+            loading: false,
+            error: errorMessage
+          }));
+        }
+      },
+      [fetchGoalsHistory]
+    );
+    return {
+      ...state,
+      fetchGoals
+    };
+  };
+};
+var createRecommendedLessonsHistoryHook = createUseRecommendedLessonsHistory;
+export {
+  createRecommendedLessonsHistoryHook,
+  createUseRecommendedLessonsHistory,
+  determineGoalStatus,
+  goalsHistoryApiResponseSchema,
+  handleGoalFetchError,
+  transformGoalToTableItem
+};
+//# sourceMappingURL=index.mjs.map

package/dist/hooks/useRecommendedLessons/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useRecommendedLessons.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\nimport { z } from 'zod';\nimport dayjs from 'dayjs';\nimport { GoalDisplayStatus } from '../types/recommendedLessons';\nimport type {\n  GoalHistoryItem,\n  GoalTableItem,\n  GoalsHistoryApiResponse,\n  GoalHistoryFilters,\n  GoalHistoryPagination,\n} from '../types/recommendedLessons';\n\n/**\n * Zod schema for goal history API response validation\n * Based on /recommended-class/history endpoint\n */\nconst goalSubjectSchema = z\n  .object({\n    id: z.string().uuid(),\n    name: z.string(),\n  })\n  .nullable();\n\nconst goalCreatorSchema = z\n  .object({\n    id: z.string().uuid(),\n    name: z.string(),\n  })\n  .nullable();\n\nconst goalStatsSchema = z.object({\n  totalStudents: z.number(),\n  completedCount: z.number(),\n  completionPercentage: z.number(),\n});\n\nconst goalBreakdownSchema = z.object({\n  classId: z.string().uuid(),\n  className: z.string(),\n  schoolId: z.string(),\n  schoolName: z.string(),\n  studentCount: z.number(),\n  completedCount: z.number(),\n});\n\nconst goalDataSchema = z.object({\n  id: z.string().uuid(),\n  title: z.string(),\n  startDate: z.string().nullable(),\n  finalDate: z.string().nullable(),\n  createdAt: z.string(),\n  progress: z.number(),\n  totalLessons: z.number(),\n});\n\nconst goalHistoryItemSchema = z.object({\n  goal: goalDataSchema,\n  subject: goalSubjectSchema,\n  creator: goalCreatorSchema,\n  stats: goalStatsSchema,\n  breakdown: z.array(goalBreakdownSchema),\n});\n\nexport const goalsHistoryApiResponseSchema = z.object({\n  message: z.string(),\n  data: z.object({\n    goals: z.array(goalHistoryItemSchema),\n    total: z.number(),\n  }),\n});\n\n/**\n * Hook state interface\n */\nexport interface UseRecommendedLessonsHistoryState {\n  goals: GoalTableItem[];\n  loading: boolean;\n  error: string | null;\n  pagination: GoalHistoryPagination;\n}\n\n/**\n * Hook return type\n */\nexport interface UseRecommendedLessonsHistoryReturn\n  extends UseRecommendedLessonsHistoryState {\n  fetchGoals: (filters?: GoalHistoryFilters) => Promise<void>;\n}\n\n/**\n * Determine status based on dates and completion\n * @param finalDate - Goal final date\n * @param completionPercentage - Completion percentage\n * @returns Display status for UI\n */\nexport const determineGoalStatus = (\n  finalDate: string | null,\n  completionPercentage: number\n): GoalDisplayStatus => {\n  if (completionPercentage === 100) {\n    return GoalDisplayStatus.CONCLUIDA;\n  }\n\n  if (finalDate) {\n    const now = dayjs();\n    const deadline = dayjs(finalDate);\n    if (deadline.isBefore(now)) {\n      return GoalDisplayStatus.VENCIDA;\n    }\n  }\n\n  return GoalDisplayStatus.ATIVA;\n};\n\n/**\n * Transform API response to table item format\n * @param item - Goal history item from API response\n * @returns Formatted goal for table display\n */\nexport const transformGoalToTableItem = (\n  item: GoalHistoryItem\n): GoalTableItem => {\n  // Get first breakdown for school/class info (or aggregate)\n  const firstBreakdown = item.breakdown[0];\n  const schoolName = firstBreakdown?.schoolName || '-';\n  const className = firstBreakdown?.className || '-';\n\n  // If multiple classes, show count\n  const classDisplay =\n    item.breakdown.length > 1 ? `${item.breakdown.length} turmas` : className;\n\n  return {\n    id: item.goal.id,\n    startDate: item.goal.startDate\n      ? dayjs(item.goal.startDate).format('DD/MM')\n      : '-',\n    deadline: item.goal.finalDate\n      ? dayjs(item.goal.finalDate).format('DD/MM')\n      : '-',\n    title: item.goal.title,\n    school: schoolName,\n    year: '-', // API doesn't provide year directly\n    subject: item.subject?.name || '-',\n    class: classDisplay,\n    status: determineGoalStatus(\n      item.goal.finalDate,\n      item.stats.completionPercentage\n    ),\n    completionPercentage: item.stats.completionPercentage,\n  };\n};\n\n/**\n * Handle errors during goal fetch\n * @param error - Error object\n * @returns Error message for UI display\n */\nexport const handleGoalFetchError = (error: unknown): string => {\n  if (error instanceof z.ZodError) {\n    console.error('Erro ao validar dados de histórico de aulas:', error);\n    return 'Erro ao validar dados de histórico de aulas';\n  }\n\n  console.error('Erro ao carregar histórico de aulas:', error);\n  return 'Erro ao carregar histórico de aulas';\n};\n\n/**\n * Factory function to create useRecommendedLessonsHistory hook\n *\n * @param fetchGoalsHistory - Function to fetch goals from API\n * @returns Hook for managing recommended lessons history\n *\n * @example\n * ```tsx\n * // In your app setup\n * const fetchGoalsHistory = async (filters) => {\n *   const response = await api.get('/recommended-class/history', { params: filters });\n *   return response.data;\n * };\n *\n * const useGoalsHistory = createUseRecommendedLessonsHistory(fetchGoalsHistory);\n *\n * // In your component\n * const { goals, loading, error, pagination, fetchGoals } = useGoalsHistory();\n * ```\n */\nexport const createUseRecommendedLessonsHistory = (\n  fetchGoalsHistory: (\n    filters?: GoalHistoryFilters\n  ) => Promise<GoalsHistoryApiResponse>\n) => {\n  return (): UseRecommendedLessonsHistoryReturn => {\n    const [state, setState] = useState<UseRecommendedLessonsHistoryState>({\n      goals: [],\n      loading: false,\n      error: null,\n      pagination: {\n        total: 0,\n        page: 1,\n        limit: 10,\n        totalPages: 0,\n      },\n    });\n\n    /**\n     * Fetch goals history from API\n     * @param filters - Optional filters for pagination, search, sorting, etc.\n     */\n    const fetchGoals = useCallback(\n      async (filters?: GoalHistoryFilters) => {\n        setState((prev) => ({ ...prev, loading: true, error: null }));\n\n        try {\n          // Fetch data from API\n          const responseData = await fetchGoalsHistory(filters);\n\n          // Validate response with Zod\n          const validatedData =\n            goalsHistoryApiResponseSchema.parse(responseData);\n\n          // Transform goals to table format\n          const tableItems = validatedData.data.goals.map(\n            transformGoalToTableItem\n          );\n\n          // Calculate pagination from total\n          const page = filters?.page || 1;\n          const limit = filters?.limit || 10;\n          const total = validatedData.data.total;\n          const totalPages = Math.ceil(total / limit);\n\n          // Update state with validated and transformed data\n          setState({\n            goals: tableItems,\n            loading: false,\n            error: null,\n            pagination: {\n              total,\n              page,\n              limit,\n              totalPages,\n            },\n          });\n        } catch (error) {\n          const errorMessage = handleGoalFetchError(error);\n          setState((prev) => ({\n            ...prev,\n            loading: false,\n            error: errorMessage,\n          }));\n        }\n      },\n      [fetchGoalsHistory]\n    );\n\n    return {\n      ...state,\n      fetchGoals,\n    };\n  };\n};\n\n/**\n * Alias for createUseRecommendedLessonsHistory\n */\nexport const createRecommendedLessonsHistoryHook =\n  createUseRecommendedLessonsHistory;\n"],"mappings":"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","names":[]}

package/dist/hooks/useRecommendedLessons.d.ts

@@ -0,0 +1,355 @@
+import { z } from 'zod';
+import { GoalDisplayStatus } from '../types/recommendedLessons';
+import type { GoalHistoryItem, GoalTableItem, GoalsHistoryApiResponse, GoalHistoryFilters, GoalHistoryPagination } from '../types/recommendedLessons';
+export declare const goalsHistoryApiResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    data: z.ZodObject<{
+        goals: z.ZodArray<z.ZodObject<{
+            goal: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                startDate: z.ZodNullable<z.ZodString>;
+                finalDate: z.ZodNullable<z.ZodString>;
+                createdAt: z.ZodString;
+                progress: z.ZodNumber;
+                totalLessons: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            }, {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            }>;
+            subject: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                name: string;
+            }, {
+                id: string;
+                name: string;
+            }>>;
+            creator: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                name: string;
+            }, {
+                id: string;
+                name: string;
+            }>>;
+            stats: z.ZodObject<{
+                totalStudents: z.ZodNumber;
+                completedCount: z.ZodNumber;
+                completionPercentage: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            }, {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            }>;
+            breakdown: z.ZodArray<z.ZodObject<{
+                classId: z.ZodString;
+                className: z.ZodString;
+                schoolId: z.ZodString;
+                schoolName: z.ZodString;
+                studentCount: z.ZodNumber;
+                completedCount: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }, {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            goal: {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            };
+            subject: {
+                id: string;
+                name: string;
+            } | null;
+            creator: {
+                id: string;
+                name: string;
+            } | null;
+            stats: {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            };
+            breakdown: {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }[];
+        }, {
+            goal: {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            };
+            subject: {
+                id: string;
+                name: string;
+            } | null;
+            creator: {
+                id: string;
+                name: string;
+            } | null;
+            stats: {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            };
+            breakdown: {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }[];
+        }>, "many">;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        total: number;
+        goals: {
+            goal: {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            };
+            subject: {
+                id: string;
+                name: string;
+            } | null;
+            creator: {
+                id: string;
+                name: string;
+            } | null;
+            stats: {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            };
+            breakdown: {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }[];
+        }[];
+    }, {
+        total: number;
+        goals: {
+            goal: {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            };
+            subject: {
+                id: string;
+                name: string;
+            } | null;
+            creator: {
+                id: string;
+                name: string;
+            } | null;
+            stats: {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            };
+            breakdown: {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }[];
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        total: number;
+        goals: {
+            goal: {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            };
+            subject: {
+                id: string;
+                name: string;
+            } | null;
+            creator: {
+                id: string;
+                name: string;
+            } | null;
+            stats: {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            };
+            breakdown: {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }[];
+        }[];
+    };
+    message: string;
+}, {
+    data: {
+        total: number;
+        goals: {
+            goal: {
+                id: string;
+                title: string;
+                progress: number;
+                createdAt: string;
+                startDate: string | null;
+                finalDate: string | null;
+                totalLessons: number;
+            };
+            subject: {
+                id: string;
+                name: string;
+            } | null;
+            creator: {
+                id: string;
+                name: string;
+            } | null;
+            stats: {
+                completionPercentage: number;
+                totalStudents: number;
+                completedCount: number;
+            };
+            breakdown: {
+                className: string;
+                schoolName: string;
+                schoolId: string;
+                classId: string;
+                completedCount: number;
+                studentCount: number;
+            }[];
+        }[];
+    };
+    message: string;
+}>;
+/**
+ * Hook state interface
+ */
+export interface UseRecommendedLessonsHistoryState {
+    goals: GoalTableItem[];
+    loading: boolean;
+    error: string | null;
+    pagination: GoalHistoryPagination;
+}
+/**
+ * Hook return type
+ */
+export interface UseRecommendedLessonsHistoryReturn extends UseRecommendedLessonsHistoryState {
+    fetchGoals: (filters?: GoalHistoryFilters) => Promise<void>;
+}
+/**
+ * Determine status based on dates and completion
+ * @param finalDate - Goal final date
+ * @param completionPercentage - Completion percentage
+ * @returns Display status for UI
+ */
+export declare const determineGoalStatus: (finalDate: string | null, completionPercentage: number) => GoalDisplayStatus;
+/**
+ * Transform API response to table item format
+ * @param item - Goal history item from API response
+ * @returns Formatted goal for table display
+ */
+export declare const transformGoalToTableItem: (item: GoalHistoryItem) => GoalTableItem;
+/**
+ * Handle errors during goal fetch
+ * @param error - Error object
+ * @returns Error message for UI display
+ */
+export declare const handleGoalFetchError: (error: unknown) => string;
+/**
+ * Factory function to create useRecommendedLessonsHistory hook
+ *
+ * @param fetchGoalsHistory - Function to fetch goals from API
+ * @returns Hook for managing recommended lessons history
+ *
+ * @example
+ * ```tsx
+ * // In your app setup
+ * const fetchGoalsHistory = async (filters) => {
+ *   const response = await api.get('/recommended-class/history', { params: filters });
+ *   return response.data;
+ * };
+ *
+ * const useGoalsHistory = createUseRecommendedLessonsHistory(fetchGoalsHistory);
+ *
+ * // In your component
+ * const { goals, loading, error, pagination, fetchGoals } = useGoalsHistory();
+ * ```
+ */
+export declare const createUseRecommendedLessonsHistory: (fetchGoalsHistory: (filters?: GoalHistoryFilters) => Promise<GoalsHistoryApiResponse>) => () => UseRecommendedLessonsHistoryReturn;
+/**
+ * Alias for createUseRecommendedLessonsHistory
+ */
+export declare const createRecommendedLessonsHistoryHook: (fetchGoalsHistory: (filters?: GoalHistoryFilters) => Promise<GoalsHistoryApiResponse>) => () => UseRecommendedLessonsHistoryReturn;
+//# sourceMappingURL=useRecommendedLessons.d.ts.map

package/dist/hooks/useRecommendedLessons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecommendedLessons.d.ts","sourceRoot":"","sources":["../../src/hooks/useRecommendedLessons.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAqDrC,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMxC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kCACf,SAAQ,iCAAiC;IACzC,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,MAAM,GAAG,IAAI,EACxB,sBAAsB,MAAM,KAC3B,iBAcF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,eAAe,KACpB,aA6BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,MAQrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kCAAkC,GAC7C,mBAAmB,CACjB,OAAO,CAAC,EAAE,kBAAkB,KACzB,OAAO,CAAC,uBAAuB,CAAC,WAE1B,kCAqEZ,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC,sBA9E3B,CACjB,OAAO,CAAC,EAAE,kBAAkB,KACzB,OAAO,CAAC,uBAAuB,CAAC,WAE1B,kCA2EuB,CAAC"}

package/dist/index.css

@@ -604,6 +604,9 @@
   .isolate {
     isolation: isolate;
   }
+  .z-0 {
+    z-index: 0;
+  }
   .z-10 {
     z-index: 10;
   }
@@ -1329,6 +1332,9 @@
   .max-w-\[1150px\] {
     max-width: 1150px;
   }
+  .max-w-\[1350px\] {
+    max-width: 1350px;
+  }
   .max-w-full {
     max-width: 100%;
   }
@@ -1705,6 +1711,9 @@
       margin-inline-end: calc(calc(var(--spacing) * 6) * calc(1 - var(--tw-space-x-reverse)));
     }
   }
+  .self-center {
+    align-self: center;
+  }
   .self-start {
     align-self: flex-start;
   }
@@ -16575,6 +16584,11 @@
       width: calc(var(--spacing) * 3.5);
     }
   }
+  .lg\:w-auto {
+    @media (width >= 64rem) {
+      width: auto;
+    }
+  }
   .lg\:max-w-\[1000px\] {
     @media (width >= 64rem) {
       max-width: 1000px;
@@ -18672,6 +18686,12 @@
       padding-left: calc(var(--spacing) * 96);
     }
   }
+  .lg\:text-2xl {
+    @media (width >= 64rem) {
+      font-size: var(--text-2xl);
+      line-height: var(--tw-leading, var(--text-2xl--line-height));
+    }
+  }
   .xl\:max-w-none {
     @media (width >= 80rem) {
       max-width: none;