analytica-frontend-lib 1.2.60 → 1.2.61

package/dist/utils/filterHelpers.d.ts

@@ -0,0 +1,105 @@
+import type { ActivityFilterOption } from '../types/activitiesHistory';
+/**
+ * Generic user institution data structure
+ * Matches the structure from GET /user/me endpoint
+ */
+export interface UserInstitutionData {
+    school?: {
+        id: string;
+        name: string;
+    };
+    schoolYear?: {
+        id: string;
+        name: string;
+    };
+    class?: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Generic subject teacher topic class structure
+ */
+export interface SubTeacherTopicClassData {
+    subject?: {
+        id: string;
+        name: string;
+    };
+    class?: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Generic user data structure for filter extraction
+ * Can be extended by consuming projects
+ */
+export interface UserFilterSourceData {
+    userInstitutions?: UserInstitutionData[];
+    subTeacherTopicClasses?: SubTeacherTopicClassData[];
+}
+/**
+ * Extract unique school options from user data
+ * Uses Map for deduplication to handle multiple institutions with same school
+ *
+ * @param userData - User data from /user/me endpoint
+ * @returns Array of unique schools sorted by name
+ *
+ * @example
+ * ```typescript
+ * const userData = useUserStore(state => state.data);
+ * const schools = getSchoolOptionsFromUserData(userData);
+ * // Returns: [{ id: '1', name: 'Escola A' }, { id: '2', name: 'Escola B' }]
+ * ```
+ */
+export declare const getSchoolOptionsFromUserData: (userData: UserFilterSourceData | null | undefined) => ActivityFilterOption[];
+/**
+ * Extract unique subject options from user data
+ * Uses Map for deduplication
+ *
+ * @param userData - User data from /user/me endpoint
+ * @returns Array of unique subjects sorted by name
+ *
+ * @example
+ * ```typescript
+ * const userData = useUserStore(state => state.data);
+ * const subjects = getSubjectOptionsFromUserData(userData);
+ * // Returns: [{ id: '1', name: 'Matemática' }, { id: '2', name: 'Português' }]
+ * ```
+ */
+export declare const getSubjectOptionsFromUserData: (userData: UserFilterSourceData | null | undefined) => ActivityFilterOption[];
+/**
+ * Extract unique school year (série) options from user data
+ *
+ * @param userData - User data from /user/me endpoint
+ * @returns Array of unique school years sorted by name
+ */
+export declare const getSchoolYearOptionsFromUserData: (userData: UserFilterSourceData | null | undefined) => ActivityFilterOption[];
+/**
+ * Extract unique class (turma) options from user data
+ * Combines classes from userInstitutions and subTeacherTopicClasses
+ *
+ * @param userData - User data from /user/me endpoint
+ * @returns Array of unique classes sorted by name
+ */
+export declare const getClassOptionsFromUserData: (userData: UserFilterSourceData | null | undefined) => ActivityFilterOption[];
+/**
+ * Build user filter data object from user data
+ * Convenience function to create ActivityUserFilterData
+ *
+ * @param userData - User data from /user/me endpoint
+ * @returns Object with schools and subjects arrays
+ *
+ * @example
+ * ```typescript
+ * const userData = useUserStore(state => state.data);
+ * const userFilterData = buildUserFilterData(userData);
+ * // Use with ActivitiesHistory component:
+ * <ActivitiesHistory userFilterData={userFilterData} ... />
+ * ```
+ */
+export declare const buildUserFilterData: (userData: UserFilterSourceData | null | undefined) => {
+    schools: ActivityFilterOption[];
+    subjects: ActivityFilterOption[];
+};
+//# sourceMappingURL=filterHelpers.d.ts.map

package/dist/utils/filterHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/filterHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,sBAAsB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACrD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAChD,oBAAoB,EAmBtB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,6BAA6B,GACxC,UAAU,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAChD,oBAAoB,EAmBtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC3C,UAAU,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAChD,oBAAoB,EAmBtB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAU,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAChD,oBAAoB,EAgCtB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAChD;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;CAGpE,CAAC"}

package/dist/utils/subjectMappers.d.ts

@@ -0,0 +1,29 @@
+import { SubjectEnum } from '../enums/SubjectEnum';
+/**
+ * Maps backend subject names to SubjectEnum values
+ * @param subjectName - The subject name from the backend
+ * @returns The corresponding SubjectEnum value or null if no mapping exists
+ *
+ * @example
+ * ```typescript
+ * const subjectEnum = mapSubjectNameToEnum('Matemática');
+ * // Returns: SubjectEnum.MATEMATICA
+ *
+ * const unknown = mapSubjectNameToEnum('Unknown Subject');
+ * // Returns: null
+ * ```
+ */
+export declare const mapSubjectNameToEnum: (subjectName: string) => SubjectEnum | null;
+/**
+ * Maps SubjectEnum values back to display names
+ * @param subjectEnum - The SubjectEnum value
+ * @returns The display name for the subject
+ *
+ * @example
+ * ```typescript
+ * const name = mapSubjectEnumToName(SubjectEnum.MATEMATICA);
+ * // Returns: 'Matemática'
+ * ```
+ */
+export declare const mapSubjectEnumToName: (subjectEnum: SubjectEnum) => string;
+//# sourceMappingURL=subjectMappers.d.ts.map

package/dist/utils/subjectMappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subjectMappers.d.ts","sourceRoot":"","sources":["../../src/utils/subjectMappers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA2BnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,KAClB,WAAW,GAAG,IAGhB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,aAAa,WAAW,KAAG,MAqB/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "analytica-frontend-lib",
-  "version": "1.2.60",
+  "version": "1.2.61",
   "description": "Repositório público dos componentes utilizados nas plataformas da Analytica Ensino",
   "main": "dist/index.cjs",
   "module": "./dist/index.js",